This is a draft guide. Content is subject to change.

Get set up for integration

[Step 1 of 9] 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 exchange your public key for a PublicKeyId to access Amazon Pay APIs.


1. Register for Amazon Pay

Sign up for an Amazon Pay merchant account on the Amazon Pay website. After registration is complete, return to this page. Select the correct region for your account from below.


2. Create an Amazon Pay Sandbox buyer account

You will use Sandbox to conduct end-to-end tests of your integration before going live. For details, see Amazon Pay Sandbox accounts. After creating an Amazon Pay Sandbox account, return to this page.


3. 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 an SDK in your preferred language.

PHP: https://github.com/amzn/amazon-pay-api-sdk-php

.NET: https://github.com/amzn/amazon-pay-api-sdk-dotnet

Java: https://github.com/amzn/amazon-pay-api-sdk-java


4. Get your PublicKeyId

Amazon Pay uses asymmetric encryption to secure communication. Generate two keys: one public key and one private key. Exchange the public key for a publicKeyId to access Amazon Pay APIs.

1. Generate public and private key pair

Open Command Prompt or Terminal and use these commands to generate a public and private key pair:

openssl genrsa -out privateKey.pem 2048
openssl rsa -in privateKey.pem -pubout > publicKey.pub
        
You must install a shell program to generate the keys. Download Git Bash (or an equivilant emulation software) and use these commands to generate a public and private key pair:
          
openssl genrsa -out privateKey.pem 2048
openssl rsa -in privateKey.pem -pubout > publicKey.pub
          
        

2. Exchange the public key for a publicKeyId

Email the public key to your Amazon Pay account manager. They will respond with your publicKeyId. Never share your private key.


5. Complete set up with your acquirer

Make sure to complete all the steps needed to enable the integration and the payment option with your acquirer. Follow up with your acquirer contacts on the steps to be completed to enable Amazon Pay for your website.