Idempotency-Key header. Send one and a retry after a timeout returns the first result instead of creating a second business, account, recipient or payout.
The header is required, not optional. A call without it is rejected before anything is created.
Where it applies
On all four the key is a UUID. Anything else is rejected before the call reaches the resource.- Create a user
- Create a virtual account
- Create a payout
- Create a recipient
What a key does
Generate a fresh key per operation you intend to perform — not per retry.- Same key, same body — you get the original result back. Nothing new is created.
- Same key, different body —
409. Nothing is created. Send a new key for a new operation, or resend the exact original body to get the first result. - Same key, first call still running — also
409. Wait, then retry with the same key and the same body. If the first call succeeded, the retry returns its result. - A key whose first call succeeded, however long ago — still tied to that result. Reusing it never creates a new one.