Skip to main content
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" : "SEK"
            , "Amount" : 124500
            , "Description" : "Invoice INV48388"
            , "Reference" : "INV48388"
            , "PaymentDate" : "2022-03-03T00:00:00.0Z"
            , "Scheme" : "autogiro"
        }'

​
Timelines

You can issue any payment or credit for Bankgirot 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.

​
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, Bankgirot 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.