Take your integration live

[Step 8 of 8] Go live by updating the API endpoints. To ensure a successful launch, review the pre-launch checklist, in section 3 below.


1. Update the button-rendering code

In the button integration code, remove the sandbox parameter:

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        merchantId: 'merchant_id',
        createCheckoutSession: {
            url: 'https://mystore/amazonpay/createcheckoutsession'
        },
        ledgerCurrency: 'USD',
        checkoutLanguage: 'en_US',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold'
    });
</script>
<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        merchantId: 'merchant_id',
        createCheckoutSession: {
            url: 'https://mystore/amazonpay/createcheckoutsession'
        },
        ledgerCurrency: 'EUR',
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold'
    });
</script>
<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        merchantId: 'merchant_id',
        createCheckoutSession: {
            url: 'https://mystore/amazonpay/createcheckoutsession'
        },
        ledgerCurrency: 'GBP',
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold'
    });
</script>
<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        merchantId: 'merchant_id',
        createCheckoutSession: {
            url: 'https://mystore/amazonpay/createcheckoutsession'
        },
        ledgerCurrency: 'JPY',
        checkoutLanguage: 'ja_JP',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold'
    });
</script>

2. Update API endpoints

Change API endpoints from sandbox to live:

Region
Sandbox base API endpoint
Production base API endpoint
US
https://pay-api.amazon.com/sandbox/:version
https://pay-api.amazon.com/live/:version
EU/UK
https://pay-api.amazon.eu/sandbox/:version
https://pay-api.amazon.eu/live/:version
JP
https://pay-api.amazon.jp/sandbox/:version
https://pay-api.amazon.jp/live/:version

3. Review the pre-launch checklist

Ensure that stakeholders within your business have the proper user access permissions for Seller Central, and are aware of the launch date. Review the pre-launch checklist below to ensure a successful launch.

Account configuration

  • Ensure that you have completed Amazon Pay merchant account registration, and you’re ready to process payments in Production.
  • Ensure all domains have been added to Seller Central. See Add domains to Seller Central for more info.
  • Add your logo in the Login with Amazon application to maintain a seamless checkout experience. Note that the logo will be automatically resized to 50 x 150 pixels.
  • If you're using IPNs to handle asynchronous processes, add production IPN endpoints. See using IPNs for more info.

Optimize the buyer experience

  • Ensure that the Amazon Pay button appears above the fold on cart and checkout pages.
  • Reduce checkout friction by placing the Amazon Pay button at the start of checkout, before buyers are asked to manually enter their details.
  • Verify that the Amazon Pay checkout experience is optimized for both desktop and mobile experiences.
  • Check that buyer communication provides accurate information.

Common integration issues

  • Some Amazon Pay transactions are processed asynchronously. This means that Amazon Pay will return a pending response and the object will be in an Pending state until processing is complete. If applicable, make sure that you’re handling asynchronous processing.
  • Amazon Pay returns a string string for buyer name. Make sure you’re parsing the buyer name correctly. Note that some buyers may only provide a single name, e.g. “Jane”.