User Experience and Implementation Recommendations

Enabling Subscription Manager on Banking Applications

Enabling Subscription Management Capabilities on Banking Applications

Clients can create a frictionless and consistent recurring payment or subscription management mobile experience for cardholders using the Visa Subscription Manager APIs. 

Visa Subscription Manager allows cardholders to monitor and manage recurring payments directly, reducing the need to contact cardholder support for help. Cardholders can view merchants that have their card on file and stop unwanted recurring payments using their banking application anytime, allowing them to instantly address payment issues and saving them time and energy.  

This page provides UX recommendations and best practices, and technical implementation guidance to help clients develop an optimal user experience for cardholders.

An optimal user experience allows cardholders to 

  • Monitor their recurring payments, promoting transparency into their finances. 
  • More easily manage their account and control everyday transactions, including subscription payments

 

Recommendations, best practices and examples are illustrative only, non-comprehensive and any implementation requires client's independent legal and business analysis.

TECHNICAL GUIDANCE

The below user experience diagram shows how clients can use VSM APIs to create an optimal user experience for their cardholders. It is recommended that clients provide cardholders with multiple paths to manage recurring payments within their mobile application.

  1. If the cardholder selects a particular recurring transaction from their 'recent transctions' list, they could be given the option to pause or stop future transactions
  2. Clients may create a dedicated space for subscription payments. This space can provide a comprehensive view of all card-on-file recurring payments and the option to manage those payments.
  3. Clients may build in-house notifications to notify cardholders of upcoming payments, transaction amount changes etc., and lead cardholders to manage those payments. Note: Visa APIs do not provide notifications. Clients would need to use a combination of information provided by VSM APIs, and internal data sources to create these notifications.

 

Userflow of how a cardholder can access VSM on an issuer's web/mobile application

BUILDING AN OPTIMAL USER EXPERIENCE

This section provides UX and technical recommendations on building a mobile user experience that provides cardholders transparency and control over managing their subscription payments. 

Stop payments for an active subscription/service/membership

stop payment user flow

View all screens seen in this user flow here

Technical Specifications and User Experience Recommendations corresponding to each screen shown in the prorotype is provided to help simplify implementation.

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

 

STOP PAYMENT - HOME SCREEN

Tech Specs

Test Screen.png

​​​

1 Blue.png

Account Home fields will be dynamically populated by issuers using internal data sources. 
Go to new page.png Please review the VSPS API reference for 
sample API requests and responses
UX Recommendations
1 Yellow.png Use key customer touch points, such as the Welcome screen, to alert cardholders to new features available to manage their finances – e.g., use a “New Card Benefits” promo​ to introduce cardholders to VSPS.
2 Yellow.png Provide cardholders an easy way to get more information about new services – e.g., link to a “Learn More” popup with more information about VSPS benefits to help drive enrollment.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

STOP PAYMENT - ACCOUNT DETAILS

Offer multiple entry points for cardholders to access account management tools.

Tech Specs

Account details.png

1 Blue.png Recent transactions are assumed to be available to the issuer internally.
Go to new page.png Please review the VSPS API reference for 
sample API requests and response
UX Recommendations
1 Yellow.png Offer multiple entry points for cardholders to access account management tools.
2 Yellow.png If the Account Details screen is the cardholder’s first interaction with recurring payments, include a “Learn More” link to provide an easy way to get answers to their questions about the feature to encourage engagement.

STOP PAYMENT - RECURRING PAYMENT

Tech Specs

Recurring payments - active.png

​​​

1 Blue.png

To distinguish between Active and Stopped payments, use

URL: /vsps/search


Field: "stopInstructionType": "MERCHANT"

2 Blue.png

​​​

To get a list COF merchants where the PAN is used for recurring or installment type payments, use


URL: /cofds-web/v1/datainfo
Field: mrchName
Field: tranType (SCHEDULED_RECURRING, UNSCHEDULED_RECURRING, INSTALLMENT, BILL_PAY),
Field: ConfidenceInd
Consult your Visa representative to confirm ConfidenceInd

3 Blue.png

To get last payment date, use


URL:/cofds-web/v1/datainfo

Field: lastTranDateTime


To get payment frequency, use

Field: totalTranCount for last 13 months

