---
title: Get set up for integration
url: amazon-pay-checkout/v1-get-set-up-for-integration.html
---

**[Step 1 of 8]** The first step to get set up for integration is to register for an Amazon Pay merchant account. After registration, you will create a sandbox buyer account for testing, and get your Public Key ID to access Amazon Pay APIs.

* TOC
{:toc}

* * *

### 1. Register for Amazon Pay

Sign up for an Amazon Pay merchant account on the Amazon Pay website: <a href="https://pay.amazon.com/signup" target="_blank" rel="noopener noreferrer">US</a>, <a href="https://pay.amazon.eu/signup" target="_blank" rel="noopener noreferrer">EU, <a href="https://pay.amazon.co.uk/signup" target="_blank" rel="noopener noreferrer">UK</a>, <a href="https://pay.amazon.co.jp/signup" target="_blank" rel="noopener noreferrer">JP</a>. After registration is complete, return to this page.
* * *

### 2. Add Domains to Seller Central
Add all the domains (including protocol and custom ports) that you plan on using for the Amazon Pay checkout to the JavaScript Origins in Seller Central: <a href="https://sellercentral.amazon.com/external-payments/amazon-pay/integration-central/lwa?" target="_blank" rel="noopener noreferrer">US</a>, <a href="https://sellercentral-europe.amazon.com/external-payments/amazon-pay/integration-central/lwa?" target="_blank" rel="noopener noreferrer">EU</a>, <a href="https://sellercentral-japan.amazon.com/external-payments/amazon-pay/integration-central/lwa?" target="_blank" rel="noopener noreferrer">JP</a>. 

For example, ‘https://www.example.com/’ or ‘https://www.example.com:8000/’

All domains must be compliant with Amazon Pay Acceptable Use Policy: <a href="https://pay.amazon.com/help/6023" target="_blank" rel="noopener noreferrer">US</a>, <a href="https://pay.amazon.eu/help/6023" target="_blank" rel="noopener noreferrer">EU</a>, <a href="https://pay.amazon.co.uk/help/6023" target="_blank" rel="noopener noreferrer">UK</a>, <a href="https://pay.amazon.co.jp/help/6023" target="_blank" rel="noopener noreferrer">JP</a>. The Amazon Pay button may be inactive during review.

<div markdown="span" class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Newly added JavaScript origins don't show immediately. The verification of newly added JavaScript origins can take up to 48 hours. Please add your website URLs as early as possible in the integration process.<br/><strong>Sandbox integrations are not affected by this verification process.</strong></div>
* * *

### 3. Create a Sandbox test buyer account

You will use Sandbox to conduct end-to-end tests of your integration before going live. For details, see <a href="../amazon-pay-checkout/amazon-pay-sandbox-accounts.md" target="_blank" rel="noopener noreferrer">Amazon Pay Sandbox accounts</a>. After creating a Sandbox buyer account, return to this page.
* * *

### 4. Download the Amazon Pay SDK

Download the Amazon Pay SDK if one is available for your programming language. Please reach out to your Amazon Pay account manager if you don’t see a SDK in your preferred language.

PHP: <a href="https://github.com/amzn/amazon-pay-api-sdk-php/tree/1.x" target="_blank" rel="noopener noreferrer">https://github.com/amzn/amazon-pay-sdk-v2-php</a>

.NET: <a href="https://github.com/amzn/amazon-pay-api-sdk-dotnet/tree/1.x" target="_blank" rel="noopener noreferrer">https://github.com/amzn/amazon-pay-api-sdk-dotnet</a>

Java: <a href="https://github.com/amzn/amazon-pay-api-sdk-java/tree/1.x" target="_blank" rel="noopener noreferrer">https://github.com/amzn/amazon-pay-api-sdk-java</a>


* * *

### 5. Get your Public Key ID

Amazon Pay uses asymmetric encryption to secure communication. You will need a public/private key pair and a corresponding Public Key ID (a unique Amazon Pay identifier for the key pair) to access Amazon Pay APIs. You can generate a public/private key pair and access the Public Key ID using Amazon Pay Integration Central.

<div markdown="span" class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Amazon Pay does not require separate credentials for different environments. You can use the same Public Key ID and key pair for both Live and Sandbox.</div>

Instructions:

1. Navigate to Amazon Pay Integration Central: <a href="https://sellercentral.amazon.com/gp/pyop/seller/integrationcentral/" target="_blank" rel="noopener noreferrer">US</a>, <a href="https://sellercentral-europe.amazon.com/gp/pyop/seller/integrationcentral/" target="_blank" rel="noopener noreferrer">EU</a>, <a href="https://sellercentral-japan.amazon.com/gp/pyop/seller/integrationcentral/" target="_blank" rel="noopener noreferrer">JP</a>.
2. Identify as a “Self-developed” integration
    1. Select “Self-developed” option from the drop-down menu
    2. Use the default “One-time Payments, Single Authorization” payment type setting
    <img style="width: 60%" src="https://m.media-amazon.com/images/G/01/EPSDocumentation/AmazonPay/Integration/IntegrationCentral-OneTimeSingleAuth._CB1198675309_.png" />
    3. Click on the “Get instructions” button
3. Create a public/private key pair
    1. Navigate to the “API keys” section
    2. Click on the “Create keys” button
    3. Use the default “Generate API credentials” setting
    4. Name your API keys. Use a descriptive name, the name will be used to differentiate between multiple keys when you need to manage them in Integration Central. When naming the keys, you should consider who is using it and what they’re using it for
    5. Click on the “Create keys” button to create the public/private key pair
4. Store the private key and Public Key ID
    1. Creating the key pair will automatically download the private key (.pem) file to your browser, you do not need the public key. Save the private key file in a secure location, you will need it to access Amazon Pay APIs. You should never share your private key with anyone and this is the only time that you will be able to download the private key file. If you lose access to your private key, you must generate a new key pair

    2. Store your Public Key ID, you will need it to access Amazon Pay APIs. Unlike the private key file, you can return to this page at a later time to access your Public Key ID










