Payments are issued against a mandate. Use the following snippet to issue a payment.

curl -X POST https://api.debitdirect.io/merchants/agreements \
    -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.

2024 deadlines

monthdeadlineMastercard processingpayout
january23-01-202424-01-202402-2024
february21-02-202422-02-202403-2024
march19-03-202420-03-202404-2024
april22-04-202423-04-202405-2024
may23-05-202424-05-202406-2024
june20-06-202421-06-202407-2024
july23-07-202424-07-202408-2024
august22-08-202423-08-202409-2024
september22-09-202423-09-202410-2024
october23-10-202424-10-202411-2024
november21-11-202422-11-202412-2024
december17-12-202418-12-202401-2025
(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.

MandatesOverview