Configuring Amazon Pay

Learn how to configure Amazon Pay for DigitalRiver.js with Elements

If you're using DigitalRiver.js with Elements, you can create an Amazon Pay payment method for your app or website in two easy steps:

• Step 1: Create an Amazon Pay source using DigitalRiver.js

• Step 2: Use the authorized source

Step 1: Create an Amazon Pay source using Digital River.js

Amazon Pay is different from other payment methods. The shopper's payment information is pulled into the cart directly from their Amazon Pay account.

To create an Amazon Pay payment source, follow the instructions in the DigitalRiver.js reference guide. If the shopper is paying for a subscription, you must provide the mandate.terms that the customer agreed to on your storefront and set autoRenewal to true, and futureUse to true.

Create an Amazon Pay element

After setting up your library per the DigitalRiver.js reference guide, create an Amazon Pay element with any customizations you would like to apply.

var options = {
    style: {
        color: 'DarkGray', // one of ['Gold', 'LightGray', 'DarkGray']
        height: '100px'
    },
    sourceData: {
        type: 'amazonPay',
        sessionId: sessionId,
        country: 'US', // required if your session does not contain shopper country
        futureUse: true, // required if you intend to use for recurring billing
        usage: 'subscription', //only required if futureUse is true - should be one of ['subscription', 'convenience', ]
        mandate: { // required for recurring/reusable
            terms: 'Yes, please save this account and payment information for future purchases.'
        }
    },
    amazonPay: {
        //Amazon Pay will redirect to this URL after the buyer signs in
        returnUrl: '<return.com URL>', 
        //where the shopper will be returned after authorizing at Amazon Pay 
        resultReturnUrl: 'htPay-hostedtps://<resultreturn.com URL>', 
        //Amazon Pay will redirect to this URL if the buyer cancels sign-in on the Amazon Pay-hosted page
        cancelUrl: '<cancel.com URL>', 
        // Placement of the Amazon Pay button on your website. One of ['Home', 'Cart', 'Product', 'Checkout', 'Other']
        placement: 'Product', 
            // optional, one of ['en_US', 'en_GB', 'de_DE', 'fr_FR', 'it_IT', 'es_ES', 'ja_JP']
        checkoutLanguage: 'fr_FR'
    }
    }
};

var amazonpay = digitalriver.createElement('amazonpay', options);
amazonpay.mount('amazonpay');

Attribute	Description
country	An optional string that represents an ISO 3166-1 alpha-2 country code. This is required when your session does not contain a shopper country.
returnUrl	A redirect to the Amazon Pay Sign in page. When the shopper selects Amazon Pay as their payment method from the cart (see callout 1 in the image below), Digital River creates a payment session and source and redirects the shopper to the Amazon Pay Sign in page (see callout 2). The shopper must sign in to Amazon to access the order confirmation page. At this point, the payment information is attached to the Digital River payment source. The shopper must complete the verification process and place the order (see callout 3). Amazon Pay processes the payment (see callout 4) and the source is attached to the cart.
resultReturnUrl	A redirect to your thank you page. After Amazon Pay process the payment, the shopper is redirected to your thank you page (see callout 5).
cancelUrl	A redirect from the cancelled login page to a page specified by you. Amazon will redirect the shopper to this cancellation URL if the shopper cancels their checkout on the Amazon Pay hosted page.
placement	The location where you placed the Amazon Pay button on your website. Your options are Home, Cart, Product, Checkout, or Other. Note: If you place the Amazon Pay button on the Checkout page, it is a standard checkout. If you place it on Home, Cart, Product, or Other page, it is an express checkout.
checkoutLanguage	The language used on the checkout page. Your options are en_US, en_GB, de_DE, fr_FR, it_IT, es_ES, or ja_JP.

See How it works for more information on Amazon Pay's Express Checkout flow.

Step 2: Use the authorized source

Option 1. Attach the source to a cart

Once the shopper signs in to Amazon and authorizes the source, you can attach the source to a cart.

POST /v1/shoppers/me/carts/active/apply-payment-method

{
  "paymentMethod": {
    "sourceId": "e7ba0595-059c-460c-bad8-2812123b9313"
  }
}

Option 2. Attach the source to a shopper

Once the shopper signs in to Amazon and authorizes the source for a subscription, you can attach the source for the customer.

POST /v1/shoppers/me/payment-options

{
  "paymentOption": {
    "nickName": "My Token",
    "isDefault": "true",
    "sourceId": "61033d62-c0f4-4a7e-b844-07daf26ba84e"
  }
}