Introduction

Asynchronous processing is now available for Amazon Pay Checkout Version 2. When a payment is processed asynchronously, it will be on Pending status until the processing is complete within the next  24 hours. To determine if the operation was successful, you must be able to process TransactionStatus Notifications.

It is advised to inform your buyer accordingly about the successful order placement, as well as about potentially pending payment. In the event of non-successful payment authorization (txaction either failed or cancelation) you should cancel the order and ask the buyer to checkout again using a different payment method

Benefits of asynchronous processing are lower decline rates as it gives more time for processing.

Conditions for asynchronous processing

The asynchronous processing is supported under specific conditions

  • you are able to handle Pending status of preauthorizations and adapt buyer  information accordingly in the end of checkout flow.
  • you will request an Amazon Payment to be processed asynchronously by using parameter add_paydata[processing_mode] = asynchronous 
  • payment is captured more than 7 days after authorization

API Requests

To request an asynchronous processing for Amazon Pay, you should use the below parameter in the preauthorization request and be prepared to receive the final status within 24 hours with TransactionStatus Notifications.

(pre)authorization request Parameters
add_paydata[processing_mode]
required
Fixed Value: asynchronous
To request an asynchronous processing for Amazon Pay, you should use the below parameter in the preauthorization request and be prepared to receive the final status within 24 hours with TransactionStatus Notifications.
Example (pre)authorization request
aid=12345 (your aid)
mid=23456 (your mid)
portalid=12345123 (your portalid)
key=abcdefghijklmn123456789 (your key)
amount=6413
api_version=3.10
clearingtype=wlt
wallettype=AMP
company=Amaze Me GmbH
country=DE
currency=EUR
email=alfred@amzing.org
encoding=UTF-8
firstname=Alfred
lastname=Amazing
mode=test
reference=REFERENCE123
request=preauthorization
salutation=Herr
shipping_city=München
shipping_company=Amaze Me GmbH
shipping_country=DE
shipping_firstname=Alfred
shipping_lastname=Amazing
shipping_street=Fraunhofer 2
shipping_zip=80939
street=streetname
successurl=https://your.shop.com/returnpage.php?status=success
backurl=https://your.shop.com/returnpage.php?status=back
errorurl=https://your.shop.com/returnpage.php?status=error city=Kiel telephonenumber=012345678
zip=01234
add_paydata[processing_mode] = asynchronous
Example response
status=REDIRECT
txid=12345678
userid=789654

Sequence Diagram

Pre-authorization - Asynchronous processing