Logo
GoCardless API API Documentation

Create a Mandate

POST {{url}}/mandates

Please consider using the Billing Requests API instead of Mandates for any future integrations.

Creates a new mandate object.

Restricted: this endpoint is restricted to GoCardless Pro and GoCardless Enterprise accounts with approved payment pages.

Create a mandate API Docs

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 




RESPONSES

status Created

{ "mandates": { "id": "MD000ZS5BZ7YR8", "created_at": "2024-03-22T20:38:06.178Z", "reference": "QR9TV3T", "status": "pending_submission", "scheme": "bacs", "next_possible_charge_date": "2024-04-02", "payments_require_approval": false, "metadata": { "contract": "ABCD1234" }, "links": { "customer_bank_account": "BA000ZP5QZBAMM", "creditor": "CR00006C6DF0TD", "customer": "CU0014DQHSRWPC" }, "consent_parameters": null, "verified_at": null, "funds_settlement": "managed" } }



Curl
curl -X POST 'https://api-sandbox.gocardless.com/mandates' -d '{"mandates":{"scheme":"bacs","metadata":{"contract":"ABCD1234"},"links":{"customer_bank_account":"customer_bank_acct"}}}'

ENDPOINTS