Take your integration live

[Step 10 of 10] In this step, you will update your integration to use production values and review a pre-launch checklist. At the end of this step, you will be able to process live transactions.


1. Update Public Key ID in the button code

In the button integration code, replace publicKeyId associated to your sandbox key pair with your Live API public Key ID.

<body>
    <div id="AmazonPayButton"></div>
    <script src="https://static-na.payments-amazon.com/checkout.js"></script>
    <script type="text/javascript" charset="utf-8">
        amazon.Pay.renderButton('#AmazonPayButton', {
            // set checkout environment
            merchantId: 'merchant_id',
            ledgerCurrency: 'USD',  
            publicKeyId: 'LIVE-xxxxxxxxxx',
            // customize the buyer experience
            checkoutLanguage: 'en_US',
            productType: 'PayAndShip',
            placement: 'Cart',
            // configure Create Checkout Session request
            createCheckoutSessionConfig: {                     
                payloadJSON: 'payload', // payload generated in step 2
                signature: 'xxxx', // signature generatd in step 3
            }   
        });
    </script>
</body>
<body>
    <div id="AmazonPayButton"></div>
    <script src="https://static-eu.payments-amazon.com/checkout.js"></script>
    <script type="text/javascript" charset="utf-8">
        amazon.Pay.renderButton('#AmazonPayButton', {
            // set checkout environment
            merchantId: 'merchant_id',
            ledgerCurrency: 'EUR',      
            publicKeyId: 'LIVE-xxxxxxxxxx',
            // customize the buyer experience
            checkoutLanguage: 'en_GB',
            productType: 'PayAndShip',
            placement: 'Cart',
            // configure Create Checkout Session request
            createCheckoutSessionConfig: {                     
                payloadJSON: 'payload', // payload generated in step 2
                signature: 'xxxx', // signature generatd in step 3
            }   
        });
    </script>
</body>
<body>
    <div id="AmazonPayButton"></div>
    <script src="https://static-eu.payments-amazon.com/checkout.js"></script>
    <script type="text/javascript" charset="utf-8">
        amazon.Pay.renderButton('#AmazonPayButton', {
            // set checkout environment
            merchantId: 'merchant_id',
            ledgerCurrency: 'GBP',    
            publicKeyId: 'LIVE-xxxxxxxxxx',
            // customize the buyer experience
            checkoutLanguage: 'en_GB',
            productType: 'PayAndShip',
            placement: 'Cart',
            // configure Create Checkout Session request
            createCheckoutSessionConfig: {                     
                payloadJSON: 'payload', // payload generated in step 2
                signature: 'xxxx', // signature generatd in step 3
            }   
        });
    </script>
</body>

2. Review the pre-launch checklist

Ensure that stakeholders within your business have the proper user access permissions for Seller Central (US - EU/UK), and are aware of the launch date.

Account configuration

  • Ensure you’ve completed Amazon Pay merchant account registration and you’re ready to process payments in the Live environment.
  • Ensure you completed all the steps needed on the acquirer side to enable Amazon Pay for your website.
  • Add your logo in the Login with Amazon application to maintain a seamless checkout experience. The logo will be automatically resized to 50 x 150 pixels.

Optimize the buyer experience

  • Ensure that the Amazon Pay button appears above the fold on the cart and checkout pages. Place the button ahead of form fields to reduce checkout friction.
  • Verify that the Amazon Pay checkout experience is optimized for both desktop and mobile experiences.
  • Check that buyer communication provides accurate information. Adapt details being passed to the Checkout Session API accordingly

Common integration issues

  • Amazon Pay returns a single 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”.