API Documentation

Payment Reference

Possible scenario's:

  • Billit Structured Payment Reference : When Posting an Invoice without Payment Reference in the API Json body, then the Billit generated Structured Payment Reference will be included.
  • Customer Structured Payment Reference : via the tag "PaymentReference" you can communicate your own structured Payment Reference (See example 1 below).
  • No Structured Payment Reference: You can fill the tag "PaymentReference" with another value, e.g. the Invoice Number (See example 2 below).
{

    "Order" : {
            "OrderType": "Invoice",
            "OrderDirection": "Income",
            "OrderNumber": "QS-29925", //Invoice Number
            "OrderDate": "2025-07-25",
            "ExpiryDate": "2025-08-30",
            "PaymentReference": "+++090/9337/55493+++", //If we want no OGM then you can insert invoice number 
            "OrderLines": 
                 {
   "Quantity": 3,
   "UnitPriceExcl": 5.00, 
   "Description": "Services",
   "VATPercentage": 0
   }   
            ],
            "Customer": {
              "Name": "Sercu Microdata",
              "VATNumber": "BE0446725877",
              "PartyType": "Customer",
              "Contact" : "Jean Dupont",
              "Email" : "[email protected]",
              "Phone" : "015/999999",
            }
    
}
{
    "TransportType" : "Peppol",
    "Order" : {
            "OrderType": "Invoice",
            "OrderDirection": "Income",
            "OrderNumber": "QS-29925", //Invoice Number
            "OrderDate": "2025-07-25",
            "ExpiryDate": "2025-08-30",
            "PaymentReference": "QS-29925", //If we want no OGM then you can insert invoice number 
            "OrderLines": 
                 {
   "Quantity": 3,
   "UnitPriceExcl": 5.00, 
   "Description": "Services",
   "VATPercentage": 0
   }   
            ],
            "Customer": {
              "Name": "Sercu Microdata",
              "VATNumber": "BE0446725877",
              "PartyType": "Customer",
              "Contact" : "Jean Dupont",
              "Email" : "[email protected]",
              "Phone" : "015/999999",
            }
    }
}