Did this page help you? Yes No Tell us about it...

Creating a Marketplace-Enabled Donation Button

Topics

You can enable a marketplace feature with Amazon Simple Pay donation buttons. This allows you as a third party to host a donation site for others, and optionally collect a marketplace fee from them for the service. This topic details that procedure. If you are a non-profit organization, and only want to configure a basic donation button which does not incorporate the marketplace feature, see the simplified procedure detailed in Creating a Basic Donation Button instead.

Note

Amazon Simple Pay donation buttons are intended to benefit US-based, IRS-certified 501(c)3 non-profit organizations. The Amazon Payments business account for which you collect money must be a Non-Profit Organization account type. The 501(c)3 organization representative must navigate to https://payments.amazon.com, sign in the organization's Amazon account, navigate to the Your Account tab, Edit My Account Settings page, and set the account type there.

Three parties are involved in a marketplace-enabled donation website

Web site owner—Hosts the website that provides a 501(c)3 organization a service for soliciting donations. By enabling the marketplace fee button, the website owner creates a contract for the organization representative to sign to begin accepting donations. That contract may include a transaction fee.
501(c)3 Organization—By clicking the marketplace fee button and filling out a web form to accept the contract, the organization representative obtains a contract with the website owner to list donations on the website.
Contributor—Elects to make donations on the website using the donation button. The marketplace function does not change the interaction for the contributor, who is treated just like someone purchasing any other good or service.

In this section you learn how to create a marketplace-enabled donation button and place both it and the corresponding marketplace fee form on your web page.

How to Generate the HTML for a Marketplace-Enabled Donation Button

The following procedure guides you through generating the HTML for a donation button.

	Important
	We strongly recommend that you create and test all of your requests in the sandbox before exposing them on your website. For more information, see Testing Your Simple Pay Buttons

To create the HTML for a Marketplace-Enabled Donation button

	Note
	You can set many of the fields in the form to default values using your seller preferences. For more information, see Configuring Default Button Values.

Go to http://payments.amazon.com and log into your Amazon Payments Business Account. For more information, see Before You Begin.
From here, go to https://payments.amazon.com/sdui/sdui/donationbutton to show the Amazon Simple Pay > Donations page, which contains the following form for you to fill in.
Note
To create a button in the sandbox, go to https://payments-sandbox.amazon.com/sdui/sdui/donationbutton instead.

Use the following table to fill in the entry fields.

	Tip
	You can also hold the mouse pointer over most fields of the online form to display usage tips in the right side of the form.

Field	Action
Amount	Select the amount type and enter the amount, where appropriate. Any Amount allows the donor to specify any amount. Minimum Amount requires the donor to contribute at least this amount. For example, if you specify `$10`, the donor must contribute at least `$10` in order to complete the form. Corresponds to the `minimumDonationAmount` field in the button html. Fixed Amount lets the donor contribute only the specified amount. If you specify `$10`, the donor must contribute exactly `$10`.
Reason for donation	Enter a purpose for the donation Corresponds to the `description` field in the button html.
Reference	Optionally enter an ID for your records that will uniquely identify the donation. Corresponds to the `referenceId` field in the button html.
Return URL	Optionally enter the URL where contributors should be redirected after completing the donation payment. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the `returnUrl` field in the button html.
User Abandon URL	Optionally enter the URL where contributors should be redirected if they cancel their donation. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the `abandonUrl` field in the button html.
URL for Instant Payment Notification (IPN)	Optionally, type the URL of your host page to which Amazon Payments should send the IPN transaction information. This is an advanced feature. For more information, see Using Instant Payment Notification. This field overrides the setting in Your Account > Edit My Account Settings > Manage Developer and Seller Preferences, as described in How to Configure Default Button Values.. Corresponds to the `ipnUrl` field in the button html.
Immediate Return	Optionally, if you want to skip the final status page in Amazon Payments, select this check box. If you select this option, you can parse the return values and display a final status page to the user yourself. This is an advanced feature. For more information, see Using Immediate Return. Corresponds to the `immediateReturn` field in the button html.
Collect the shipping address?	If you want Amazon Payments to return the contributor's shipping address as part of the transaction information, select this check box. Corresponds to the `collectShippingAddress` field in the button html.
Do you want to enable marketplace feature?	Optionally, if you as a third party plan to host the donation site for a 501(c)3 organization, select this check box. The Recipient Email and Market Fee Button: options appear.
Recipient's Email text box	Enter the email address of the tax exempt organization receiving the donation. Corresponds to the `recipientEmail` field in the button html.
Your website background	Select the type of button background you need. The white option sets a white background. The color option produces a button with a transparent background (that is, your website theme colors will show).
Button Type	Select the button image that you want to appear on your form for the donation. Corresponds to the src attribute for the image in the button html.
Do you want to charge a Marketplace fee?	Optionally, if you want to add a fee when collecting the donation, select this check box. When you check this option, the Configure the marketplace fee button form section displays, containing the Return URL, Marketplace Fee, and Market Fee Button options.

If you want to charge a marketplace fee to the 501(c)3, and have checked the Do you want to charge a Marketplace fee? check box, the Configure the marketplace fee button form displays.

Field Action

Return URL

