Skip to content

FSP Intersolve Visa

RubenGeo edited this page Nov 26, 2024 · 8 revisions

Mapping of the card statuses

One of the ways people can receive cash support via the 121 Platform is via Visa Debit Cards. To make this work the 121 Platform is integrated with a Visa-related API provided by Intersolve. For a general idea of how this integration works, see the Intersolve Visa-related UML Activity Diagrams on the Use Cases page.

To keep the 121 Portal simple and intuitive for Portal Users the system automatically maps various technical statuses relating to Intersolve Visa Cards to a single "121" Visa Card Status, along with an Explanation text if relevant. Also, this 121 Visa Card Status determines which card-related actions are available to Portal Users.

The system determines the "121" Visa Card Status by loading a "definition" CSV file in the code. To see which combination of Intersolve Wallet Status, Intersolve Wallet Blocked, Visa Card Status and if a Wallet is the active Wallet for a person results in which "121" Visa Card Status and possible actions, see the CSV file located here:

services/121-service/src/payments/fsp-integration/intersolve-visa/services/visaStatusMap.csv

Configure Cover Letter Code

To streamline the process of generating debit cards, you can configure and transmit it from the 121 application to Intersolve Visa. The configuration of the cover letter code is managed through the FSP configuration, which integrates the code into our 121 application for program-specific purposes. Subsequently, during card generation, we retrieve this code based on the specific program requirements and send it to Intersolve.

How to configure cover letter code by program

To configure cover letter code use the API call POST api/programs/{programId}/financial-service-provider-configurations/{name}/properties with following payload as body to configure it for specific program:

{
  "name": "coverLetterCode",
  "value": "RC01"
}

*** if there is no cover letter code for Intersolve integration then the payout is going to fail for PAs and it will display error with message No coverLetterCode found for financial service provider under program ${programId}. Please update the program's financial service provider cofinguration.

Configure Brand Code

To configure and transmit the brand code from the 121 application to Intersolve Visa, you can configure it through the FSP configuration. we retrieve this code based on the specific program requirements and send it to Intersolve accordingly.

How to configure brand code by program

To configure brand code use the API call POST api/programs/{programId}/financial-service-provider-configurations/{name}/properties with following payload as body to configure it for specific program:

{
  "name": "brandCode",
  "value": "K218_001"
}

Configure Funding Token Code

To configure and transmit the funding token code from the 121 application to Intersolve Visa, you can configure it through the FSP configuration. We retrieve this code based on the specific program requirements and send it to Intersolve accordingly.

How to configure funding token code by program

To configure the funding token code use the API call `POST api/programs/{programId}/financial-service-provider-configurations/{name}/properties with following payload as body to configure it for specific program:

{
  "name": "fundingTokenCode",
  "value": "6000000000000000001"
}
Clone this wiki locally