Update Payment Status

Background Information

When you are a sender, you have to update the payment status.

Details :

• payment status is only updated when you have received the payment from the customer
• You can update this immediately or with a delay (e.g. weekly operation)
• This applies to full payment of the invoice, or partial payment (with multiple payments)
• Does include the date the payment has been received

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

Sending Payment Information : 3 Scenario's :

Scenario's:

• Scenario 1 : the invoice is prepaid. The payment status is directly included in the API when posting
• Scenario 2 : the customer pays 100 % of the invoice
• Scenario 3 : the customer pays in 2 or more steps

Scenario 1 : the invoice is prepaid

While posting the invoice, the status Paid in included in the Json:

{
    "Order" : {
            "OrderNumber": "QS-202565987", 
            "OrderType": "Invoice",
            "OrderDirection": "Income",
            "OrderDate": "2026-05-28",
            "ExpiryDate": "2025-05-28",
    			  "Paid": true,
						"PaidDate": "2026-05-28T00:00:00",
            "OrderLines": [
            {
              "Quantity": 1,
              "UnitPriceExcl": 1.0,
              "Description": "my order line",
              "VATPercentage": 21.0
            }
            ],
            "Customer": {
              "Name": "TestCustomerName",
              "VATNumber": "BE0446725999",
              "PartyType": "Customer",
              "Email" : "[email protected]"
            }
    }
}

Scenario 2 : the Customer pays 100 % after Invoice receiving

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

Scenario 3 : the customer pays in 2 or more steps

More info : https://docs.billit.be/docs/set-billit-payment-status-after-sending , section : Adding Detailed Payment Information to an existing Invoice - payment in steps.