Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to Digg

Donation Button with Marketplace Fee 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

amazonPaymentsAccountIdYour 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

fixedMarketPlaceFeeIf you want to assess a fixed charge per transaction, set fixedMarketplaceFee to that value. You may have a value in both this parameter and variableMarketplaceFee.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

recipientEmailE-mail address of the merchant who will receive the payment.Yes

returnUrl

Optionally enter the URL where buyers should be redirected after they complete the transaction

No

variableMarketplaceFeeIf you plan to assess a percentage charge per transaction, set variableMarketplaceFee to that value. You may have a value in both this parameter and fixedMarketplaceFee.No
signatureA value calculated using the form parameters.Yes
signatureMethodThe signing algorithm, either HmacSHA1 or HmacSHA256.Yes
signatureVersionA 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 with Marketplace Fee Well-Formed HTML

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

<form 
    action="https://authorize.payments.amazon.com/pba/paypipeline"
    method="post">
    <input type="hidden" name="immediateReturn"
        value="1" >
    <input type="hidden" name="collectShippingAddress"
        value="1" >
    <input type="hidden" name="accessKey"
        value="11SEM03K88SD016FS1G2" >
    <input type="hidden" name="minimumDonationAmount"
        value="USD 50" >
    <input type="hidden" name="referenceId"
        value="MyTransaction-001" >
    <input type="hidden" name="recipientEmail"
        value="email domain.com" >
    <input type="hidden" name="variableMarketplaceFee"
        value="3" >
    <input type="hidden" name="signature"
        value="nVPwhhP9VqTJGUEilNlBcGVVTOs=" >
    <input type="hidden" name="fixedMarketplaceFee"
        value="USD 0.20" >
    <input type="hidden" name="isDonationWidget"
        value="1" >
    <input type="hidden" name="description"
        value="City Mission" >
    <input type="hidden" name="amazonPaymentsAccountId"
        value="WFQISAVAYLSB2VZ1LVCDJ2KLJ8H1BVULDVJ2GH" >
    <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="image"
        src=
    "https://authorize.payments.amazon.com/pba/images/GSDonationWithLogo.png"
        border="0">
    <input type="hidden" name="signatureVersion"
        value="2" >
    <input type="hidden" name="signatureMethod"
        value="HmacSHA256" >
</form>