Refund a failed deposit by id
Transfer the funds from a failed deposit back to a caller-provided address on the same chain, addressing the deposit by the stable id returned by GET /deposits. Authenticate with an x-api-key (write scope) or a Bearer platform token. Scoped to the caller’s tenant: an unknown id and another tenant’s id are both a 404. The deposit must be failed or rejected; operator-only states (ignored, delayed) are refundable through the admin endpoint only.
Headers
API key for authentication (omit when sending Authorization)
"your-api-key"
Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.
"Bearer eyJhbGciOi..."
Path Parameters
Deposit id. Returned by GET /deposits.
^\d+$"12345"
Body
Address to receive the refunded tokens (EVM address or Solana public key).
1"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"