Tips.png Tip: Filter out stopped transactions (returned by the Search API) from the COF Data Service API to get a list of merchants to be displayed under the ‘Active’ section of the screen. If Search API does not return merchant name for a stop instruction, get the corresponding merchant name returned by the COF API for the same CAID.
Go to new page.png Please review the VSPS API reference for 
sample API requests and responses
UX Recommendations
1 Yellow.png “Learn more” aids cardholders in understanding how this feature can help them gain more visibility and control over their finances and encourage enrollment.
2 Yellow.png Clearly communicate the status of subscriptions so cardholders can easily distinguish between active and stopped subscriptions.

STOP PAYMENT - TRANSACTION DETAILS

 

Tech Specs

Retailer details.png

​​​

​​​

1 Blue.png

To get other recurring payments at the retailer, use


URL:cofds-web/v1/datainfo/merchants

Field: rawMrchName

Retreive the Merchant Reference Id (Field: mrchRef) from the
URL:/cofds-web/v1/datainfo

and provide that as input (query parameter) in

URL:cofds-web/v1/datainfo/merchants
Do not cache the merchant ref ID. It is dynamic.

2 Blue.png

​​​

To get transaction amount, use


URL: cofds-web/v1/datainfo/merchants


Field: lastTranAmtBillCurrency

3 Blue.png

To stop all recurring payments under a retailer, get merchant identifiers for each sub retailer


URL: cofds-web/v1/datainfo/merchants


Then call the Add merchant API to stop all recurring payments for the retailer.
URL: /vsps/add/merchant

Go to new page.png Please review the VSPS API reference for sample API requests and responses
UX Recommendations
1 Yellow.png Have clear call outs for any action that the user needs to take to manage their payments.
Issuer could use any additional space on the page to display any merchant offers or benefits. Offer or benefit related info is not provided by VSM APIs.

STOP PAYMENT - PAYMENT DETAILS

Tech Specs

Payment Details.png

​​​

​​​

1 Blue.png

Merchant logos are to be sourced internally by the issuer.
2 Blue.png To get the payment status and determine if the payment is active / paused use
URL: /vsps/search
Include the PAN
If the response doesn't include the transaction being displayed, then the status can be assumed to be 'active'. This API returns all transactions that have been stopped on a PAN.
Go to new page.png Please review the VSPS API reference for sample API requests and responses
UX Recommendations
1 Yellow.png Include a “Learn More” link to provide an easy way to get answers to their questions about each of the options.
2 Yellow.png Clearly call out all all options available to the cardholder to manage payments. Also include additional information related to each of these options so cardholders clearly understand what each option will result in.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

STOP PAYMENT - T&C

 

Tech Specs

Stop Payment TC.png

​​​

​​​

1 Blue.png

All legal and information text to be hosted internally by the issuer.
2 Blue.png

To place a stop instruction (R1) use
URL: /vsps/add/merchant


Ensure field "oneTimeStop" = False

Use merchant identifiers returned by
URL: cofds-web/v1/datainfo/merchants
Field: rawMrchName, lastCardAcceptorId

Tips.png

​​​

Tip: If PFID/SMID is avaialble in URL: /cofds-web/v1/datainfo it is best practice to create a stop instruction on the PFID+SMID. Note: Both PFID and SMID are required. IF PFID and SMID are not availabel, create stop instructions with both merchant name and CAID.
Go to new page.png Please review the VSPS API reference for sample API requests and responses
UX Recommendations
1 Yellow.png

Clearly communicate that stopping recurring charges will only stop future charges​ to set cardholder expectations about how the feature works and reduce inquiries to the call center and customer dissatisfaction. 


Ensure cardholders understand that they should contact the merchant first to ensure the service / subscription is canceled or their payment concerns are addressed.

STOP PAYMENT - CONFIRMATION

Tech Specs

10 - STOP PAYMENT.png

​​​

​​​

1 Blue.png

Once the Add Merchant API call is placed, a 200 or 400 response is returned along with stop instruction ID and details. A 200 response will also include the status of the request, which includes success (00), partial success (01) or fail (02).
Go to new page.png Please review the VSPS API reference for sample success and error responses.
UX Recommendations
1 Yellow.png Clearly communicate all settings associated with a stop​ to ensure cardholders understand and agree to the stop payment terms and reduce cardholder support inquiries.

