Card Buttons
Main Fields
Field Name | Description | Required? | Length Limit |
cmd | This should always be set to '_cart_add'. | Yes | N/A |
reset | This tells the server to delete any cached button data for the user. Set the value to 1 | Yes | 1 |
merchant | Your merchant ID (you can find this on the My Account page). | Yes | N/A |
Item/Payment Description Fields
Field Name | Description | Required? | Length Limit |
currency | The currency of the payment (BTC, ETH, BCH, USDT, USDC & EURST). Values supported: Any crypto or fiat currency on the Supported Coins page. Note we in no way process any fiat currencies, they are simply convenience values so you don't have to convert to BTC or another coin yourself. | Yes | 5 |
amount | The amount (in the currency chosen) of the payment. | Yes | N/A |
item_name | The name of the item being purchased. | Yes | 128 |
item_desc | Description of the item being purchased. | No | 128 |
item_number | This is a passthru variable for your own use. [not visible to buyer] | No | 128 |
invoice | This is a passthru variable for your own use. [not visible to buyer] | No | 128 |
allow_quantity | 0 = Don't allow buyer to adjust quantity (default). 1 = Allow buyer to adjust quantity. | No | 1 |
Shipping Fields
Field Name | Description | Required? | Length Limit |
want_shipping | 1 = Want buyer's shipping information.0 = Don't want buyer's shipping information. (default) | No | 1 |
shippingf | Cost of shipping the item. Shipping cost is shippingf*quantity (unless shipping2 is set) | No | N/A |
shipping2f | Cost of shipping each additional item. Shipping cost is shippingf+((quantity-1)*shipping2f) | No | N/A |
Miscellaneous Fields
Field Name | Description | Required? | Length Limit |
ipn_url | Sets an IPN URL.If not set or blank defaults to the IPN URL in your settings. | No | 255 |
success_url | Sets a URL to go to if the buyer does complete checkout. | No | 255 |
cancel_url | Sets a URL to go to if the buyer decides to not complete checkout. | No | 255 |
lang | Automatically set the checkout language to this language code. For a list of supported codes check this page. | No | 16 |
Buyer Information. These fields can be used to pre-populate forms with any information you already know about your buyer.
Field Name | Description | Required? | Length Limit |
first_name | Buyer's first name. | No | 32 |
last_name | Buyer's last name. | No | 32 |
Buyer's email address. | No | 128 | |
address1 | Street / address line 1 | No | 128 |
city | City | No | 64 |
phone | Phone Number | No | 32 |
Donation Button Maker
Item | Value | Required? |
Merchant ID * | You can find this on your My Account page. If you were logged in it would fill this in automatically. | Yes |
Item Name * |
| Yes |
Item Amount * | Select from the menu. | Yes |
Item Description |
| No |
Item Number [not visible to buyer] |
| No |
Invoice [not visible to buyer] |
| No |
Tax Amount |
| No |
Don't Collect Shipping Address |
| No |
Shipping Cost |
| No |
Success URL * | Buyer will be prompted to continue to this URL after successful payment. | Yes |
Cancel URL * | Buyer will be given this URL to return to your store instead of checking out. | Yes |
IPN URL | Leave blank to use your account default. | No |
Generate
Minimal Button
<form action="https://wallexpay.io/makepayment" method="post">
<input type="hidden" name="cmd" value="_cart_add">
<input type="hidden" name="merchant" value="5055d032ee33b824ee425ccd4f894dbc">
<input type="hidden" name="cart_name" value="Test Cart">
<input type="hidden" name="currency" value="ETH">
<input type="hidden" name="amount" value="10.00000000">
<input type="hidden" name="item_number" value="TEST-1">
<input type="hidden" name="item_name" value="Test Item">
<input type="hidden" name="want_shipping" value="0">
<input type="image" style="width: 100%; max-width: 200px;" src="http://wallexpay.io/img/add-to-cart.svg" alt="Add to Cart...">
</form>
Button with Shipping and Item Quantities
<form action="https://wallexpay.io/makepayment" method="post">
<input type="hidden" name="cmd" value="_cart_add">
<input type="hidden" name="merchant" value="5055d032ee33b824ee425ccd4f894dbc">
<input type="hidden" name="cart_name" value="Test Cart">
<input type="hidden" name="currency" value="ETH">
<input type="hidden" name="amount" value="10.00000000">
<input type="hidden" name="allow_quantity" value="1">
<input type="hidden" name="shippingf" value="1.00">
<input type="hidden" name="shipping2f" value="0.50">
<input type="hidden" name="item_number" value="TEST-2">
<input type="hidden" name="item_name" value="Test Item">
<input type="hidden" name="want_shipping" value="1">
<input type="image" style="width: 100%; max-width: 200px;" src="http://wallexpay.io/img/add-to-cart.svg" alt="Add to Cart...">
</form>
White Button with Note from Buyer, Success/Return to Store URLs, and No Shipping Info
<form action="https://wallexpay.io/makepayment" method="post">
<input type="hidden" name="cmd" value="_cart_add">
<input type="hidden" name="merchant" value="5055d032ee33b824ee425ccd4f894dbc">
<input type="hidden" name="cart_name" value="Test Cart">
<input type="hidden" name="want_shipping" value="0">
<input type="hidden" name="currency" value="ETH">
<input type="hidden" name="amount" value="10.00000000">
<input type="hidden" name="allow_quantity" value="1">
<input type="hidden" name="shippingf" value="1.00">
<input type="hidden" name="shipping2f" value="0.50">
<input type="hidden" name="item_number" value="TEST-3">
<input type="hidden" name="item_name" value="Test Item">
<input type="hidden" name="success_url" value="https://....">
<input type="hidden" name="cancel_url" value="https://....">
<input type="hidden" name="return_url" value="https://....">
<input type="image" style="width: 100%; max-width: 200px;" src="http://wallexpay.io/img/add-to-cart.svg" alt="Add to Cart...">
</form>
Note: The system will only let you have 3 transactions at a time in the 'Waiting for funds...' state (as a buyer, no limit for sellers).