The buttons are implmented as standard HTML POST forms. The fields available are documented below.
Field Name | Description | Required? | Length Limit |
---|
Main Fields |
---|
merchant | Your merchant ID (you can find this on the My Account page). | Yes | N/A |
Cart Fields |
---|
currency |
The currency of the payment. Default : USD |
No | 3 |
invoice_number | This is a passthru variable for your own use. [not visible to buyer] | Yes | 128 |
Item/Payment Description Fields |
---|
currency |
The currency of the payment (BTC, LTC, ETH, USD, EUR, XRP, etc.). Values supported: Any crypto or fiat currency on the Supported Coins page. |
Yes | 3 |
item_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_number | This is a passthru variable for your own use. [not visible to buyer] | Yes | 128 |
Shipping Fields |
---|
allow_shipping_cost |
1 = Want buyer's shipping information. 0 = Don't want buyer's shipping information. (default) |
No | 0 |
shipping_cost | Cost of shipping the item. | No | N/A |
tax_amount | Any tax to charge. | No | 128 |
Miscellaneous Fields |
---|
ipn_url_link |
Sets an IPN URL. If not set or blank defaults to the IPN URL in your settings |
No | 128 |
success_url_link | Sets a URL to go to if the buyer does complete checkout | No | 128 |
cancel_url | Sets a URL to go to if the buyer decides to not complete checkout. | No | 128 |
Buyer Information These fields can be used to pre-populate forms with any information you already know about your buyer. |
---|
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 |
address2 | Street / address line 2 | No | 128 |
city | City | No | 64 |
state | State / Province | No | 64 |
zip | Zip / Postal Code | No | 32 |
country |
Country of Residence This uses 2 digit ISO 3166 country codes. |
No | 2 |
phone | Phone Number | No | 32 |
Feel free to check out our example example buttons. |
---|
In Development, Coming soon.