Pay invoice
POST/v1/invoices/:id/pay
Two modes: (a) when payment_method is provided, creates a gateway payment (pix, bank_slip or card) and returns the method artifacts (QR code, barcode or card status) — or, with bank_transfer, a transfer charge to the organization bank account (bank_account_id) or Pix key (pix_key_id), with no gateway, returning the details in bank_transfer and staying pending until settled manually; (b) when omitted, marks the invoice as paid manually (reconciliation).
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Payment result or invoice marked as paid.
Request body failed validation.
Missing or invalid bearer token.
Token is valid but lacks permission for this operation. With code insufficient_scope, details.required carries the one minimal set of scopes that, added to details.granted, would let the request through: the resource scope (billing/{resource}, or billing/all off the catalogue) then the bare verb — e.g. ["billing/customers", "delete"].
Resource not found in the current organization.
Request body failed validation.
Rate limit exceeded.
Unexpected server error.