Deactivate a Treasury beneficiary
Treasury resource management
Deactivate a Treasury beneficiary
Deactivates a beneficiary for new payouts without deleting its identity or payout history.
POST
Deactivate a Treasury beneficiary
What this endpoint does
Deactivates a beneficiary for new payouts without deleting its identity or payout history.When to use it
Use it when a recipient should no longer be selectable, such as after destination details change.Before you call
Use a secret API key withtreasury:write and pass an active beneficiary ID owned by this tenant account.
Money and balance effect
This changes a resource or configuration but does not directly reserve, debit, credit, or settle wallet money.States and completion
Deactivation blocks new payout use. Existing accepted or historical payouts keep their original beneficiary snapshot and continue through their real lifecycle.Safe retries
Send a uniqueIdempotency-Key for the logical action. If the response is lost, retry the same payload with the same key; never create a new key merely because the first response timed out.
Read Beneficiaries and payouts for the complete workflow.Authorizations
Send the same Wayex API key as Authorization: Bearer <key>.
Headers
A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.
Required string length:
8 - 255Path Parameters
Response
200 - application/json
- Option 1
- Option 2
Minimum string length:
1Minimum string length:
1Minimum string length:
1Available options:
active, inactive Available options:
individual Minimum string length:
1Minimum string length:
1Minimum string length:
1
