Overview

Amazon refreshed the Orders API v0 in early 2024, adding distinct identifiers for Pix, Boleto, and rewards‑based payments in the paymentMethodDetails field. The change replaces the previous generic “Other” label, giving sellers clearer insight into Brazilian and rewards transactions. Sellers who depend on order‑level data for reconciliation, reporting, or support must update their integrations to capture the new values.

Key Points

• New payment identifiers — Orders that previously appeared as “Other” now return “PIX”, “BOLETO”, or “REWARDS” in the paymentMethodDetails object, allowing direct classification.
• Brazil‑centric impact — The update mainly affects shipments to Brazil, where Pix and Boleto together account for the majority of online payments, so Brazilian‑focused sellers will see the most immediate benefit.
• Rewards clarity — Purchases that use Amazon Rewards points, either partially or fully, are now flagged with the REWARDS code, separating them from cash‑based sales for the first time.
• Backward‑compatibility note — Existing API endpoints remain functional, but any logic that treats “Other” as a catch‑all must be expanded to recognize the three new strings, or else it will miss or misclassify orders.
• Reporting enhancement — With explicit payment codes, sellers can segment dashboards, calculate payment‑method fees, and prepare tax filings with greater precision, especially for Brazilian tax regimes that treat Pix and Boleto differently.
• Implementation window — Amazon advises updating parsing logic within 30 days of the rollout; delays may cause mismatches between source data and downstream analytics or invoicing systems.

How the Updated Orders API v0 Works

1. Request the order — A seller issues GET /orders/v0/orders/{orderId}; the response now contains a paymentMethodDetails object that includes a paymentMethod key with a concrete value.

   • Example: A buyer in São Paulo completes checkout using Pix; the API response includes instead of the prior placeholder.