Create default stop settings for your organization. Providing too many customized options can overcomplicate the user flow and increase API calls if a cardholder sets a duration that is not long enough to block the recurring payment.
yellow Tip.png Tip: The default stop payment is 13 months. A good rule of thumb is to set the stop payment duration for monthly payments to 6 months and for yearly payments to 13 months.

yellow Tip.png

Tip: Use the auto cancel and auto extend features to ensure better customer experience and cost reduction.

 

Process Flow Description

1

Cardholder logs in to their banking application and selects the option to view subscription payments.

2

Client triggers the VSM Merchant Aggregation API passing the PAN in the request.

3

Visa responds with data of all merchants with card on file transactions in the with the last 13 month. 

4

Client displays the subscription payment data to the cardholder.

5

Cardholder selects a particular transaction.

6

Client triggers the VSM Merchant Details API. 
7 Visa responds with last transaction details (including raw merchant name) for each merchant subscription.
8 Client displays the list of transactions to the cardholder on the banking application.
9 Cardholder chooses to pause or stop payments.
10 Client triggers the VSM Add Merchant API.
11 Visa processes the request and responds with the status of the request.
12 Client displays the status of the request on the banking application

Pause payments for an active subscription/service/membership

pause payment user flow

View all screens seen in this user flow here

Technical Specifications and User Experience Recommendations corresponding to each screen shown in the prorotype is provided to help simplify implementation.

 

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

 

 

PAUSE PAYMENT - HOME SCREEN

Tech Specs

Test Screen.png

​​​

1 Blue.png

Account Home fields will be dynamically populated by issuers using internal data sources. 
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Use key customer touch points, such as the Welcome screen, to alert cardholders to new features available to manage their finances – e.g., use a “New Card Benefits” promo​ to introduce cardholders to VSPS.
2 Yellow.png Provide cardholders an easy way to get more information about new services – e.g., link to a “Learn More” popup with more information about VSPS benefits to help drive enrollment.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

PAUSE PAYMENT - ACCOUNT DETAILS

Tech Specs

Account details.png

​​​

1 Blue.png

Recent transactions are assumed to be available to the issuer internally.
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Offer multiple entry points for cardholders to access account management tools.
2 Yellow.png If the Account Details screen is the cardholder’s first interaction with recurring payments, include a “Learn More” link to provide an easy way to get answers to their questions about the feature to encourage engagement.

PAUSE PAYMENT - RECURRING PAYMENTS

Tech Specs

Recurring payments - active.png

​​​

1 Blue.png

To distinguish between Active and Paused payments, use


URL: /vsps/search


Field: "stopInstructionType": "MERCHANT"

2 Blue.png

​​​

To get a list COF merchants where the PAN is used for recurring or installment type payments, use


URL: /cofds-web/v1/datainfo
Field: mrchName
Field: tranType )SCHEDULED_RECURRING, UNSCHEDULED_RECURRING, INSTALLMENT, BILL_PAY),
Field: ConfidenceInd

Consult your Visa representative to confirm ConfidenceInd

3 Blue.png

To get last payment date, use


URL:/cofds-web/v1/datainfo

Field: lastTranDateTime


 

Tips.png Tip: Filter out stopped transactions (returned by the Search API) from the COF Data Service API to get a list of merchants to be displayed under the ‘Active’ section of the screen. If Search API does not return merchant name for a stop instruction, get the corresponding merchant name returned by the COF API for the same CAID.
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png “Learn more” aids cardholders in understanding how this feature can help them gain more visibility and control over their finances and encourage enrollment.
2 Yellow.png Clearly communicate the status of subscriptions so cardholders can easily distinguish between active and stopped subscriptions.

PAUSE PAYMENT - TRANSACTION DETAILS

Tech Specs

Retailer details.png

​​​

​​​

1 Blue.png

To get other recurring payments at the retailer, use

URL:cofds-web/v1/datainfo/merchants

Field: rawMrchName

Retreive the Merchant Reference Id (Field: mrchRef) from the
URL:/cofds-web/v1/datainfo
and provide that as input (query parameter) in
URL:cofds-web/v1/datainfo/merchants
Do not cache the merchant ref ID. It is dynamic.

