Update Payment Information

Adding Payment Information to an existing Invoice


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

EndpointMethodResponse
/v1/order/{orderID}/paymentsPOST200 OK

Content in the message body:

Information ElementMandatory/OptionalExtra Info
AmountMandatoryAmount must be positive
DescriptionOptionalFree text
DateOptionalIf not filled in, Billit will add the date of Posting of the Payment.

Not supported:

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

Example Json body when posting a payment:

{
  "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:


Update other Payment Info via Patch

Some users find in interesting to set the payment status of outgoing sales invoices in the MyBillit user interface.

This is interesting when:

  • Payment is monitored in your financial software
  • You use the MyBillit user interface for follow-up of your invoices. Payment status is then displayed in MyBillit, giving users additional information.

Patch Command

EndpointMethodResponse
/v1/order/{orderID}PATCH200 OK

Example of a Patch:

{
    "InternalInfo": "test2",
    "ApprovalStatus": "Approved",  //Alternative Rejected
    "Paid": true,  //Alternative false
    "PaidDate": "2026-06-03T00:00:00",  //Must Include Time
    "PaymentMethod" : "Visa" //Must be an allowed value
}