Amazon v2 is the recommended version. It uses the SP-API directly via HTTP, returns real-time data, and includes complete buyer information and additional endpoints not available in v1.
About Amazon v2
Amazon v2 makes direct HTTP calls to the Amazon SP-API REST endpoints (bypassing the SDK) and operates synchronously:
- Products — Retrieved via the Listings API (
/listings/2021-08-01/items/{sellerId}). Real-time, paginated withnextToken. - Fulfillments — Created via the Shipment Confirmation API (
POST /orders/v0/orders/{orderId}/shipmentConfirmation). Synchronous. Apackage.idcan be included and must be saved to enable future fulfillment updates — Amazon does not expose an endpoint to retrieve it later. - Customer data — Complete, using Restricted Data Tokens (RDT) to access buyer info and shipping addresses.
- Webhooks — Uses Amazon's native SQS-based Notifications API, more reliable than v1.
Exclusive to v2
- Allowed carriers endpoint (
GET /services/allowed) — required to get validcompanyIdvalues for fulfillments - Update fulfillment status (
PUT /orders/{orderId}/fulfillments/{fulfillmentId}) - Inventory update by location (
PUT /locations/{locationID}/inventories/{itemId})
Not available in v2
- Cancel fulfillment (use v1 if this is required)
The version is selected at the integration level via ecommerceSettings.version_api — it cannot be changed per request.
For step-by-step instructions on how to configure the version, see the Amazon API Version Setup guide.