Payment Buttons

Our variety of payment buttons can be implemented quickly and seamlessly to provide crypto payment functionality on your site.

Payment Buttons

Simple Button Maker

Simple 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

Advance Button Maker

Advance 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

Example Buttons

Minimal Button

<form action="https://wallexpay.io/makepayment" method="post">
    <input type="hidden" name="cmd" value="_pay_simple">
    <input type="hidden" name="reset" value="1">
    <input type="hidden" name="merchant" value="xxxxxxxxxxxx">
    <input type="hidden" name="item_name" value="Item Name">
    <input type="hidden" name="item_desc" value=" ">
    <input type="hidden" name="item_number" value="678">
    <input type="hidden" name="invoice" value="4688">
    <input type="hidden" name="currency" value="USD">
    <input type="hidden" name="amountf" value="10">
    <input type="hidden" name="want_shipping" value="0">
    <input type="hidden" name="success_url" value="https://.....">
    <input type="hidden" name="cancel_url" value="https://.....">
    <input type="hidden" name="ipn_url" value="https://.....">
    <input type="image" src="https://wallexpay.io/img/paymentlogo.svg" alt="Donate with Wallexpay">
</form>

---

Button with Item Description

<form action="https://wallexpay.io/makepayment" method="post">
    <input type="hidden" name="cmd" value="_pay_simple">
    <input type="hidden" name="reset" value="1">
    <input type="hidden" name="merchant" value="xxxxxxxxxxxx">
    <input type="hidden" name="item_name" value="Item Name">
    <input type="hidden" name="item_desc" value=" ">
    <input type="hidden" name="item_number" value="678">
    <input type="hidden" name="invoice" value="4688">
    <input type="hidden" name="currency" value="USD">
    <input type="hidden" name="amountf" value="10.00000000">
    <input type="hidden" name="want_shipping" value="0">
    <input type="hidden" name="success_url" value="https://.....">
    <input type="hidden" name="cancel_url" value="https://.....">
    <input type="hidden" name="ipn_url" value="https://.....">
    <input type="image" src="https://wallexpay.io/img/paymentlogo.svg" alt="Donate with Wallexpay">
</form>

---

Advanced Button

<form action="#" method="post">
  <input type="hidden" name="cmd" value="_pay_simple">
  <input type="hidden" name="reset" value="1">
  <input type="hidden" name="merchant" value="xxxxxxxxxxxx">
  <input type="hidden" name="item_name" value="xxxxxxxxxxxx">
  <input type="hidden" name="item_desc" value="xxxxxxxxxxxx">
  <input type="hidden" name="item_number" value="123456789">
  <input type="hidden" name="invoice" value="123456789">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="update_quantity" value="0">
  <input type="hidden" name="currency" value="BTC">
  <input type="hidden" name="amount" value="10.00000000">
  <input type="hidden" name="want_shipping" value="0">
  <input type="hidden" name="shipping_cost" value="0.00000000">
  <input type="hidden" name="shipping_cost_additional" value="0.00000000">
  <input type="hidden" name="success_url" value="https://....">
  <input type="hidden" name="cancel_url" value="https://....">
  <input type="hidden" name="ipn_url" value="https://....">
  <input type="hidden" name="buyer_leave_msg" value="0">
  <input type="image" src="" alt="">
</form>

---

Payment Buttons 2

Card HTML POST Fields

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
email	Buyer's email address.	No	128
address1	Street / address line 1	No	128
city	City	No	64
phone	Phone Number	No	32

Feel free to check out our example buttons.

Donation Button Maker

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

Example Buttons

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).