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:
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" ]
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.
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.
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.