All direct debit mandates related paths
/users/{user_id}/payments/mandates
List mandates
sort
string
Field of resource to sort by
order
string
Sort order of the result list if the sort
parameter is specified. Use ASC
for ascending or DESC
for descending sort order.
limit
int
Use the limit
argument to specify the maximum number of items returned.
offset
int
Use the offset
argument to specify where in the list of results to start when returning items for a particular query.
Mandates list
{
"meta": {
"offset": 0,
"limit": 100,
"count": 1,
"total_count": 1,
"sort": "id",
"order": "ASC"
},
"data": [
{
"id": "9c5a7dea-46f2-4502-b6b5-9902a53860e4",
"created_at": "2020-08-24T14:15:22Z",
"user_id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
"iban": "DE8900**********0000",
"bic": "ABCDEXXX",
"creditor_name": "Creditor Company",
"creditor_id": "DE98ZZZ09999999999",
"creditor_address": {
"address_line1": "Strasse 1",
"address_line2": "Company GmbH",
"postcode": "12345",
"city": "Berlin",
"state": "BE",
"country": "DE"
},
"type": "RECURRENT",
"confirmed_at": "2021-12-08T08:38:48.021Z"
}
]
}
/payments/mandates
Create a mandate
user_id
string
User unique identifier.
iban
string
required
International Bank Account Number IBAN.
bic
string
required
Business Identifier Code (also known as SWIFT-BIC, BIC, SWIFT ID or SWIFT code) ISO 9362.
confirmed_at
string
required
Timestamp of when user validated the mandate
{
"user_id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
"iban": "DE89000000000000000000",
"bic": "ABCDEXXX",
"confirmed_at": "2021-12-08T08:38:48.021Z"
}
Mandate
{
"id": "9c5a7dea-46f2-4502-b6b5-9902a53860e4",
"created_at": "2020-08-24T14:15:22Z",
"user_id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
"iban": "DE8900**********0000",
"bic": "ABCDEXXX",
"creditor_name": "Creditor Company",
"creditor_id": "DE98ZZZ09999999999",
"creditor_address": {
"address_line1": "Strasse 1",
"address_line2": "Company GmbH",
"postcode": "12345",
"city": "Berlin",
"state": "BE",
"country": "DE"
},
"type": "RECURRENT",
"confirmed_at": "2021-12-08T08:38:48.021Z"
}
/payments/mandates/{mandate_id}
Retrieve a direct debit mandate
mandate_id
string
required
Direct Debit Mandate unique identifier.
Mandate
{
"id": "9c5a7dea-46f2-4502-b6b5-9902a53860e4",
"created_at": "2020-08-24T14:15:22Z",
"user_id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
"iban": "DE8900**********0000",
"bic": "ABCDEXXX",
"creditor_name": "Creditor Company",
"creditor_id": "DE98ZZZ09999999999",
"creditor_address": {
"address_line1": "Strasse 1",
"address_line2": "Company GmbH",
"postcode": "12345",
"city": "Berlin",
"state": "BE",
"country": "DE"
},
"type": "RECURRENT",
"confirmed_at": "2021-12-08T08:38:48.021Z"
}
/payments/mandates/{mandate_id}
Delete mandate
mandate_id
string
required
Direct Debit Mandate unique identifier.
Request has been processed successfully.
Empty response
Was this page helpful?