In order to collect money via direct debits, you have to fulfil a few prerequisits. First of all a creditor identifier is required. You can get one from the Deutsche Bundesbank. Moreover, each direct debit requires a unique mandate id and a valid mandate signature. If not, the box will reject your order.
Request:
curl -XPOST /direct_debits \
-H 'Accept: ' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer " \
-d '{
"account": "DE02700205000007808005",
"name": "Recipient name",
"iban": "Recipient iban",
"bic": "Recipient bic",
"amount_in_cents": 12345,
"reference": "Message for your customer's statement"
"mandate_id": "unique id presented to customer",
"mandate_signature_date": "2016-05-01"
}'
Response:
{
"message": "Direct debit has been initiated successfully."
}
This is the most basic direct debit. The box also supports recurring direct debits and special forms like CD1 and B2B.