Amazon SP-API Finances Update: New Status Tracks When Deferred Funds Are Released
In June 2024 Amazon added a new transaction status DEFERRED_RELEASED to the SP‑API Finances endpoint (v2024‑06‑19). The status appears in the transactionStatus field when a previously held fund is released, giving sellers immediate visibility of the release event across all marketplaces.
Overview
Amazon has added a new transaction status called DEFERRED_RELEASED to the Selling Partner API (SP‑API) Finances endpoint. The update, released in June 2024, lets sellers and developers know the exact moment a previously held fund is released. This visibility removes a long‑standing blind spot in cash‑flow tracking and simplifies financial reconciliation across all Amazon marketplaces.
Key Points
- New status value —
DEFERRED_RELEASEDappears in thetransactionStatusfield to signal that a deferred amount is now payable. - Full lifecycle insight — Sellers can differentiate between “deferred” (funds on hold) and “deferred released” (hold lifted) without consulting separate reports.
- Global coverage — The status is active on every Amazon marketplace that supports the Finances API version v2024‑06‑19.
- Additive change — Existing integrations keep working; the new enum is simply added to the list of possible responses.
- Developer action required — Code that filters or validates transaction statuses should be updated to recognize the new value.
- Operational benefit — Automated pipelines can now treat the release of held funds as a terminal event, enabling more accurate cash‑flow forecasts.
How the New Status Works
- Transaction enters deferment — When Amazon places a hold on a seller’s payout (e.g., during a policy review), the API returns
DEFERREDin thetransactionStatusfield. For example, a $250 shipment from a new seller in the US marketplace will showDEFERREDuntil the review completes. - Hold is lifted — Once Amazon resolves the issue, the same transaction record is updated and the
transactionStatuschanges toDEFERRED_RELEASED. In the previous example, the $250 will now appear withDEFERRED_RELEASEDon the day the funds become available.
Analysis & Recommendations
Why This Matters
The DEFERRED_RELEASED status lets sellers treat fund releases as a terminal event, enabling automated cash‑flow forecasts and eliminating manual cross‑checking of Seller Central. For example, a $250 deferred payout in the US can be flagged as available the moment the status changes, improving inventory purchasing decisions.
Key Takeaways
- New enum value DEFERRED_RELEASED added to the transactionStatus field.
- Status is active globally on all marketplaces supporting Finances API version v2024‑06‑19.
- DEFERRED_RELEASED marks a terminal event, allowing pipelines to move records to completed without extra checks.
- Developers must update any code that filters or validates transaction statuses to recognize DEFERRED_RELEASED.
Recommended Actions
- →Update your SP‑API integration: locate the transactionStatus validation logic (e.g., in your finance API handler) and add DEFERRED_RELEASED to the ...
- →Set up an alert: in your monitoring tool or Seller Central, create a rule that triggers an email or Slack notification when GetFinancialEvents retu...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!