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 |
Donation Amount Fields |
---|
currency |
The currency of the payment (USD). No need to set. |
Yes | N/A |
donation_amount | The amount (in the currency chosen) of the payment. | Yes | N/A |
donation_name | Who/what the donation is for. | 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 |
item_qty |
Quantity of the Item. Default : 1 |
Yes | 20 |
buyer_qty_edit |
0 = Don't allow buyer to adjust quantity (default). 1 = Allow buyer to adjust quantity. |
No | 1 |
allow_buyer_note |
0 = Don't allow buyer to give buyer note. (default). 1 = Allow buyer to give buyer note. |
No | 1 |
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 example donation buttons. |
---|
In Development, Coming soon.