AWS Documentation » Amazon Simple Pay » Advanced Guide » Working with Amazon Simple Pay Buttons » Amazon Simple Pay Button Input Reference » Donation Button Input Reference	« Previous Next »
	Did this page help you? Yes \| No \| Tell us about it...

Donation Button Input Reference

The input parameters are a mix of required parameters, as listed in the following table.

Parameter	Description	Required
`abandonUrl`	Optionally enter the URL where senders should be redirected if they cancel their transaction	No
`accessKey`	Your AWS Access Key	Yes
`amazonPaymentsAccountId`	Your Amazon Payments account ID. This parameter is not used and should not be present if you sign the button using your secret key. For more information, see Using Access Identifiers).	Yes
`amount`	Enter the amount you want to collect for the item	Yes
`cobrandingStyle`	Optionally, set to a cobranding style. Valid values are "logo" or "banner". ("logo" is preferred)	No
`collectShippingAddress`	Optionally set to `1` if you want Amazon Payments to return the buyer's shipping address as part of the transaction information	No
`description`	Enter a description of the item	Yes
`donationType`	Optionally set to the type of donation. Valid values are `fixedAmount`, `minimumAmount` and `anyAmount`. Default value is `anyAmount`.	No
`immediateReturn`	Optionally set to `1` to skip the final status page in Amazon Payments. Default is `0`.	No
`ipnUrl`	Optionally type the URL of your host page to which Amazon Payments should send the IPN transaction information	No
`isDonationWidget`	Always `1` for a donation button.	Yes
`minimumDonationAmount`	The minimal payment allowed or the donation.	Yes, if the value for `donationType` is `minimumAmount`
`processImmediate`	Optionally set to `1` to settle the transaction, otherwise set `processImmediate` to `0`. Default value is `1`	No
`referenceId`	Optionally provide a unique identifies of this transaction for your records.	No
`returnUrl`	Optionally enter the URL where buyers should be redirected after they complete the transaction	No
`signature`	A value calculated using the form parameters.	Yes
`signatureMethod`	The signing algorithm, either `HmacSHA1` or `HmacSHA256`.	Yes
`signatureVersion`	A value that specifies the signature format. Currently, the only valid value is `2`.	Yes

For information on using the Amazon Simple Pay to create buttons, see Understanding the Amazon Simple Pay Button Samples.

Donation Button Well-Formed HTML

Example HTML for a basic donation button with no added fee, signed using the signature version 2 method.

<form action="https://authorize.payments.amazon.com/pba/paypipeline"
    method="POST">
    <input 
        type="image" 
        src=
"https://authorize.payments.amazon.com/pba/images/GSDonationWithLogo.png"
        border="0">
    <input 
        type="hidden" name="immediateReturn" value="1" >
    <input 
        type="hidden" name="collectShippingAddress" value="1" >
    <input 
        type="hidden" name="accessKey" value="YourAccessKeyId" >
    <input 
        type="hidden" name="minimumDonationAmount" value="USD 50" >
    <input 
        type="hidden" name="referenceId" value="MyTransaction-001" >
    <input 
        type="text" name="amount" size="8" value="50" >
    <input 
        type="hidden" name="isDonationWidget" value="1" >
    <input 
        type="hidden" name="fixedMarketplaceFee" value="" >
    <input 
        type="hidden" name="description" value="City Mission" >
    <input 
        type="hidden" name="ipnUrl" 
        value="http://yourwebsite.com/instantpaymentnotification" >
    <input 
        type="hidden" name="returnUrl" 
        value="http://yourwebsite.com/success" >
    <input 
        type="hidden" name="processImmediate" value="1" >
    <input 
        type="hidden" name="cobrandingStyle" value="logo" >
    <input 
        type="hidden" name="abandonUrl" 
        value="http://yourwebsite.com/abandon">
    <input 
        type="hidden" name="signature" 
        value="JL9k2iY4H2IQ0A+2zvFi31zLnPmOFEfMwzpLYG0Rao8=" >
    <input 
        type="hidden" name="signatureVersion" value="2" >
    <input 
        type="hidden" name="signatureMethod" value="HmacSHA256" >
</form>

Document Conventions	« Previous Next »
Terms of Use	Did this page help you? Yes \| No \| Tell us about it...