The Mandate object
Description
Mangopay relies on the Mandate object to authorize automatic payments from a Bank Account object to a Wallet.
This payment method is often referred to as SDD (SEPA Direct Debit), but Mangopay also supports the BACS scheme for GBP payments.
This feature is only available under certain conditions. Contact the Support team Mangopay Hub for activation and setup.
Attributes
The scheme of the mandate, which is available once the mandate is submitted. The value can be one of the following:
- BACS – Covers payments in the UK, in GBP only.
- SEPA – Covers payments in the EU.
The unique identifier of the bank account.
Warning: The corresponding Bank Account must belong to the BACS network (GB-type Bank Account) or SEPA network (IBAN-type Bank Account).
The banking reference for the Mandate.
Returned values: One of the supported languages in the ISO 639-1 format: DE, EN, ES, FR, IT, NL, PL
The language in which the mandate confirmation page is to be displayed. This value only applies to mandates with the SEPA Scheme
.
The URL at which the mandate document can be downloaded.
Max. length: 220 characters
The URL to which the user is returned after the payment, whether the transaction is successful or not.
The URL to which to redirect the user to complete the payment.
Caution: This variable URL is specific to each payment. You must rely on the returned URL in full (host, path, and queries) and not hardcode any part of it.
The unique identifier of the object.
The date and time at which the object was created.
Returned values: CREATED
, SUBMITTED
, ACTIVE
, FAILED
, EXPIRED
The status of the mandate:
CREATED
– The Mandate object is created but not yet confirmed.SUBMITTED
– The Mandate object is confirmed; it has been sent to the end user’s bank and will be activated.ACTIVE
– The Mandate object is active, which means that it was accepted by the end user’s bank or successfully used to process a direct debit direct pay-in.FAILED
– The Mandate object has failed and is no longer available for payments.EXPIRED
– The Mandate object has expired and is no longer available for payments. Mandates expire after 24 months of inactivity.
The unique identifier of the User (natural or legal) who owns the bank account.
Returned values: WEB
The execution type of the mandate.
Max. length: 255 characters
Custom data that you can add to this object.
The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes.
The explanation of the result code.
Related resources
Was this page helpful?