Key points of this lesson, in order.
Card-on-File and Tokenization for Recurring
What you will learn
Your objective. By the end of this lesson, you will be able to explain card-on-file and tokenization for recurring. A card-on-file transaction is any transaction that uses payment credentials a merchant stored from an earlier transaction.
Why it matters. From a business analyst perspective, card-on-file design means documenting several connected requirements.
Chapter objective: Learner designs recurring payments, including mandates, merchant-initiated transactions, and 3RI flows, and explains authentication, consent, and failure handling for repeat charges. Learner applies this skill in realistic banking scenarios, with clear examples and correct terminology throughout.
Key learning points
- Card-on-file transaction
- Tokenization replaces the real card number
- Credential-on-file rules from Visa and Mastercard
- Transaction identifier
- BA specifies the consent screen
- Merchant stores a network token
Key terms
Authorisation: Approval by the issuer for a card transaction to proceed, confirming the card is valid and funds or credit are available.
Interchange: A fee paid by the acquirer to the issuer for each card transaction, set by the card scheme. It compensates the issuer for handling the transaction, funding the interest free period and managing fraud...
Gateway: A service that connects a merchant website or app to payment networks and acquirers. It encrypts card data, routes authorisation requests, and returns the result to the merchant.
Payment flow diagram showing Card-on-File and Tokenization for Recurring.
Practise this lesson
Exercise
Trace the card payment in this lesson through authorisation, clearing and settlement.
Use the four-party model and the stage timings in this lesson.
- What to do. State what happens at each stage, who pays whom, and when the merchant is actually credited.
Correct result. Authorisation holds the funds and returns a response code. Clearing sends the transaction in a batch file. Settlement moves the net amount between banks, and the acquirer credits the merchant after deducting interchange, scheme fees and its margin.
Why. A card payment is not one event. The customer sees it on Monday, the merchant gets it on Wednesday, and the difference is the clearing and settlement cycle.
Check your understanding
Practice question
Which of the following best describes card-on-file and tokenization for recurring?
Takeaway and next step
What to remember
If the customer cancels the instalment plan, the merchant must delete the token and stop charging.
Follow 2,000 rupees through every stage, from instruction to beneficiary credit, and note where it can stop.
Open the Payment Lifecycle Simulator →
Builds on "Recurring Payment Failure Handling".
Transcript and full text
Show transcript
A card-on-file transaction is any transaction that uses payment credentials a merchant stored from an earlier transaction. The first transaction is called the initial credential-on-file transaction, and it must be initiated by the cardholder and fully authenticated. Every later transaction is a merchant initiated transaction that references the first one. The card schemes require the merchant to send specific indicators with each transaction, including a flag that says the credential is stored, a transaction identifier that links back to the original payment, and the type of transaction, such as recurring, instalment, or unscheduled. If these indicators are missing or wrong, the issuer may treat the payment as a new cardholder transaction and decline it. Tokenization replaces the real card number with a surrogate value called a token, and it is the standard way to store credentials safely. There are two main kinds of token. A gateway token is issued by the payment service provider and only works with that provider. A network token is issued by Visa or Mastercard themselves and works across the whole payment network. Network tokens are more powerful because the card scheme updates them automatically when the underlying card changes, and issuers trust them more, which leads to higher authorisation rates. The BA should recommend network tokens wherever the gateway supports them, and document the token lifecycle including provisioning, suspension, and deletion. The credential-on-file rules from Visa and Mastercard are detailed, and they exist to protect cardholders from unexpected charges. The merchant must get explicit consent from the cardholder before storing the credential, and must tell the cardholder the amount or the billing rule, the frequency, and how to cancel. The merchant must send a notification before each charge, or at least make the schedule visible in the customer account. The merchant must also store the scheme reference identifier from the original transaction and send it with every later transaction. These rules are enforced by the schemes, and merchants that break them can face fines and higher interchange fees. The transaction identifier chain is the technical detail that makes credential-on-file work. When the first transaction is processed, the scheme returns a transaction identifier, and the merchant stores it alongside the token. Every later merchant initiated transaction includes that identifier, which lets the issuer trace the payment back to the original customer consent. If the merchant loses this identifier, for example during a migration between payment providers, the later transactions lose their link to the consent and authorisation rates fall. A BA working on a payment provider migration must treat the preservation of these identifiers as a critical data migration requirement, and must test it before the cutover. From a business analyst perspective, card-on-file design means documenting several connected requirements. The BA specifies the consent screen, including the exact wording of the mandate terms. The BA specifies the token vault, including which token type is used and how tokens are stored. The BA specifies the transaction indicators for each payment type, and the mapping of decline codes to retry actions. The BA also specifies the customer controls, such as the ability to view, update, and delete stored cards, and the audit trail that shows when consent was given. Together these requirements form the stored credential design, and they are the first thing a scheme auditor will ask to see. For example, a customer buys a household appliance for 2,000 rupees and agrees to pay the rest in monthly instalments of 2,000 rupees. The merchant stores a network token for the card, together with the scheme reference identifier from the first payment. Each month, the merchant sends an instalment transaction with the token and the reference identifier, so the issuer can trace the charge back to the original consent. If the customer cancels the instalment plan, the merchant must delete the token and stop charging.
A card-on-file transaction is any transaction that uses payment credentials a merchant stored from an earlier transaction. The first transaction is called the initial credential-on-file transaction, and it must be initiated by the cardholder and fully authenticated. Every later transaction is a merchant initiated transaction that references the first one. The card schemes require the merchant to send specific indicators with each transaction, including a flag that says the credential is stored, a transaction identifier that links back to the original payment, and the type of transaction, such as recurring, instalment, or unscheduled. If these indicators are missing or wrong, the issuer may treat the payment as a new cardholder transaction and decline it.
Tokenization replaces the real card number with a surrogate value called a token, and it is the standard way to store credentials safely. There are two main kinds of token. A gateway token is issued by the payment service provider and only works with that provider. A network token is issued by Visa or Mastercard themselves and works across the whole payment network. Network tokens are more powerful because the card scheme updates them automatically when the underlying card changes, and issuers trust them more, which leads to higher authorisation rates. The BA should recommend network tokens wherever the gateway supports them, and document the token lifecycle including provisioning, suspension, and deletion.
The credential-on-file rules from Visa and Mastercard are detailed, and they exist to protect cardholders from unexpected charges. The merchant must get explicit consent from the cardholder before storing the credential, and must tell the cardholder the amount or the billing rule, the frequency, and how to cancel. The merchant must send a notification before each charge, or at least make the schedule visible in the customer account. The merchant must also store the scheme reference identifier from the original transaction and send it with every later transaction. These rules are enforced by the schemes, and merchants that break them can face fines and higher interchange fees.
The transaction identifier chain is the technical detail that makes credential-on-file work. When the first transaction is processed, the scheme returns a transaction identifier, and the merchant stores it alongside the token. Every later merchant initiated transaction includes that identifier, which lets the issuer trace the payment back to the original customer consent. If the merchant loses this identifier, for example during a migration between payment providers, the later transactions lose their link to the consent and authorisation rates fall. A BA working on a payment provider migration must treat the preservation of these identifiers as a critical data migration requirement, and must test it before the cutover.
From a business analyst perspective, card-on-file design means documenting several connected requirements. The BA specifies the consent screen, including the exact wording of the mandate terms. The BA specifies the token vault, including which token type is used and how tokens are stored. The BA specifies the transaction indicators for each payment type, and the mapping of decline codes to retry actions. The BA also specifies the customer controls, such as the ability to view, update, and delete stored cards, and the audit trail that shows when consent was given. Together these requirements form the stored credential design, and they are the first thing a scheme auditor will ask to see.
For example, a customer buys a household appliance for 2,000 rupees and agrees to pay the rest in monthly instalments of 2,000 rupees. The merchant stores a network token for the card, together with the scheme reference identifier from the first payment. Each month, the merchant sends an instalment transaction with the token and the reference identifier, so the issuer can trace the charge back to the original consent. If the customer cancels the instalment plan, the merchant must delete the token and stop charging.
Full lesson text (all scenes)
Completing a lesson updates your progress dashboard on the homepage.
Scene timestamps are estimated by allocating the narration text proportionally across the real audio length. The audio playback position is the source of truth: pause freezes the visual, seeking restores the correct scene, replay restarts the scene animation.