API Documentation

Direct Debit

Direct Debit / Domiciliëring / Automatisch Incasso

How to Use it

Direct debit is a payment method that allows a business or organization to automatically withdraw money from a customer's bank account, usually on a recurring basis.

It is supported when sending over Open/Peppol.

The following information must be communicated for a valid use:

Information ElementValueDescription
DefaultPaymentMethodTC"Domiciliation"Fixed Value
PaymentMethod"Domiciliation"Fixed Value
DomiciliationMandateIDExample : "100000101The ID that you have obtained for the mandate
DomiciliationMandateSigningDateExample : "2023-12-05"Date that the mandate was signed

Below an example of a Json body for an invoice to be posted with a direct debit.

{
	"OrderNumber": "458789574",
	"OrderDate": "2025-07-22",
	"ExpiryDate": "2025-08-30",
	"OrderType": "Invoice",
	"OrderDirection": "Income",
  "Currency": "EUR",
  "PaymentMethod": "Domiciliation",  // Fixed value to include when direct debit is used
	"Customer": {
		"Name": "TESTCUSTOMER",
		"Street": "Teststraat 31",
		"Zipcode": "BE-9000",
		"City": "GENT",
		"CountryCode": "BE",
		"Email": "[email protected]",
		"VatNumber": "BE043729999",
		"DefaultPaymentMethodTC": "Domiciliation",  //Fixed value when direct debit (België domiciliëring, NL Automatisch incasso)
		"DomiciliationMandateID": "100000101", //Mandate ID is mandatory information
		"DomiciliationMandateSigningDate": "2023-12-05"  // Include signing date when direct debit is used, is mandatory	
	},
	"OrderLines": [
		{
			"Reference": "GOD0014",
			"Quantity": 43.53,
			"UnitPriceExcl": 1.3044,
			"Description": "Product1",
			"Unit": "euro/l",
			"VATPercentage": 21.0,
		}
	]
}

What is the impact when direct debit is used

Example of a Payment Means segment in the UBL:

 <cac:PaymentMeans>
    <cbc:PaymentMeansCode>49</cbc:PaymentMeansCode>
    <cbc:PaymentID>This invoice is automatically collected by direct debit</cbc:PaymentID>
    <cac:PayeeFinancialAccount>
      <cbc:ID>BE13523081282439</cbc:ID>
      <cac:FinancialInstitutionBranch>
        <cbc:ID>TRIOBEBB</cbc:ID>
      </cac:FinancialInstitutionBranch>
    </cac:PayeeFinancialAccount>
    <cac:PaymentMandate>
      <cbc:ID>100000101</cbc:ID>
    </cac:PaymentMandate>
  </cac:PaymentMeans>

When a Billit generated PDF is included in the UBL, then the PDF includes a reference to the direct debit.

When using the MyBillit user interface, Direct debit is clearly marked: