If you need a checkout with more options such as buyer selectable quantity, multiple item shipping, etc. check out our Advanced Buttons.
The buttons are implmented as standard HTML POST forms to https://gcps.io/mtools/simple-button-payment/. The fields available are documented below.
Field Name | Description | Required? | Length Limit |
---|
Main Fields |
---|
merchant_id | Your merchant ID (you can find this on the My Account page). | Yes | 128 |
Item/Payment Description Fields |
---|
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_qty |
Quantity of Item. Default:1 |
YES | 128 |
item_number | This is a passthru variable for your own use. [not visible to buyer] | YES | 128 |
invoice_number | This is a passthru variable for your own use. [not visible to buyer] | YES | 128 |
tax_amount | Any tax to charge. | No | 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 |
shipping_cost_add |
To add the Cost of shipping the item with the Final Bill. Default: 1 |
No | 20 |
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 buttons. |
---|
In Development, Coming soon.