2 Blue.png

​​​

To get transaction amount, use

URL: cofds-web/v1/datainfo/merchants

Field: lastTranAmtBillCurrency
 
3 Blue.png

To stop all recurring payments under a retailer, get merchant identifiers for each sub retailer
URL: cofds-web/v1/datainfo/merchants


Then call the Add merchant API to stop all recurring payments for the retailer.
URL: /vsps/add/merchant

Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Have clear call outs for any action that the user needs to take to manage their payments.

yellow Tip.png

​​​

Providing merchant contact information will encourage issuers to contact the merchant to report problems prior to stopping or pausing the payment.

Issuer could use any additional space on the page to display any merchant offers or benefits. Offer or benefit related info is not provided by VSM APIs.

PAUSE PAYMENT - PAYMENT DETAILS

Tech Specs

Payment Details.png

​​​

​​​

1 Blue.png

Merchant logos are to be sourced internally by the issuer.
2 Blue.png To get the payment status and determine if the payment is active / paused use
URL: /vsps/search
Include the PAN
If the response doesn't include the transaction being displayed, then the status can be assumed to be 'active'. This API returns all transactions that have been stopped on a PAN.
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Include a “Learn More” link to provide an easy way to get answers to their questions about each of the options.
2 Yellow.png Clearly call out all all options available to the cardholder to manage payments. Also include additional information related to each of these options so cardholders clearly understand what each option will result in.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

PAUSE PAYMENT - T&C

Tech Specs

Pause Payment TC.png

​​​

​​​

1 Blue.png

All legal and information text to be hosted internally by the issuer.
2 Blue.png

To place a stop instruction (R1) use
URL: /vsps/add/merchant


Ensure field "oneTimeStop" = True

Use merchant identifiers returned by
URL: cofds-web/v1/datainfo/merchants
Field: rawMrchName, lastCardAcceptorId

Tips.png Tip: If PFID/SMID are available in URL: /cofds-web/v1/datainfo, it is best practice to create a stop instruction on the PFID+SMID. Note: Both PFID and SMID are required. IF PFID and SMID are not available, create stop instructions with both merchant name and CAID.
Tips.png valign="top">

Tip: Best practice to add stops on merchant and CAID if PFID/SMID are not available.

Go to new page.png Please review the VSPS API reference for
sample API requests and responses.
UX Recommendations
1 Yellow.png

Clearly communicate that stopping recurring charges will only stop future charges​ to set cardholder expectations about how the feature works and reduce inquiries to the call center and customer dissatisfaction. 


Ensure cardholders understand that they should contact the merchant first to ensure the service / subscription is canceled or their payment concerns are addressed.

PAUSE PAYMENT - CONFIRMATION

Tech Specs

7 - PAUSE PAYMENT.png

​​​

​​​

1 Blue.png

Once the Add Merchant API call is placed, a 200 or 400 response is returned along with stop instruction ID and details. A 200 response will also include the status of the request, which includes success (00), partial success (01) or fail (02).
Go to new page.png Please review the VSPS API reference for sample success and error responses.
UX Recommendations
1 Yellow.png Clearly communicate all settings associated with a stop​ to ensure cardholders understand and agree to the stop payment terms and reduce cardholder support inquiries.

Create default stop settings for your organization. Providing too many customized options can overcomplicate the user flow and increase API calls if a cardholder sets a duration that is not long enough to block the recurring payment.
yellow Tip.png Tip: The default stop payment is 13 months. A good rule of thumb is to set the stop payment duration for monthly payments to 6 months and for yearly payments to 13 months.

yellow Tip.png

Tip: Use the auto cancel and auto extend features to ensure better customer experience and cost reduction.
vsm

#

Process Flow Description

1

Cardholder logs in to their banking application and selects the option to view subscription payments.

2

Client triggers the VSM Merchant Aggregation API passing the PAN in the request.

3

Visa responds with data of all merchants with card on file transactions in the with the last 13 month. 

4

Client displays the subscription payment data to the cardholder.

5

Cardholder selects a particular transaction.

6

