Update Payment Information

Update Global Payment Status via Patch

The payment status of outgoing sales invoices can be set in Billit.

This is interesting when:

You use Billit for follow-up of your invoices. Payment status is then displayed in MyBillit, giving users additional information.
In certain countries sending payment information is mandatory (e.g. France)

The payment status can be patched :

Endpoint	Method	Response
/v1/order/{orderID}	PATCH	200 OK

Example of a Patch to set the Invoice to 100 % paid:

{ 
  "Paid": true,  //Alternative false
  "PaidDate": "2026-06-11T00:00:00",  //Must Include Date and Time
  "PaymentMethod" : "Wired", //Must be an allowed value
  "InternalInfo": "Paid on 11/06/2026",  // for additional information
}

Result of the Patch in the User Interface:

Adding Detailed Payment Information to an existing Invoice - payment in steps.

One or more payments can be added once that the document is created.

Endpoint	Method	Response
/v1/order/{orderID}/payments	POST	200 OK

Content in the message body:

Information Element	Mandatory/Optional	Extra Info
Amount	Mandatory	Amount must be positive
Description	Optional	Free text
Date	Optional	If not filled in, Billit will add the date of Posting of the Payment.

Example Json body when posting a payment:

POST https://api.sandbox.billit.be/v1/orders/2683999/payments

{
  "Amount": 10.02,
  "Description": "First test payment",
  "Date": "2026-06-03"
}

The result of the payment updates can also be viewed in the MyBillit user interface:

Not supported:

GET /v1/order/{orderID}/payments
Patch /v1/order/{orderID}/payments
GET v1/order/{orderID} does not contain the payment information