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