Client triggers the VSM Merchant Details API. 
7 Visa responds with last transaction details (including raw merchant name) for each merchant subscription.
8 Client displays the list of transactions to the cardholder on the banking application.
9 Cardholder chooses to pause or stop payments.
10 Client triggers the VSM Add Merchant API.
11 Visa processes the request and responds with the status of the request.
12 Client displays the status of the request on the banking application

 


Restart payments for stopped subscription

Restart payment userflow

View all screens seen in this user flow here

Technical Specifications and User Experience Recommendations corresponding to each screen shown in the prototype is provided to help simplify implementation.

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

 

RESTART PAYMENT - HOME SCREEN

Tech Specs

1 - Home Screen-test.png

​​​

​​​

1 Blue.png

Account Home fields will be dynamically populated by issuers using internal data sources. 
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Use key customer touch points, such as the Welcome screen, to alert cardholders to new features available to manage their finances – e.g., use a “New Card Benefits” promo​ to introduce cardholders to VSPS.
2 Yellow.png Provide cardholders an easy way to get more information about new services – e.g., link to a “Learn More” popup with more information about VSPS benefits to help drive enrollment.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

RESTART PAYMENT - ACCOUNT DETAILS

Tech Specs

Account details.png

​​​

1 Blue.png

Recent transactions are assumed to be available to the issuer internally.
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Offer multiple entry points for cardholders to access account management tools.
2 Yellow.png If the Account Details screen is the cardholder’s first interaction with recurring payments, include a “Learn More” link to provide an easy way to get answers to their questions about the feature to encourage engagement.

RESTART PAYMENT - RECURRENT PAYMENTS

Tech Specs

Recurring payments - stopped (1).png

​​​

​​​

1 Blue.png

To distinguish between Active and Stopped payments, use


URL: /vsps/search


Field: "stopInstructionType": "MERCHANT"

2 Blue.png

​​​

To get a list COF merchants where the PAN is used for recurring or installment type payments, use


URL: /cofds-web/v1/datainfo
Field: mrchName or mrchDbaName
Field: tranType SCHEDULED_RECURRING, UNSCHEDULED_RECURRING, INSTALLMENT, BILL_PAY),
Field: ConfidenceInd

Consult your Visa representative to confirm ConfidenceInd

3 Blue.png

To get last payment date, use


URL:/cofds-web/v1/datainfo

Field: lastTranDateTime


 

Blue tip 4.png

To get transaction amount, use


URL: /cofds-web/v1/datainfo

Field:lastTranAmtBillCurrency

Tips.png Tip: If Search API does not return merchant name for a stop instruction, get the corresponding merchant name returned by the COF API for the same CAID. Remove any duplicates from results returned by the COF and Add merchant APIs.
Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png “Learn more” aids cardholders in understanding how this feature can help them gain more visibility and control over their finances and encourage enrollment.
2 Yellow.png Clearly communicate the status of subscriptions so cardholders can easily distinguish between active and stopped subscriptions.

RESTART PAYMENT - PAYMENT DETAILS

Tech Specs

Payment details - stopped (1).png

​​​

​​​

​​​

1 Blue.png

Merchant logos are to be sourced internally by the issuer.
2 Blue.png

To get payment status, use

URL: /vsps/search


Select all transactions returned in from the VSPS Search API with field "stopInstructionType": "MERCHANT" to get a list of stopped transactions.

Go to new page.png Please review the VSPS API reference for sample API requests and responses.
UX Recommendations
1 Yellow.png Include a “Learn More” link to provide an easy way to get answers to their questions about each of the options.

yellow Tip.png

Tip: Use clear, simple calls to action, such as “Learn More.” Link to the content vs. using a button so cardholders understand this isn’t a step they need to complete.

RESTART PAYMENT - T&C

Tech Specs

Restart payment TC.png

​​​

​​​

 

1 Blue.png

All legal and information text to be hosted internally by the issuer.

 

2 Blue.png

To restart payment, first use

URL: /vsps/search

to get the stop instruction ID from

Field "stopInstructionId".


Then use

URL: /vsps/cancel

to cancel the stop instruction using the stop instruction Id.

 

Tips.png

​​​

Tip: To ensure all linked instructions are stopped, retrieve merchant identifiers from
URL: /cofds-web/v1/datainfo/merchants
Field: rawMrchName, lastCardAcceptorId

