DocumentationRecipesAPI ReferenceChangelog
Documentation

Convert existing transactions to card-on-file model

This guide is for merchant who currently manage their payment plan / subscription and yet to implement COF model.

Merchant want convert their existing manage payment to card-on-file model.

❗️

Only for merchant who send Merchant-Initiated Transaction


Why merchant require to perform

The reason is to perform existing transaction with MIT model, it will become not possible because of missing data schemePaymentID.

Below show scenario why existing transaction cannot perform as MIT.

New transaction (after implement COF)

existing transaction

  1. Merchant send CIT 1st transaction
  1. merchant send 1st transaction (without CIT)
  1. schemePaymentID will return to merchant
  1. schemePaymentID will is not return to merchant
  1. Merchant send MIT transaction with schemePaymentID
  1. Merchant is not able to send MIT transaction

What merchant required to do

Merchant can perform one time 0 amount CIT N3DS Authorisation to retrieve the schemePaymentID

📘

Important

  • It is still depend on acquirer bank to support this conversion. Please contact support team.
  • Initial 0 amount CIT N3DS Authorisation may notify cardholder, merchant required to inform their customer upfront.

Payment Token API

FieldsMerchants need to send
transactionInitiatorC: Customer Initiated Transaction
request3DSN : request non-3ds
storeCredentialsF: CIT First time payment
amount0

Payment Response (Backend)

Fields

Merchants need to handle

schemePaymentID

Payment id that is return from the scheme (eg. Visa/Master)

Merchant required to save this value to their application and used it for future payment.