Field	Action
Return URL	Type the URL the seller returns to after accepting the per-transaction fee. Corresponds to the `returnUrl` field in the marketplace fee button html.
Marketplace Fee fields	Enter the marketplace fee you will charge. You can specify a percentage of the transaction, a fixed fee per transaction, or both. Corresponds to the `maxVariableFee`, `maxFixedFee`, and `recipientPaysFee` fields in the marketplace fee button html.
Market Fee Button	Select the button image you want to display on your marketplace fee form. Corresponds to the src attribute for the image in the button html.

Type the URL the seller returns to after accepting the per-transaction fee.

Corresponds to the returnUrl field in the marketplace fee button html.

Marketplace Fee fields

Enter the marketplace fee you will charge. You can specify a percentage of the transaction, a fixed fee per transaction, or both.

Corresponds to the maxVariableFee, maxFixedFee, and recipientPaysFee fields in the marketplace fee button html.

Market Fee Button

Select the button image you want to display on your marketplace fee form.

Corresponds to the src attribute for the image in the button html.

Click Generate HTML. Amazon Payments produces the HTML form for the both the donation button and the marketplace fee button. Each is displayed in its own text area underneath the Generate HTML button. Typical HTML forms for a marketplace-enabled donation button are shown in Marketplace-Enabled Donation Button HTML Components
Copy the HTML and paste it in the appropriate page on your website. It will be displayed on the web page as a Donate button.

You can begin using your new button immediately. However, Amazon recommends you test every button before deploying it to production. A testing environment, the Amazon Payments sandbox, is provided for you to test any of the button types. To learn how to test your buttons, see Testing Your Simple Pay Buttons

	Important
	You are each time a contributor starts a donation. For more information, see Getting Notification about Your Payments.

Marketplace-Enabled Donation Button HTML Components

Here are samples of the HTML forms generated for a donation button that incorporates the marketplace fee feature.

First, is the portion for the donation button.

<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="AKIAIOSFODNN7EXAMPLE" >
    <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="WFQISAVAYLSB2VZ1LVCDJ2KLJ8H1BVUEXAMPLE" >
    <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>

Here is the form for the marketplace fee.

<form 
    action="https://authorize.payments.amazon.com/cobranded-ui/actions/
    start"
    method="get">
    <input type="hidden" name="maxVariableFee"
        value="3.00" >
    <input type="hidden" name="maxFixedFee"
        value="0.2" >
    <input type="hidden" name="callerAccountId"
        value="WFQISAVAYLSB2VZ1LVCDJ2KLJ8H2BVUEXAMPLE" >
    <input type="hidden" name="recipientPaysFee"
        value="True" >
    <input type="hidden" name="returnURL"
        value="http://yourwebsite.com/returnurl" >
    <input type="hidden" name="signature"
        value="HmZ3hZyRXbJh+7yfLSuE/P4wBlY=" >
    <input type="hidden" name="collectEmailAddress"
        value="True" >
    <input type="hidden" name="callerReference"
        value="939d61ff-85b0-4a12-aa2d-c2e84a30805f" >
    <input type="hidden" name="callerKey"
        value="AKIAIOSFODNN7EXAMPLE" >
    <input type="hidden" name="pipelineName"
        value="Recipient" >
    <input type="image"
        src=
"https://authorize.payments.amazon.com/pba/images/MarketPlaceFeeWithOutLogo.png"
        border="0">
    <input type="hidden" name="signatureVersion"
        value="2" >
    <input type="hidden" name="signatureMethod"
        value="HmacSHA256" >
</form>

Test Your Marketplace-Enabled Donation Button

Amazon Simple Pay provides a testing environment, the Amazon Payments Sandbox, for testing the buttons you create. Using the sandbox you can try out your applications without incurring charges or making purchases. We strongly recommend that you create and test all of your requests in the sandbox before exposing them on your website.

All the simple pay buttons are tested in the same way, and you can test a button whether you plan to use it in your website or not. To learn how to all test Amazon Simple Pay buttons, see Testing Your Simple Pay Buttons

Advanced Marketplace-Enabled Donation Button Features

Within this section, we present the following advanced topics in passing which are not required to implement basic features. Please refer to the sections for detailed information.

In the previous procedure you worked with the features of the marketplace-enabled donation button that are quickest to build. There are many other features of Amazon Simple Pay and the Amazon Flexible Payments Service that can make your website more sophisticated and usable. Some of the topics which may be of interest to you are:

Customizing Amazon Simple Pay Buttons
Simulating Amazon Simple Pay Button Errors
Adding Amazon Simple Pay as an Additional Payment Option
Programmatic APIs for canceling, settling, and refunding transactions, as well as getting a transaction status, and verifying signatures in Return URL and IPN notifications.
Configuring Instant Payment Notification and Handling Instant Payment Notifications
Using Amazon Simple Pay Actions

To learn how to do some of these tasks, see the Amazon Simple Pay Advanced User Guide, For complete details on the capabilities of Amazon Simple Pay, please see the suggested documentation listed in Amazon Simple Pay Resources

Document Conventions
Terms of Use

Did this page help you? Yes No Tell us about it...

	Note
	To create a button in the sandbox, go to https://payments-sandbox.amazon.com/sdui/sdui/donationbutton instead.