Skip to main content

Mandate

Object

NameTypeMandatoryDescription
classstringYThe type of object which is being returned. In this case it will be mandate
statusstringYThe status of the mandate. See statuses.
currencystringYThe currency (ISO-4217).
end_reasonstringNReason why the mandate has ended.
start_datestringNThe date when the mandate was authorized by the customer.
end_datestringNThe date when the mandate ended.
authentification_3dsobjectYThe 3ds authentication details. See authentication 3ds object. This will be null until the payment has been processed.

Mandate statuses

StatusFinalDescription
ACTIVENThe mandate is active which means the token can be used to process new payments.
FAILEDYThe mandate is failed and cannot be used to make further payments.
CANCELLEDYThe mandate has been manually canceled and cannot be used to make further payments.
ENDEDYThe mandate has ended and cannot be used to make further payments.
EXPIREDYThe mandate is expired and cannot be used to make further payments.
ERRORYAn error occured whilst trying to create the mandate.
TIMED_OUTYThe token has been cancelled because no card details were provided before the accept_until parameter date.
NOT_REQUESTEDNThe mandate was not requested, therefore it was not created.

Example

{
"class":"mandate",
"status":"ACTIVE",
"currency":"EUR",
"end_reason":null,
"start_date":1423755674,
"end_date":null
}