and use that info to choose the stop instructions with corresponding merchant identifiers.
To retrieve the PFID/SMID, use

URL: /cofds-web/v1/datainfo
Field : paymentFacilitatorId, sponsoredMerchantId

 
Go to new page.png Please review the VSPS API reference for sample API requests and responses.  
UX Recommendations  
1 Yellow.png

Clearly communicate that stopping recurring charges will only stop future charges​ to set cardholder expectations about how the feature works and reduce inquiries to the call center and customer dissatisfaction. 


 

 

2 Yellow.png

​​​

Ensure cardholders understand that they should contact the merchant first to ensure the service / subscription is canceled or their payment concerns are addressed.

   

RESTART PAYMENT - CONFIRMATION

Tech Specs

14 - RESTART PAYMENT.png

​​​

1 Blue.png

Once the Cancel API call is placed, a 200 or 400 response is returned along with stop instruction ID and details. A 200 response will also include the status of the request, which includes success (00), partial success (01) or fail (02). A 400 response will include an error code along with the reason for failure.
Go to new page.png Please review the VSPS API reference for sample success and error messages.
UX Recommendations
1 Yellow.png Clearly communicate that it may require interactions between the merchant and cardholder to have the service reactivated. The issuer will not work with the retailer to handle any contracts or terms with the retailer.

RESTART PAYMENT - ADDITIONAL MESSAGING TO AVOID MISUSE

Additional Recommendation

11.0 - Restarted Payment.png

​​​

Tips.png

Capture customer behavior patterns to make sure cardholders are not misusing the service to get out of payment obligations.
Restart Payment

#

Process Flow Description

1

Cardholder logs in to their issuer mobile app and selects the option to view stopped subscription payments.

2

Issuer triggers the VSM Search API passing the PAN in the request.

3

Visa VSM Search API responds with information on stop instructions and associated details.

4

Issuer displays a list of merchants with stopped subscription payments.

5

Cardholder selects a particular merchant.

6

Issuer displays merchant related details and the option to restart payment.
7 Cardholder chooses to restart the payment.
8 Issuer triggers the VSM Cancel API.
9 Visa processes the request and responds with the status of the request.
10 Issuer displays the status of the request to through the banking application.

Additional Mobile User Experiences

This section covers additional use cases on top of the core end- to- end experiences. Refer to the  Stop, Pause ad Restart Payment sections above for API interactions, UX recommendations and technical requirements.

Stopping all recurring payments at a retailer

Issuers can opt to provide additional types of experiences that allow cardholders to stop payments for all subscriptions under a merchant. For example, a cardholder may have subscription at merchants like Amazon that provide multiple subscritpions like Amazon Prime, Kindle or Prime Video, and may wish to cancel all Amamzon subscription together.

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

Stopping payments at a PAN or MCC level

Restarting all stopped recurring payments at a retailer

The following screens show how issuers can allow cardholders to restart all subscription payments that they previosuly cancelled for a retailer. For example, a cardholder may want to restart all their subscriptions provided by Lot Plus. The services they would like to restart could be their streaming service, gaming service and music service provided by Lot Plus.

Cardholders selecting the period for which they want to stop payment

Stopping a particular subscription payment under a wallet

The following screens show how issuers can allow cardholders to stop a particular subscription payment setup under a wallet. For example, a cardholder may be using a wallet like Paypal to pay for multiple subscriptions, and may want to cancel one of those subscriptions.

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

Introducing VSPS to cardholders

Informational Messaging

The following user experience screens contain messaging to communicate the value of Subscription Manager and how it works. It is important to build awareness and understanding of subscription management capabilties available within the issuer's mobile application. Issuers can provide additional information about the service using a “Learn More” overlay. You can also include information on how it works on the “Recurring Payment Details” screen to help cardholders understand how to pause / stop a recurring payment, or restart a stopped payment. Additionally, this may also help increase cardholder satisfaction and engagement, and reduce the issuer’s cardholder support volume. All informational messaging will be owned and internally hosted by the issuer.

Contextual messaging

All user flows and messaging shown are for illustrative purposes only. They are not comprehensive and do not constitute legal or marketing advice or replace participant's own analysis.

