Frontend Customisation

Support for Progressive Web Apps/Headless Commerce/Single Page Applications

The module exposes the REST endpoints that needs to set up. You can find them here. The front-end needs to be setup by the merchant/developer.

Notes on the Checkout Session API

The Checkout Session API exposes a number of endpoints to manage active Amazon checkout sessions associated with an active cart in a Magento store. Available endpoints include functionality such as retrieving configuration information used to generate an Amazon Pay button, retrieving shipping addresses associated with an Amazon account, and updating a checkout session by setting payment/shipping/billing information, etc.

The following flowchart illustrates the sequence in which these calls may be made through a normal shopping/checkout flow:

_images/api_calls.png

Checkout Session Config

Values returned from this endpoint will be needed to generate the Sign In with Amazon and Amazon Pay buttons. The format of this response will be:

    [
      "merchantId",
      "ledgerCurrency",
      "buttonColor",
      "checkoutLanguage",
      "productType",
      "sandbox",
      "loginPayload",
      "loginSignature",
      "checkoutPayload",
      "checkoutSignature",
      "payNowPayload",
      "payNowSignature",
      "publicKeyId"
    ]

Note

The value for productType returned in the response will be a boolean value indicating whether the product is PayOnly; true for PayOnly, false for PayAndShip.

For a detailed explanation on how to use these values to generate:

Shipping and Payment Information

The Shipping Address, Payment Descriptor, and Billing Address endpoints are used to retrieve order summary information to display upon checkout review. Shipping and payment method updates can be enabled to allow the user to choose a different shipping address or payment instrument before placing an order.

Note

The value for shippingAddress should be null for PayOnly product types. Similarly, billingAddress should only be populated in EU or for PayOnly product types.

For recommended best practices regarding displaying this information, see Display shipping and payment info (Best Practice).

For a guide on enabling shipping and payment information updates at checkout review, see Enable shipping and payment updates.

Swagger Documentation

Detailed documentation on available endpoints, their usage, and request/response bodies can be found here.