Skip to main content
Release type: Enhancement (Backward-compatible) Applies to: Collection Accounts — Collects, Refunds

​
Summary

Collects that fail and need their funds returned now move to two new statuses, reversal_initiated and reversed. Tazapay initiates the return as a refund, and the collect moves to reversed once that refund succeeds.

​
What’s new

  • Two new collect statuses: reversal_initiated and reversed.
  • Two new webhook events: collect.reversal_initiated and collect.reversed, both on by default.
  • Two valid status paths: failed → reversal_initiated → reversed, and failed → reversed. reversal_initiated is optional.
  • Subscribe to collect.reversed to know when the funds are back with the source.
  • Stablecoin refunds now include a tracking_details object with the on-chain details of the refund transfer.
  1. Collect State Machine
  2. Collect Webhooks
  3. Reversals
  4. Refunds
  5. Quickstart: reversal note and production checklist