Who can do what
The business manages approval rights and beneficiaries in Broco. The software never chooses an account outside the authorized beneficiaries.
Statuses
All statuses except
awaiting_approval are final.
Wrong beneficiary
The approver sees the verified name of the supplier’s account before approving. Reject the payment if the supplier is not the expected one. A succeeded payment is a completed transfer between Broco accounts: contact Broco and the supplier to resolve an error.Timeouts and uncertain results
If a creation request times out, the payment may or may not exist. Do not prepare a new payment.1
Retry with the same key
Send the same request with the same
Idempotency-Key. Broco returns the existing payment if it was created.2
Or look up the invoice
List payments for the invoice with
GET /v1/supplier_payments?invoice_reference=INV-2026-0147.3
Act on the status
Wait for
awaiting_approval to resolve, or create a new payment with a new key only after a final status other than succeeded.Next steps
Supplier payments API
The supplier payment object and its operations.
Errors & retries
Error codes and retry rules.