Reconcile a transaction as a transfer
POST/financial-transactions/:id/reconcile-as-transfer
Makes the open line one leg of a transfer: paired with the destination's open line of the opposite direction and same amount, up to 3 days apart, or else the other leg is created in the destination account. Never two new legs. Requires scope finance/reconciliations with access level write, and the token owner's transfers.create permission.
Request​
Responses​
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
The line is a transfer leg; the Location header points at GET /transfers/{transfer_id}.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance/reconciliations scope or the write access level, or the person cannot create transfers.
The transaction or the destination account was not found within the tenant.
The line is not open (details.reason: line_not_open): already reconciled, or not a bank movement — a zero amount, a balance adjustment, an imported opening balance — or an idempotency key was reused with another body.
The destination is the same account, has no company, is a credit card's (card_account_transfer), or the chosen pair does not match (pair_mismatch).
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.