Initiate a refund for a funds recovery
Initiates a refund for a funds recovery in the ANALYSED state, within the scope of the participant determined by the authenticated tenant. The recovery changes to REFUNDING, and the updated recovery is returned with HTTP 200. Returns 404 when no active recovery with that ID belongs to the participant and 409 when its current state does not allow a refund. The response is a concise funds recovery representation.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Client-generated key used to retry exactly the same request safely.
1 - 64Best-effort business correlation id (observability only; never fabricated).
"7c9e6679742540de944be07fc1f90ae7"
Path Parameters
Funds recovery internal ID (UUID format)
"018f8c1d-1234-7abc-9def-000000000001"
Response
OK
"9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f"
"2026-05-17T13:30:00Z"
"018f8c1d-1234-7abc-9def-000000000001"
"12345678"
"E12345678202605171530aB3xK9mWq2z"
SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, UNKNOWN "SCAM"
CREATED, TRACKED, AWAITING_ANALYSIS, ANALYSED, REFUNDING, COMPLETED, CANCELLED "REFUNDING"
"7c9e6679742540de944be07fc1f90ae7"
"Victim of a WhatsApp scam"

