Create mandate

POST https://rcur.app/api/v2/customers/{customerId}/mandates

Path Parameters

Name	Type	Description
{customerId}*	String	The ID of the customer

Request Body

Name	Type	Description
consumer_name*	String	The name of the account holder
consumer_account*	String	The IBAN of the customer
custom_mandate_reference	String	A custom mandate reference. Leave it empty to let Mollie generate a unique reference

If you want to specify a custom mandate reference, make sure it is unique across all Mollie customers otherwise banks can reject the payments.

201: Created

{
    "id": "mdt_f8D2mMkVk",
    "method": "directdebit",
    "status": "valid",
    "custom_mandate_reference": null,
    "signature_date": "2024-03-27",
    "details": {
        "consumer_name": "John Doe",
        "consumer_account": "NL18RABO0123459876",
        "consumer_bic": "RABONL2U",
        "card_holder": null,
        "card_number": null,
        "card_expiry_date": null,
        "card_label": null,
        "card_fingerprint": null
    }
}

422: Unprocessable Entity

{
    "status": 422,
    "error": "Could not create mandate. Some fields contain invalid data",
    "fields": {
        "consumer_name": [
            "The consumer name field is required."
        ]
    }
}