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

Manage asynchronous processing

Some Amazon transactions are processed asynchronously, but only if specific conditions are met:

  • Payment authorization - canHandlePendingAuthorization parameter is set to true on Update Checkout Session or Create Charge
  • Payment capture - payment is captured more than 7 days after authorization
  • Refunds - all refunds are processed asynchronously

If a transaction is processed asynchronously, Amazon Pay will return an object in an initiated state until processing is complete. To determine if the operation was successful, you must either Set up Instant Payment Notifications, or implement a polling mechanism to query the respective GET API for updates.

If you plan on polling for updates, we recommend making a request once every hour. You can adjust the interval to meet your business requirements.