Record a payment on an invoice

Records a payment — total or partial — on one of the account's invoices, identified by the invoice_id field of the body. An invoice that does not belong to the account is a 404.

The invoice may be in any state — drafts included. When the accumulated payments cover the invoice total, the invoice automatically transitions to paid, whatever its current state.

Send either amount or full: true. With full, the payment settles exactly the outstanding amount, computed when the request executes — use it to settle an invoice without racing other payments recorded between reading the outstanding amount and posting it.

On accounts with an active payment-reporting tax authority the corresponding fiscal report fires automatically. For DGFiP: a domestic French payment emits a CDV 212 lifecycle declaration; a cross-border or B2C payment creates an F10 payment tax report.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Account identifier (ID)

Body Params

The payment to record.

payment
object
required

A payment recorded on an invoice. Payments can be total or partial; an invoice may accumulate several. When the recorded payments cover the invoice total, the invoice automatically transitions to paid, whatever its current state. On accounts with an active payment-reporting tax authority (e.g. DGFiP), recording a payment automatically triggers the corresponding fiscal report.

Headers
string
Defaults to 2026-04-20

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration
B2Brouter UI Application -> Developers -> API Keys -> API Version

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json