Amazon Pay and Login with Amazon integration guide

Order workflow

This is a standard order transaction flow for physical goods:

  1. When the address widget is shown to the buyer, an Order Reference is created.
  2. The buyer chooses a payment method from the wallet widget, and you calculate the total order amount.
  3. The buyer places the order, and you Set the purchase details and Confirm the Order Reference.
  4. You submit a request to Authorize the order amount against the selected payment method.
  5. If the Authorization is successful, the order can be shipped.
  6. You ship the order.
  7. You submit a request to Capture the funds from the Authorized amount, and then close the Order Reference after a successful Capture.

During the transaction, payment objects are created to support the Amazon Pay payments process:

Payment object

Description

Order Reference

A record of key attributes necessary to process the buyer's payment. It tracks how the buyer wants to pay, where to ship, and how much to pay. It also contains information about the order like the total amount and your order identifier.

Authorization

Represents the availability of funds in the selected payment method and reserves them for future collection using a Capture request.

Capture

Represents the movement of funds from the buyer's payment method to your Amazon Pay merchant account.

Refund

In the event of a refund, represents the movement of previously captured funds back to the buyer's account.

Each of these objects has a status that reflects the status of the order during the transaction flow. The following graphic shows the various actions in the flow and their related objects:


Copyright © 2009-2017 Amazon.com, Inc. or its affiliates. Amazon and Amazon.com are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.