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.

Pending schedule

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

Scheduled for processing

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

Completed succesfully

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

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.

Mandates Software Partners

​Timelines

​Stages

​Testing

Timelines

Stages

Testing