Create Customer Mandate

POST https://api.payssion.com/v2/customers/{customer_id}/mandates

Request Params

terminal_type

Same as terminal_type

Response Params

action.type

Same as payment.action

extra

extra.payment_method_account

In some cases, such as e-wallet payment method, the consumer's wallet account information would be returned.

Field	Remark
reference	Consumer's account ID (maybe phone number/email/login id etc.)
name	Consumer's name
balance_amount	Consumer's balance amount
balance_currency	Consumer's balance currency

Example:

JSON

"extra": {
  "payment_method_account": {
      "reference": "consumer***@gmail.com",
      "name": null,
      "balance_amount": null,
      "balance_currency": null
  }
}

For each payment method, payment_method_account return includes:

payment method	reference	name	balance_amount & balance_currency
alipay_cn	e.g. abc***@someprovider.com	NA	NA
dana_id	phone number, e.g. 62-857****6606	NA	NA
shopeepay_id	NA	NA	NA
ovo_id	phone number, e.g. +6281888XXXX	NA	returned
rabbitlinepay_th	e.g. ***นันท์	NA	NA
truemoney_th	e.g. +66*****5353	NA	NA
kakaopay_kr	e.g. mo****[e-mail]	NA	NA
card_ru	e.g. 220015******4603	NA	NA
...	...	...	...

📘

Best Practices

Multiple mandates can be created per customer for each payment method (maximum of 5), but it is not recommended to create repeated mandates on the business initiation side, as long as the mandate is still active, it can always be used for debiting.

Before create payment and subscription through mandate, it is recommended to do enough guidance to allow consumers to recharge enough debit amount to reduce the debit failure rate.