Donation Buttons

Field Name Description Required? Length Limit
Main Fields
cmd This should always be set to '_donate'. 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
Donation Amount Fields
currency The currency of the donation (BTC, LTC, USD, EUR, etc.).
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 3
amountf The amount (in the currency chosen) of the donation.
This is not required if allow_amount is set to 1
Yes N/A
item_name Who/what the donation is for. Yes 128
item_number This is a passthru variable for your own use. [not visible to donator] No 128
invoice This is a passthru variable for your own use. [not visible to donator] No 128
custom This is a 2nd passthru variable for your own use. [not visible to buyer] No 128
allow_amount 1 = Allow donator to adjust donation amount (default).
0 = Don't allow donator to adjust donation amount.
No 1
allow_currencies Currency codes separated with a comma of coins you will accept. This is used to further restrict the coin selection from your list of enabled coins; for example if you are doing your own exchange rates and want to limit checkout to a user selected currency.
Example: BTC,LTC
No 255
Miscellaneous Fields
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 donator does complete checkout. No 255
cancel_url Sets a URL to go to if the donator decides to not complete checkout. No 255