Skip to main content

Verify Mandate

(conditional)

Introduction

Verify mandate

If you create an object with action.type = verify_otp, then you need to collect OTP from the customer and call this API in order to continue the process.

Test mode

In test mode, you can use 999999 to simulate a wrong OTP code.

Interface

POST /v1/mandates/:mandate_id/verify

Request Params

FieldNameTypeRangeExampleDefaultOptionalRemarkRule
otp_codeOTP Codestring[1, 64]required

Response Example

200 success:

{
"id": "mdt_b10ef5KqzHSOCCm9",
"object": "mandate",
"livemode": true,
"reference": null,
"payment_method": "dana_id",
"terminal_type": "web",
"customer_id": "cst_j9CivHDO4WfH0SqH",
"status": "success",
"time_signed": "2023-07-10T09:45:51+08:00",
"time_created": "2023-07-10T09:40:51+08:00",
"failure_message": "",
"failure_code": "",
"return_url": "http://merchant.com/return-url.html",
"metadata": {},
"extra": {},
"action": {
"type": "verify_otp"
}
}