The Additional Payment Button (APB) is a variant of Amazon Pay checkout that has the below differences from the traditional checkout process:
A new parameter checkoutMode with value "ProcessOrder" needs to be passed in the request to differentiate it from the traditional checkout process.
Shipping address needs to be passed as part of the initial request for physical goods. For digital goods the information should not be sent, else the request will result in an error.
There is no step of rendering the review page. The payment is completed directly with Amazon post the initial request.
The Additional Payment Button supports only one time transactions.
Process flow
Using only the button to trigger a transaction.
Accept Amazon Pay with Additional Payment Button
Follow Step 1 to Step 5 and Step 10 as described in the traditional checkout flow. Below you can find more information about Step 6. Step 7 - Step 9 are not applicable for APB.
Step 6: Integrate to Paygate interface
Integrate your backend with Paygate interface to fetch the payload to be able to initialize the checkout session with Amazon. In order to integrate the Additional Payment Button into the interface, please use the following URL:
https://www.computop-paygate.com/amazonAPA.aspx
The request parameters are same as described in the traditional checkout process with some additional fields as described below.
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.
The following table describes the encrypted payment request parameters:
| Key | Format | CND | Description |
|---|---|---|---|
checkoutMode | an..12 | M | ProcessOrder – can be hardcoded for APB! Buyer will complete checkout on the Amazon Pay hosted page immediately after clicking on the Amazon Pay button. |
Shipping address | |||
Name | as..50 | M | First name and surname of address |
sdStreet | a..180 | M | Company name (if given) or street name and street number |
sdStreet2 | a..60 | O | Street name and house number |
sdAddressAddition | a..60 | O | Other additions |
sdCity | a..50 | M | Town/city in the delivery address |
sdDistrict | a..50 | O | District/County of delivery address |
sdState | a..50 | C | Federal state of delivery address. Not supported if countryCode is: 'UK', 'GB', 'SG', 'AE', 'MX' |
SDZipcode | a..50 | M | Postcode in the delivery address |
sdCountryCode | an2 | M | Country code of delivery country according to ISO 3166 |
sdPhone | a..128 | M | Phone number of addressee in the delivery address |
Additional parameters for integrating the Additional Payment Button