Amazon Integration

How to enable crypto purchases of Amazon products using Headless Checkout

This guide explains how to integrate Amazon product purchases using the Headless Checkout API.

Product Locator Format

When creating an order for an Amazon product, use the productLocator parameter with either the Amazon ASIN or product URL:

// Amazon ASIN
{
    "lineItems": [
        {
            "productLocator": "amazon:B01DFKC2SO"
        }
    ]
}

// Amazon Product URL
{
    "lineItems": [
        {
            "productLocator": "amazon:https://www.amazon.com/dp/B01DFKC2SO"
        }
    ]
}

Example Flow

1

Create the order

• Specify the receipient’s email
• Specify their shipping information
• Specify the payment method used
• Specify the product locator

For a full list of supported currencies, refer to the supported currencies page.

POST /api/2022-06-09/orders
{
  "recipient": {
    "email": "[e-mail]",
    "physicalAddress": {
      "name": "John Doe",      // required
      "line1": "123 Main St",  // required
      "city": "San Francisco", // required
      "state": "CA",           // required for US addresses
      "postalCode": "94105",   // required
      "country": "US"          // required - only US is currently supported
    }
  },
  "payment": {
    "method": "ethereum-sepolia",
    "currency": "eth"
  },
  "lineItems": [
    {
      "productLocator": "amazon:B01DFKC2SO"
    }
  ]
}

2

Check order status

With all requied information provided, the order’s response will include payment preparation details, as shown below.

{
    "order": {
        "orderId": "...",
        "quote": {
            "status": "valid",
            ...
        },
        "payment": {
            "preparation": {
                ...  // Payment details will be present here
            }
        }
    }
}

Additional Information

• Monitor order statuses through the Developer Console
• Review the Order Lifecycle guide for detailed status handling
• Check this guide for details on supported currencies and payment methods