Take your integration live

[Step 9 of 9] 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 publicKeyId

In the button integration code, replace publicKeyId with your Live API public Key ID. Repeat the get your public key ID instructions to generate the Live public Key ID. Be sure to select the "Production" option from the "Marketplace switcher" drop-down in step 2.

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'USD',            
        // customize the buyer experience
        checkoutLanguage: 'en_US',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2'
            
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'EUR',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2'
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'GBP',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2'
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        publicKeyId: 'LIVE-xxxxxxxxxx',
        ledgerCurrency: 'JPY',            
        // customize the buyer experience
        checkoutLanguage: 'ja_JP',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2'
        }   
    });
</script>

2. 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.

Complete account setup

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 to the Amazon Pay store configuration 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.
Upgrade to a live account if you’re using a developer account: US, EU, UK, JP.

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.

Amazon Pay brand assets

To let your buyers know they can pay securely on your website with Amazon Pay, we offer acceptance marks that you can add to your website and checkout alongside other payment options. This mark must not be used in advertising. You can use the Amazon Pay logo for banner ads, social media and other promotions. For more information, see the merchant toolkit (pages 13 to 21). This mark is not to be used as a checkout button. To learn more about buttons, see page 2 in the merchant toolkit.

The Amazon Pay mark is available in the colors shown below. Other color options are included in the provided brand assets package. Do not to alter the artwork or create your own version of this mark.

Amazon Pay logo

The Amazon Pay logo is the heart of our identity. It acts as a signature as well as a guarantee of trustworthiness and dependability. Because the logo is an integral part of our brand communications, it's vital that it's used consistently whenever it appears.
There is never any need to update the files that have been provided. Please don't alter any colors in the logos. If you have logo files that don't match the names found in this package, delete those old files; only use the files provided in the provided Brand Assets package.
Any use of the Amazon Pay logo must comply with the Amazon Pay Trademark Usage Guidelines (see page 22 of the merchant toolkit for details). All marketing materials must be approved by Amazon Payments before they are published. For approval requests, help with content, or general marketing questions, please contact your Amazon Pay account manager or merchant support.
Review pages 6 to 10 of the merchant toolkit before adding the Amazon Pay logo to your website.

Additional guidelines of which to be mindful:

Don’t use the logo in a sentence.
Don’t add additional visual elements to the logo.

Name	Usage	Logo	Download-Link
Primary logo	Default logo		svg png
Secondary logo	Use only on websites with dark background		svg png

Amazon Pay acceptance mark

Now that you accept Amazon Pay, you should let your customers know that you offer an even easier way to shop online. You can do this by using our acceptance mark on your website alongside other payment options.
This mark should not be used in advertising. You can use the Amazon Pay logo for banner ads, social media and other promotions. For more information, see the merchant toolkit (pages 13 to 21)
This mark is not to be used as a checkout button.

Any use of the Amazon Pay Acceptance Mark must comply with the Amazon Pay
Trademark Usage Guidelines (see page 22 of the merchant toolkit for details)

Review pages 10 and 11 of the merchant toolkit before adding the acceptance mark to your website.

Name	Usage	Logo	Download-Link
Primary Pay acceptance mark	Default Pay acceptance mark		svg png
Secondary Pay acceptance mark	Secondary Pay acceptance mark. Use only on websites with dark background		svg png

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”.

1. Update the button-rendering code

In the button integration code, remove the sandbox parameter. You must also generate a new signature if payloadJSON changes.

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'USD',            
        // customize the buyer experience
        checkoutLanguage: 'en_US',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'EUR',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'GBP',            
        // customize the buyer experience
        checkoutLanguage: 'en_GB',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</script>

<script type="text/javascript" charset="utf-8">
    amazon.Pay.renderButton('#AmazonPayButton', {
        // set checkout environment
        merchantId: 'merchant_id',
        ledgerCurrency: 'JPY',            
        // customize the buyer experience
        checkoutLanguage: 'ja_JP',
        productType: 'PayAndShip',
        placement: 'Cart',
        buttonColor: 'Gold',
        // configure Create Checkout Session request
        createCheckoutSessionConfig: {                     
            payloadJSON: 'payload',
            signature: 'xxxx',
            algorithm : 'AMZN-PAY-RSASSA-PSS-V2',
            publicKeyId: 'xxxxxxxxxx' 
        }   
    });
</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