Void Pending Transfer

POST /v1/transfers/{id}/void

Cancels a pending transfer. The held funds are released back to the debit account.

No request body required.

Response 200

{
  "data": {
    "tenant_id": "f714f6af-...",
    "transfer": {
      "id": "...",
      "pending_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "amount": 0,
      "status": "voided",
      ...
    }
  }
}

Headers

Authorization: Bearer qk_live_...
Idempotency-Key: <unique-string>

Errors

Code	Type	Meaning
409	not_pending	Transfer is not in pending state
409	already_voided	Already voided
409	already_posted	Already posted, cannot void
410	expired	Pending transfer timed out and was auto-voided