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

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

Item Number [not visible to buyer]

Invoice [not visible to buyer]

Tax Amount

Don't Collect Shipping Address

Shipping Cost

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.

Generate

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

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

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.

128

item_number

This is a passthru variable for your own use. [not visible to buyer]

128

invoice

This is a passthru variable for your own use. [not visible to buyer]

128

allow_quantity

0 = Don't allow buyer to adjust quantity (default). 1 = Allow buyer to adjust quantity.

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)

shippingf

Cost of shipping the item. Shipping cost is shippingf*quantity (unless shipping2 is set)

N/A

shipping2f

Cost of shipping each additional item. Shipping cost is shippingf+((quantity-1)*shipping2f)

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.

255

success_url

Sets a URL to go to if the buyer does complete checkout.

255

cancel_url

Sets a URL to go to if the buyer decides to not complete checkout.

255

lang

Automatically set the checkout language to this language code. For a list of supported codes check this page.

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.

last_name

Buyer's last name.

Buyer's email address.

128

address1

Street / address line 1

128

city

City

phone

Phone Number

Feel free to check out our 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).

PreviousMerchant Tools NextCustom APIs

Last updated 3 months ago

Payment Buttons

Simple Button Maker

Generate

Advance Button Maker

Generate

Minimal Button

Button with Item Description

Advanced Button

Payment Buttons 2

Card Buttons

Main Fields

Item/Payment Description Fields

Shipping Fields

Miscellaneous Fields

Buyer Information. These fields can be used to pre-populate forms with any information you already know about your buyer.

Donation Button Maker

Generate

Minimal Button

Button with Shipping and Item Quantities

White Button with Note from Buyer, Success/Return to Store URLs, and No Shipping Info

Payment Buttons

Simple Button Maker

Generate

Advance Button Maker

Generate

Minimal Button

Button with Item Description

Advanced Button

Payment Buttons 2

Card Buttons

Main Fields

Item/Payment Description Fields

Shipping Fields

Miscellaneous Fields

Buyer Information. These fields can be used to pre-populate forms with any information you already know about your buyer.

Donation Button Maker

Generate

Minimal Button

Button with Shipping and Item Quantities

White Button with Note from Buyer, Success/Return to Store URLs, and No Shipping Info