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

Verify checkout info

[Step 5 of 9] The buyer is redirected to the checkoutResultReturnUrl you specified in the Checkout Session, after processing on Amazon Pay side is completed. Verify that the status of the Checkout Session object is Open after the buyer comes back from Amazon Pay Processing page.


1. Verify Checkout Session state

Call Get Checkout Session to verify that the Checkout Session is in the Open state. See Checkout Session state explanation’ table below for more info.

Checkout Session state explanation

Checkout Session State
Description
Open
Checkout was confirmed, but payment is not completed yet. You should:

1. Proceed to execute the payment processing part of the checkout, interacting with your acquirer.
Canceled
Checkout was not successful. The buyer either canceled checkout or was unable to provide a valid payment instrument. See Checkout Session canceled state reason code for more info.

The buyer can no longer complete checkout using the same Checkout Session ID. You should:

1. Redirect the buyer to the start of checkout.
2. Display a message such as: "Your payment was not successful. Please try another payment method.“
3. Create a new Checkout Session if the buyer clicks on the Amazon Pay button again.

Request

curl "https://pay-api.amazon.com/:environment/:version/checkoutSessions/:checkoutSessionId"
-X GET
-H "x-amz-pay-authorization: Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"

Request parameters

Name
Location
Description
CheckoutSessionId
(required)

Type: string
Path Parameter
Checkout session identifier

Response

{
  checkoutSessionId: "bd504926-f659-4ad7-a1a9-9a747aaf5275",
  statusDetail:{
    state: "Open",
    reasonCode: "",
    reasonDescription: "",
    lastUpdatedTimestamp: "20190714T155300Z" 
  },
  creationTimestamp: "20190714T155300Z",
  chargePermissionId: "chargePermissionId-1",
  amazonPayToken: "497268187623AMZN"     // only present when charge is performed by acquirer, and after buyer returns from Amazon Pay Processing Page.
}

2. Retrieve the amazonPayToken

Parsing the Get Checkout Session API response, retrieve the amazonPayToken provided after the buyer returns from the Amazon Pay Processing page.

The amazonPayToken is returned only if the buyer successfully goes through the Amazon Pay Processing page, and represents the unique identifier needed to process the payment with your acquirer, as explained in the following section of the integration guide.

Best practice: Make sure that the checkoutResultReturnUrl being passed in the Checkout Session is pointing to the location on your website in which the payment processing happens. Once the customer returns from the Amazon Pay Processing page, the transaction should be processed with the acquirer, as described in the next step of the guide.