Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.debitdirect.io/llms.txt

Use this file to discover all available pages before exploring further.

Payments are issued against a mandate. Use the following snippet to issue a payment. 
curl -X POST https://api.debitdirect.io/payments \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Basic XXXXXXXXXXXX' \
    -d '{
            "Mandate" : "md_xxxxxxxxxxxxxxxx"
            , "Currency" : "DKK"
            , "Amount" : 124500
            , "Description" : "Invoice INV48388"
            , "Reference" : "INV48388"
            , "PaymentDate" : "2022-03-03T00:00:00.0Z"
            , "Scheme" : "nets-bs"
        }'

​
Timelines

You can issue any payment or credit for Betalingservice up to the day before the monthly deadline. If you issue a payment after the monthly deadline, the payment will be handled in the next coming payment window. See the tables below for deadlines, Mastercard processing dates and payout months. Official deadlines are published here: Betalingsservice deadlines.
monthdeadlineMastercard processingpayout
january22-01-202623-01-202602-2026
february19-02-202620-02-202603-2026
march23-03-202624-03-202604-2026
april22-04-202623-04-202605-2026
may20-05-202621-05-202606-2026
june22-06-202623-06-202607-2026
july23-07-202624-07-202608-2026
august21-08-202624-08-202609-2026
september22-09-202623-09-202610-2026
october22-10-202623-10-202611-2026
november20-11-202623-11-202612-2026
december18-12-202621-12-202601-2027
(dd-mm-yyyy) format

​
Stages

Payments change stage as they are processed in Debitdirect.
1

Pending schedule

When created a payment status is marked pending (value = 0)
2

Scheduled for processing

When the payment is scheduled for scheme processing, status is marked scheduled (value = 16).
3

Completed succesfully

If a payment is processed succesfully, the payment is marked settled (value = 8).
4

Completed with fault

If a payment is not processed succesfully, the payment is marked rejected (value = 64).
Some schemes allow the end-user to dispute the payment. In this case, Mastercard Payment Services may issue a charge back. In this case, the payment status is set to chargeback (value = 256) and a webhoook is sent.

​
Testing

When issuing payments against a test mandate, the payment is marked a test payment and will not be sent to the scheme.