Update Payment Status

Background Information

When you are a sender of sales invoices, you have to update the payment status of your sales invoices, this is a reporting to the PPF for B2B invoices via Flow 6.

Details :

Payment status is only updated when you have received the payment from the customer.
Goal is to update frequently, it starts from a trigger in your-system that the money is collected.
This applies to full payment of the invoice, or partial payment (with multiple payments). In case of payment in 2 or more steps, you report each payment and not just one global reporting in the end.
Does include the payment date (as stored by the seller).

General information page (all countries) https://docs.billit.be/docs/set-billit-payment-status-after-sending.

Applies to CreditNotes, not Invoices

For credit notes, no payment status is reported.

Some specific scenario's:

A credit note has been raised, amount to be paid for the linked invoice is reduced : report only the net amount that has been paid.
A credit note has been raised, linked invoice was already paid, amount paid for another invoice has been reduced : report the payment amount of the other invoice.

Report B2B Payments via the Payments Endpoint

One or more payments can be added to Billit once that the document is created in billit.

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. This text is not included in the PPF communication.
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": 0.40,
  "Description": "free text",
  "Date": "2026-07-14"
}

The result of the payment updates can also be viewed in the MyBillit user interface and the result can be gathered via API (more info : https://docs.billit.be/docs/communication-from-receiver-to-sender-pa)

What to do when amount of a Invoice has been refunded ?

When a payment has been refunded from seller to customer, then this will be reported too.

How this can be triggered ?

Via the MyBillit user interface : delete a payment:
Via the API : currently not possible, updates will be published when available.

Limitations, currently not supported for this API endpoint

Following elements are not supported:

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

When the invoice is prepaid

When the invoice is prepaid you have 2 options:

Method 1 : Post a payment of the full amount via POST /v1/order/{orderID}payments.
Method 2 : or Post the invoice and include the payment info in the invoice. Detailed info on https://docs.billit.be/docs/prepaid .

Alternative: set payment status to paid after Invoice receiving

when the full amount of the invoice is paid after issuing, then an alternative API variant is to use a patch.

More info : https://docs.billit.be/docs/set-billit-payment-status-after-sending , section : Update Global Payment Status via Patch.

Limitation : When the invoice is paid in multiple steps, then this is not so effective.

How payment status reporting is displayed in Billit UI and reported to PPF

Below example with 2 payments:

Each payment report of an invoice to the PPF (Fench Tax Authority) has a sequence, a timestamp and an amount: