Donate with Amazon integration guide

Amazon Pay makes it easy for anyone with an Amazon account to donate to your cause by offering a seamless donation experience. Amazon Pay provides a trusted, familiar solution that offers a simple way to reach donors and maintain ongoing relationships. In only a few minutes you can start accepting contributions with Amazon Pay.

This guide takes you through a simple process to add a Donate with Amazon button on your website, letting your donors use Amazon Pay to donate.

When donors click the Donate with Amazon button, they're redirected to to sign in, they verify the amount they want to donate, and they're redirected back to your site after completing their donation. This hosted donation experience is the simplest way to accept donations on your site using Amazon Pay. Integrations that keep the donor on your site for the entire payment experience and that enable sustained giving through automatic payments are also available. For those integrations, see Amazon Pay technical documentation.

Register a new Amazon Pay application

To start using Donate with Amazon, register a new Amazon Pay application. This step is needed for authenticating the donor with Amazon.

  1. Login to Seller Central and select Integration > Integration Central from the navigation bar on the top-left side.
  2. Under the Manage client ID/store ID(s) section, click on Create new client ID/store ID, and enter information about your application.
  3. When you save changes, you receive the Client ID and Client Secret needed for authentication.

Set up your Donate with Amazon button

Step 1: Create a Donate with Amazon button

  1. Sign in to Seller Central.
  2. To the left of the search box near the top of the screen, click the Marketplace Switcher dropdown box, and then choose. Amazon Pay (Production View):

    If your screen is minimized, the Marketplace Switcher dropdown box appears as a button:
  3. Click Integration, and then click Button Generator.
  4. Under Create 'Donate with Amazon' widget, click Create.
  5. Choose the donation widget that best fits the options you want to offer donors:
    • Choose a preselected donation amount or enter a custom amount (recommended).
    • Enter any donation amount of their choosing.
    • Donate a predefined amount.
  6. After you choose a donation widget, enter the appropriate values, choose the Amazon Pay application that you created in the first step, and then click Create
  7. Copy the generated HTML to your clipboard for use in the next step.

Step 2: Test your Donate with Amazon button

Important! Donations submitted in a Production environment are charged. Because you are responsible for any fees incurred even when only testing, we recommend that you test only one or two donations to make sure that the button is set up correctly.

Testing your Donate with Amazon integration on your live site is sufficient because the integration is simple, but Amazon Pay also provides a Sandbox environment for more rigorous testing to ensure that your button works correctly. When you test your Amazon Pay buttons in Sandbox mode, you can simulate your donor's experience, making as many donations as needed without incurring any charges. To do so, complete Step 1: Create a Donate with Amazon button choosing the Amazon Pay (Sandbox View) option from the Marketplace Switcher dropdown box. For more information, see Creating Amazon Pay Sandbox buttons.

Test your Donate with Amazon button on your website

  1. Add to your production webpage the HTML code that you generated in Step 1. Tip  For the best donor experience, we recommend that you set the minimum width of the <div> in which you place the code to 400px.
  2. Open your production webpage in a browser, click the Donate with Amazon button, sign in using an account different from your merchant account (that is, not the account you use for signing in to Seller Central), and then complete your donation. (If you use your Seller Central credentials to sign in, you see a blank screen.)
  3. Sign in to Seller Central, and then verify that you are in Production mode by checking that the Amazon Pay (Production View) option appears in the Marketplace Switcher dropdown box.
  4. In Seller Central, click Orders, click Manage Transactions to open the Manage Payments Dashboard, and then check that the donation that you submitted is correct.

Managing donations

You can review a list of all donations made on your website using Amazon Pay and find further information, like the date, donor's name and email, and the donation amount, in your transaction reports in Seller Central. You can also manage payment transactions, collect payments, issue refunds, contact donors, and so on.

Review and manage donations

  1. Sign in to Seller Central.
  2. Click Orders, and then click Manage Transactions.

For more information, see Manage Transactions.

Frequently Asked Questions

Why do I see a 400 Bad Request Error?

You probably didn't register an Amazon Pay application. See the first step for registering an Amazon Pay application.

Do I need an SSL certificate to integrate the Donate with Amazon button?

No, an SSL certificate is not required.

How do I find donor information like the billing address?

Your donor billing address data is available in the daily capture reports. The reports include details about the billing address that is associated with the payment instrument used by the donor to make the donation. For details, see Amazon Pay donation reports.

See also

  • Settlement and transaction reports
    Amazon Pay provides two types of reports to help support your business processes: settlement reports and transaction reports. Using these reports, you can access donor information including name, email address, phone number, and billing address.
    For information about reporting, see Settlement and transaction reports.
  • Enable sustained giving
    You can enable sustained giving for your donors by implementing Amazon Pay automatic payments. This enables you to accept donations on a regular basis without requiring an authorization from the donor each time.
    For information about enabling sustained giving, see the automatic payments guide.