Configuration for Amazon Pay

There are two options that can be used depending if you are a new or an existing customer.

Existing Customers

Already existing customers need to login to their accounts and create a new set of API keys to be used with Amazon Pay Checkout version.2.

We already have the needed data for your accounts done for the original checkout v.1.

Please see below the "Guide to create API keys".

New Customer

Before using Amazon Pay you need to register at https://pay.amazon.de/signup  

An alternative is also the signup for Amazon based on country, the steps are the;

• follow the above URL
• choose the country needed, based on the country flag found at the top-right:

When logged in in the Amazon seller central, you should have 2 accounts, that you can toggle between:

• Sandbox
• Production

The needed data for the onboarding are the following:

• If you have more than one market this information needs to be given to us for each market needed.

Please follow the guide below to create the API keys necessary.

Important: If you don´t see the option to create the API keys, you need to create a store first and then create the API keys.

Under the "Integration central" at the bottom you can do this using the link found there:

MWS Authorization Token

One of the important piece of data needed is the MWS Authorization token from Amazon which gives

The second step is generating a MWS Auth Token. This is the data needed:

• Developer name: Computop Ltd
  
• Developer account number: 8662-2365-9858

Guide

When logged in to the seller central of Amazon, go to the top right-hand side of the page and click on Settings and choose "User Permissions":

This leads you to the "User permissions" page which show you the current users, here you can add an external developer to your account, here please click on "Visit manage your apps":

This leads you to a new page were you can see developers that have access, here you can add, delete and renew permissions. Please click on "Authorise new developer":

On the new page you need to add the developer name and ID given above. Fill in the information and click on "Next":

The last page is were you need to agree to the terms and conditions of granting a developer access to the account.

When clicking on "Next", you are shown a success page with information:

With the last click on "Next", you are led back to the original "User Permission" were the developer is now shown:

Here you can now click on "View" and access the "MWS Authorization token" and can also copy it.

Then submit the received MWS Authorisation Token on a secure way to

Guide to create API keys

In order to create new API keys, choose one of your accounts, either Production or Sandbox on top of the page, process needs to be done for both accounts. Amazon description is found here.

Please click left-hand side on the symbol with the 3 horizontal lines. 

On the menu that appears, please go to "Integration" and choose "Integration central". 

On the Integration central, go to the section "Create API Keys" and click on the button there. 

A Pop-up window appears where you need to choose "Generate API Credentials", here you also need to give the keys a unique name: 

The newly created keys are immediately visible on the "Integration central". There you choose the option to "See Details": 

When looking at the details, you can see the data or download the data in JSON format: 

JSON example:

Important: 

• This data is needed for your onboarding and needs to be sent in a secure way to

  Multiexcerpt include
  SpaceWithExcerpt EN MultiExcerptName Helpdesk-Name PageWithExcerpt Wording

  for configuration.
• The same process needs to be repeated for the second account depending on which one you did first

Notify URL

Customers will need to also to store/configure the following

URL: 

Go to the menu on the te top left-hand side:

On the menu that appears, please go to "Integration" and choose "MWD Access Key":

At the bottom of the page you can see the option for IPN (Instant Payment notification":

After clicking on the blue link another pages open with integration settings: 

Here please click on the "Edit"-button: 

1. Here please add the fowllowing URL to the integrator URL and click on the "Update"-button

      2. The merchant can also save his own notify URL if he so wishes.

Important: Please make sure to use the Notifies sent via server to server and not only rely on the SuccessURLs/FailureURLs.

Steps within the process

The basic payment process with Amazon consists of several steps:

Important

Please make sure that you plan in the 2 main tasks for merchants:

1. Add the new Amazon Cv.2 Button (Step 1)
2. On the redirect back to the shop (Step 23) were changes may take place, merchant needs to make sure that address (if applicable) and payment method, can be changed. Also the possibility of changes to the amount should be pass with a call to the

   Multiexcerpt include
   SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

Integrate Amazon Pay button

The following example code shows how to integrate the Amazon Pay button in your webshop.

When customer submits this button, you will call

var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {

   merchantId: 'xxxxx',
   publicKeyId: 'SANDBOX-xxxxxxxxxx', 
   ledgerCurrency: 'EUR',          
   checkoutLanguage: 'en_GB', 
   productType: 'PayAndShip', 
   placement: 'Cart',
   buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
  const [payload, signature, publicKeyId] = your_call_to_paygate();
  
  amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
      payloadJSON: payload,
      signature: signature,
      publicKeyId: publicKeyId
    }
  });
});

In this case the following parameters must be present within the Button:

Further information can be found in the documentation from Amazon Pay.

Review Page

Process flow chart

• Version with possibly changes done to delivery address, payment instrument or amount.
  
• Valid for OTP (One time payments) or for Recurring setup (RTF=I)

Recurring Subsequent

Subsequent actions

Capture a payment

Credit a payment

Reverse an order

Multiexcerpt include
SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

interface

Initialize Amazon Pay interface

In order to initialize a payment with Amazon Pay, please use the following URL:

Encrypted parameters for initializing an Amazon Pay payment

Intermediate response with button additional parameters

Response parameters after initializing an Amazon Pay payment

The following example code shows the updated and complete Amazon Pay button, which will redirect the client to Amazon.

<div id="AmazonPayButton"></div>
<script src="https://static-na.payments-amazon.com/checkout.js"></script>
<script type="text/javascript" charset="utf-8">
var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {
merchantId: 'xxxxx',
ledgerCurrency: 'EUR',          
checkoutLanguage: 'en_GB', 
productType: 'PayAndShip', 
placement: 'Cart',
buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
// Here you need to call your shop server, which creates the initial Call towards Paygate
// and then returns the required data payloadJSON, signature, publicKeyId from the response
var buttonData = getSignedButtonData()

amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
    payloadJSON: buttonData.payloadJSON,
    signature: buttonData.signature,
    publicKeyId: buttonData.publicKeyId
    }
});
</script>

Intermediate response with customer information to your ShopUrl

Response parameters after initializing an Amazon Pay payment

Amazon Pay capture a payment

In order to capture an authorized payment with Amazon Pay, please use the following URL:

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Encrypted parameters for capturing an authorized Amazon Pay payment

Response parameters after capturing an authorized Amazon Pay payment

After a capture you get a notify to your specified URLNotify with following parameters:

Response parameters to URLNotify after capturing an authorized Amazon Pay payment

Amazon Pay credit a payment

In order to credit a captured payment with Amazon Pay, please use the following URL:

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Encrypted parameters for crediting an Amazon Pay payment

Response parameters after crediting an authorized Amazon Pay payment

After a credit you get a notify to your specified URLNotify with following parameters:

Response parameters to URLNotify after credit of an Amazon Pay payment

Amazon Pay reverse an order

In order to reverse a complete order with Amazon Pay with the function „CancelOrderReference“, please use the following URL:

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Encrypted parameters for reversal of an Amazon Pay payment

Response parameters after reversing an Amazon Pay payment