Implementation Best Practices

Displaying recurring payments

  • Subscribe to VAU in order to communicate PAN updates and replacement information to Visa. 
  • Use the Y or N flag in the COF Data Service API to confirm if the merchant has updated credentials for the card on file and display card status to cardholders.This will enhance the purchase experience.
  • For ease of cardholder recognition, use the cleansed merchant name as the displayed merchant name - i.e. mrchName from Card-On-File Data Service API"
  • To ensure the cardholders chose the right subscription to be stopped, retrieve and use merchant identifiers returned by the Raw merchant Card on File API.
  • To display transaction date in a local time zones, use the last transaction date time field (lastTranDateTime) returned by the COF.
  • Only display merchants with transaction type – unscheduled recurring, scheduled recurring, installments or Bill Pay.

 

Creating stop instructions with precision

The number of unwanted transactions stopped depends on the quality of transaction data, specifically merchant details, and stop instructions placed. Follow these best practices to
 create stop instructions that can help you optimize performance and cost.

  • Choose the merchant identifiers and other parameters from the most recent authorization transaction returned by the COF API. (Note – individual stop instructions will be created for every variation).​
  • Use all available merchant identifiers (name plus CAID, or PFID/SMID if present)​. Some merchants may provide different merchant names or CAIDs in each transaction. Creating stop instructions on the merchant name and CAID (if PFID/SMID is not present) will ensure unwanted transactions are stopped even if merchant data is inconsistent. Please note that the merchant identifier used in the stop instruction should match the authorization or clearing message for VIP to stop transactions.
  • Set the “recurring and installment indicator” to “true” if you want to only stop recurring payments. If you want all eligible transactions at the merchant to be stopped, do not set this indicator to “true.”​
  • The more specific your instruction is, the fewer transactions are stopped. For example, if you set the transaction amount to $25.99, this will stop all transactions for that exact amount (irrespective of the subscription type or future price changes) while allowing all other transactions to pass through.
  • Subscribe to VSPS-VAU linking to help make sure a cardholder’s account remains protected after a card/account is replaced​. (Note: Feature requires Visa Account Update subscription. Reach out to your Visa representative to know more about VAU).
  • Use the “additional notes” field to record information, such as case number, that may help later during audit or updates. Do not add PAN-data to this field.

 

Display subscription payments only​

This helps prevent cardholders from blocking single payments, which increases issuer costs and can cause acceptance problems for the merchant/cardholder.

  • To ensure only recurring transactions are stopped and all other transactions are processed, select only ‘SCHEDULED_RECURRING, UNSCHEDULED_RECURRING, INSTALLMENT, BILL_PAY’, from the COF API.

 

Benefit from cost-control features

  • Make use of the auto-cancel setting for your stop payment subscription. The VSM system will automatically extend the end date of a stop instruction if the merchant continues trying to take payment. This can prevent the cardholder's account from becoming debited again and necessitate the processing of subsequent chargebacks.​
  • Apply the auto-extend setting for your stop payment subscription. The VSM system will automatically cancel stop instructions that have never stopped a payment after a set period. 

Additional Legal Terms

Visa does not provide legal, regulatory, tax or financial advice. Each client is fully responsible for ensuring that its program operates in compliance with applicable legal and regulatory requirements and is responsible for conducting independent legal and regulatory reviews through its legal counsel. The best practices, recommendations and sample user interfaces herein, including any sample legal language therein, are provided for informational purposes, non-comprehensive, illustrative and provided for reference only. They are neither mandatory, nor should they be relied upon for marketing, legal, regulatory or other advice. Each client needs to conduct its own independent analysis in light of its specific business needs and any applicable laws and regulations. Visa is not responsible for your use of any of the information herein, including errors of any kind.

 

Benefits are illustrative only and depend on implementation details and business factors.

 

Without limiting any other VSPS requirement as set forth in the Visa Rules, usage of VSPS does not remove any obligation of the cardholder to meet payment terms or any other agreement with the merchant, including but not limited to informing the merchant the cardholder wishes to cancel the respective service. Clients that wish to use third party services in order to provide cancellation services to their cardholders do so at their own risk. Visa does not have insight into the operations of such third party providers and disclaims any and all liability or responsibility in that regard.