Update a payment

Updates the payment's own fields (amount, date, payment method, reference).

The invoice link is immutable — invoice_id in the body is ignored. full is only accepted when creating a payment — sending it here answers 422 with code parameter_not_allowed. A payment already declared to a tax authority cannot be updated — the request answers 422 with the lock reason.

An amount change re-evaluates the invoice: when the accumulated payments now cover its total, the invoice automatically transitions to paid, whatever its current state. Lowering an amount never reverts a paid invoice.

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

ID of the payment to update.

Body Params

The payment fields to update.

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