Confirm a settlement suggestion
POST/api/v1/payment_batches/:id/settlement/suggestions/:suggestion_id/confirm
Asserts that the bank operation settled the instruction. The pair is re-checked under lock with the suggestion controls (the batch's debit account, an outgoing operation, the same currency and exact amount, an operation no other instruction takes and no other invoice was reconciled against). The instruction's invoice is paid through the bank reconciliation - an existing reconciliation of that operation with that invoice is reused, never duplicated; an instruction paying no invoice is linked only. The instruction reads settled and the batch settles when every instruction did. Confirming the pair already confirmed answers the same 200.
Request
Responses
- 200
- 404
- 409
- 422
The instruction's settlement row, matched.
No payment batch with this id is reachable by the token's grants, or the suggestion is not one of this batch.
stale_version: the batch changed since the expected_version you sent. NOTHING WAS CONFIRMED; details carries the current version and batch. idempotency_key_reuse and idempotency_request_in_progress also answer 409, with no details.
validation_failed: the Idempotency-Key header is missing or expected_version is not an integer (details names the field); operation_failed: the pair is refused and message says why.