Post Pending Transfer

POST /v1/transfers/{id}/post

Finalizes a pending transfer. The held funds move from the debit account to the credit account.

Request

{
  "amount": 50000
}

Field	Required	Description
amount	No	Post a partial amount. If omitted, posts the full pending amount.

Partial posting is useful when the final amount differs from the hold. For example, a restaurant hold for $50 that settles at $45.

Response 200

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

The pending_id references the original pending transfer.

Errors

Code	Type	Meaning
409	not_pending	Transfer is not in pending state
409	already_posted	Already posted
410	expired	Pending transfer timed out