What’s new
We’ve introduced a new intermediate collect state and corresponding webhook event to provide earlier visibility into stablecoin payment progress while blockchain confirmation is still pending. Updated state flow for Crypto Wallets:collect.on_hold → collect.detected → collect.succeeded or collect.failed
New Collect State + Webhook Event
collect.detected
| Field | Value |
|---|---|
| State | detected |
| Webhook event | collect.detected |
- Triggered when an inbound transaction is first detected on-chain, prior to final confirmation.
- Provides early visibility while confirmations are pending.
- Default subscription: ON
Why we made this change
Blockchain confirmations can take a few minutes depending on network conditions. This intermediate state and event improve visibility during that window without changing the final settlement timing.Backward compatibility
This enhancement is non-breaking:- Existing merchants who do not consume the new states/events will continue receiving final outcomes normally.
collect.succeededandcollect.failedsemantics remain unchanged.
What hasn’t changed
- Final confirmation timing remains the same
- Funds are credited only after full blockchain confirmation
- No impact on balances, payouts, or settlement behavior