Card Enrolment

Covers how to generate an agreement ID for recurring transactions that can be passed to Mastercard.

The Card enrolment process will involve the following steps:

  1. Generate an OAauth token to authenticate the requests.
  2. Initiate a checkout request for which the transaction will be authorized for.
  3. Enrol card transaction using 3DS where under the encrypted SourceOfFunds field you will pass the field storedOnFile with value TO_BE_STORED as described here for 3Ds charging.
  4. The agreementID will be sent on the redirect payload that the merchant gives us as a query parameter called agreementID example of redirect id: https://www.url.com/?agreementID=xxxxxxxxxxxxxxxxxxxxxxxxxx>
  5. The agreementID will be sent also on the callback URL under the payments array as part of the payerNarration JSON string:
    Example of the PayerNarration string is "{\"statusDescription\":\"Transaction was successful\",\"statusCode\":200,\"agreementID\":\"36477388829929\"}"
  6. Query for the agreementID generated by the acquirer/issuing bank.
  7. You can now initiate a charge without 3Ds or a charge token without 3Ds request with the agreementID field given back above.