Overview

Amazon is rolling out new fields to two Selling Partner APIs that supply payment information for Brazil‑based sales. Effective January 28 2025, the Shipment Invoicing API and the Orders API will return detailed payment attributes required by Brazil’s SEFAZ tax authority. Sellers who generate electronic invoices for Brazilian customers must adapt their systems now to avoid compliance gaps.

Key Points

• Launch date — The updated APIs become live on January 28 2025, giving sellers a three‑month window to modify integrations.
• Payment method granularity — Each transaction will now carry a specific method code (credit card, debit card, Pix, boleto, etc.), enabling precise tax classification.
• Acquirer CNPJ inclusion — Credit‑card and Pix payments will embed the CNPJ (Brazilian corporate tax ID) of the acquiring bank, a mandatory element for SEFAZ‑approved invoices.
• Card brand identification — The brand (Visa, Mastercard, Elo, etc.) used for a card payment will be reported, supporting detailed reconciliation and reporting.
• Authorization identifier (NSU) — A unique numeric string from the acquirer will accompany credit‑card and Pix transactions, creating an auditable link between Amazon orders and payment processor records.
• Transaction amount array — A new “payments” collection will break down each payment component, listing currency code and exact value, which is essential for orders with split or partial payments.

How the API Changes Work

1. Shipment Invoicing API – payments array added — When a seller queries getShipmentDetails for an FBA shipment, the response now contains a payments array.

   • Example: For a shipment that includes a Pix payment of R$ 150.00, the array entry will show paymentType: "Pix", paymentCnpj: "12.345.678/0001-90", amount: {currencyCode: "BRL", value: "150.00"}, and authorizationId: "1234567890".