How to Use Visa Alias Directory

Navigate to...

How to Use Lifecycle Management, Alias Resolution, and Reporting APIs

Quick Start

A quick introduction for creating and resolving your first Alias.

Step 1

Create an account on Visa Developer and add Alias Directory to your project. Click this link for an example of creating a project and adding APIs.

Step 2

Connect to the Create Alias API in the Sandbox. Use the below code in your Create Alias API request body. Please fill the alias Value prior to submitting the request.

{
  "aliasValue": "{CREATE YOUR OWN VALUE HERE}",
  "aliasType": "PHONE",
  "profile": {
    "firstName": "John",
    "lastName": "D"
  },
  "consent": {
    "presenter": "Bank A",
    "validFromDateTime": "2022-03-30T04:43:22.043Z",
    "expiryDateTime": "2022-06-20T10:00:00Z",
    "version": "1.0"
  },
  "paymentCredentials": [
    {
      "type": "CARD",
      "preferredFor": [
        {
          "type": "RECEIVE"
        }
      ],
      "nameOnCard": "John Doe",
      "accountNumber": "4000000000000000",
      "expirationDate": "2030-01",
      "billingAddress": {
        "addressLine1": "100 Main Street",
        "addressLine2": "Suite 101",
        "city": "San Francisco",
        "postalCode": "94105",
        "state": "CA",
        "country": "USA"
      }
    }
  ]
}

You should receive a successful response like the below. The phone number and card are now linked.

{
  "id": "df844b33-0712-4783-9f84-55d5d90eb2df",
  "paymentCredentials": [
    {
      "type": "CARD",
      "id": "752c1fc5-b13b-4903-a725-090601d26f22"
    }
  ]
}

Step 3

Now use the Resolve API to retrieve the payment credential. Use the below code in the Resolve API request body.

{
  "aliasValue": "{USE PHONE NUMBER FROM PREVIOUS STEP}",
  "aliasType": "PHONE"
}

You should now be able to see the details associated with the Alias in the response.

{
  "identification": {},
  "profile": {
    "firstName": "John",
    "lastName": "D"
  },
  "paymentCredentials": [
    {
      "type": "CARD",
      "accountNumber": "4000000000000000",
      "preferredOn": "2022-10-24T19:35:34.654487Z",
      "nameOnCard": "John Doe",
      "expirationDate": "2030-01",
      "billingAddress": {
        "city": "San Francisco",
        "country": "USA",
        "addressLine1": "100 Main Street",
        "state": "CA",
        "postalCode": "94105",
        "addressLine2": "Suite 101"
      }
    }
  ],
  "directoryName": "STANDARD_91D614C3"
}

Alias Lifecycle Management

Alias Directory allows clients to create Aliases and manage their lifecycle, e.g., update and delete.

Key Terms

Key Terms	Definitions
Participants	The entities that participate in Alias Directory, e.g. banks.
Alias	An identifier, such as a phone number or email, that represents a customer of a participant. An Alias has a list of Profiles
Profile	A Profile identifies a customer for a specific participant with information such as name, address, etc. A Profile has a list of Payment Credentials.
Payment Credential	This is the payment instrument that is associated with a Profile. Examples of payment credentials are cards and bank accounts.
Program	A list of configurations, such as duplicate resolution rules, that determine the behavior of the Alias Directory for a group of Participants. For example, separate programs might be created for different regions or countries which require specific configurations to meet market requirements. All participants will be part of a default Visa program unless there are specific requirements necessary in a particular market. Please contact your implementation manager for more information.

Data Schema Overview

The below diagram is a simple visual of how this data is mapped in Alias Directory. In the below example

A customer named John has a phone number.
John is a customer of two banks: Bank A and Bank B. Both banks are participating in Alias Directory. John has provided consent to register his information in Alias Directory.
In the Alias Directory database, John has two profiles - one for each bank.
John has a checking account and debit card in each bank and registers them in Alias Directory. In the Alias Directory database, each checking account and debit card is mapped to the respective profile.
John selected his debit card at Bank A as his preferred payment credential

Alias Lifecycle Management APIs Overview

API	Description
Create Alias	This creates an Alias record which consists of a Profile and Payment Credential(s). Multiple payment credential types can be added with a Create Alias call. However, only one of each payment credential type can be added with a Create Alias call. For example, a Create Alias call can include a card and bank account. However, it cannot include two bank accounts. A second bank account can be linked to the same Alias using the Add Payment Credentials API.
Update Alias	Updates the information in the Alias. Only the entity which has the appropriate permissions can make any edits to the Alias information. In the above example, only “Bank A” can edit “Bank A” information. “Bank A” cannot edit “Bank B” information. This API will allow updates the Profile, Identification, and Consent objects. Any updates to payment credentials should be done with the Update Payment Credentials API. This API replaces the target resource with the content in the request payload, including omitted fields. Clients should perform a GET Alias request prior to using this API.
Delete Alias	Deletes a particular Alias. Only the entity which has the appropriate permissions can delete this Alias. In the above example, only “Bank A” can delete the Alias information with “Bank A”. “Bank A” cannot delete “Bank B” information. If an Alias is deleted, then all payment credentials associated with that Identity will also be deleted. In the above example, if “Bank A” deletes John’s phone, then John’s Alias and Payment Credentials with Bank A will also be deleted. “Bank B” information will not be impacted.
Create Payment Credential	Adds a payment credential to an existing Alias. This is used when there may be multiple payment credentials such as checking account, savings account, debit card, etc. associated with an Alias
Get All Payment Credentials	Retrieve all the payment credentials associated with an Alias In the above example, if Bank A called this API, then the response would contain the card and bank payment credentials associated with John at Bank A
Get Payment Credential	Retrieve a single, specific a payment credential associated with an Alias In the above example, Bank A can call this API to only retrieve the information for the card payment credential.
Update Payment Credential	Update a payment credential associated with an existing Alias. This API can also be used to update the preferred payment credential associated with an Alias. This API replaces the target resource with the content in the request payload, including omitted fields. Clients should perform a GET Payment Credential request prior to using this API.
Delete Payment Credential	Deletes a payment credential associated with an Alias

Alias and Payment Credential Status

Possible Alias statuses:

Status	Comments
Active	An active Alias can be used for Alias Lifecycle Management and Alias Resolution
Deleted	This status occurs when a participant deletes their Alias A deleted Alias can’t be made Active again. If the same Alias is needed in the future, it must be created again.
Blocked	This status occurs when an Alias is blocked for suspected fraud, suspicious behavior, or findings on sanctions screening. In these cases, Alias Directory will automatically set the Alias as blocked. A blocked Alias can be made Active again.
Disabled	A client can manually set an Alias as disabled and not be used for Alias resolution. This is up to the client’s discretion. The client can update the status from disabled back to Active. This can be done via the Update Alias Status API (coming soon)

Possible Payment Credential statuses:

Status	Comments
Active	An active Payment Credential can be used for Alias Lifecycle Management and Alias Resolution
Deleted	This status occurs when the Payment Credential is deleted A deleted Payment Credential can’t be made Active again. Clients should add the same Payment Credential again if they want to associate it to an Alias.

External IDs

Overview

Alias Directory offers clients a number of options for managing their Alias records. Clients may already have an existing id used for their consumer's Alias data and can reuse that id as an externalId.

In the Create Alias call, an id; is returned for the Alias (Line 2) and for each payment credential (Line 6 & 12). Each id is internally generated by Alias Directory and used for identifying each record. Clients can provide an externalId during the Create Alias API and each externalId will be associated with an internal id

In the below example, the externalId is returned in Lines 3,8, and 13.

{
    "id": "0ddaa171-5247-424a-a562-40788940c5cf",
    "externalId": "ec66fd21-a328-4943-bb0d-c011b27553b5",
    "paymentCredentials": [
        {
            "type": "CARD",
            "id": "6ef14e04-6d0d-4ec7-b14b-335a46ae45e4",
            "externalId": "0e1d1bdf-11a6-4fa9-bd8d-687c465f7bec"
        },
        {
            "type": "BANK",
            "id": "e6782b9b-0dc8-4669-a5f4-394519e49986",
            "externalId": "4f8b8823-230b-4ffb-b57b-72300ceec150"
        }
    ]
}

Retrieving Internal IDs using External IDs

To perform lifecycle management, clients must use the internal <code>id</code>. If the client is only storing the <code>externalId</code>, the clients must first retrieve the internal <code>id</code> by calling the Get By External ID API and including <code>externalId</code> in the request. See below request example:

{
"type":"ALIAS",
"externalId":"ec66fd21-a328-4943-bb0d-c011b27553b5"
}

The response returns the internal id, which can then be used for lifecycle management. See below response example.

Retrieving Internal IDs using Alias

Clients can also retrieve the internal <code>id</code> of an Alias using the Alias value itself. This can be done via the Get Alias Id From Value API. See below a sample request:

{
  "aliasValue": "6886217206"
}

The response will include the id of the Alias.

{
    "id": "0ddaa171-5247-424a-a562-40788940c5cf"
}

Alias Resolution

Overview

There are two APIs within the Alias Resolution bundle

Alias Resolution - Retrieve information about an Alias and the payment credential(s) associated with the Alias.
Alias Inquiry - Enables clients to check if an Alias or list of Aliases is available for Alias resolution. The response will indicate the Aliases that are available for Alias resolution.

Search Options

Alias Types

Alias Directory currently supports the following Alias types: Phone, Email, Directory_AliasID.

Directory_AliasID is a unique identifier which is associated with an Alias. This is used by some wallets in certain markets. For example, in the Peru market, the Directory_AliasID is derived from a QR code, which is associated with an Alias in a particular wallet.

Filters

Alias Directory supports a number of filters which can be applied to the Alias Resolution request.

Directory_Name - Send Alias Resolution to only this directory
Excluded_Directory_Name - Exclude this directory in the Alias Resolution
Entity_ID - The entity Id is used by some remote directories to identify the entities within their directory. For example, a remote directory may have multiple banks within its directory. The Alias Resolution request can be sent to a specific bank within that remote directory by using that bank’s entity ID.

Additional details on Entity IDs

The list of Entity IDs within the Remote Directory can be provided as part of Remote Directory onboarding. The Entity ID format will vary by market. Please speak with your implementation manager for more information.
If a participant originates an Alias Resolution request with an Entity Id that was not included in the Remote Directory onboarding, an error will be returned indicating the Entity was not found. The Remote Directory will also not receive any Alias Resolution request.
If a Remote Directory decides to use the Entity Id functionality, the Remote Directory’s Alias Inquiry API response must indicate the Entity ID(s) associated with the Aliases. The Entity ID(s) returned in the response must have the same format as the Entity IDs registered during the onboarding process.
The Entity ID is an optional field. Remote Directories must be able to respond to an Alias Resolution or Alias Inquiry request where Entity ID is not present.

Transaction Details

This object provides additional information to the recipient of the Alias Resolution request to help provide the appropriate payment credential.
currencyCode - Allows a client to specify the currency of the payment credential returned in the Alias Resolution response. Some clients have different payment credentials for different currencies. By providing the currencyCode, a client can specify currency of the payment credential needed in the Alias Resolution response.

User Details

This object allows the client initiating an Alias Inquiry or Alias Resolution call to provide more information about the consumer requesting the information.
This consumer information can be provided in the userName field and should use an identifier that represents the end user who is requesting an Alias Resolution. This field must not contain any PII information.
This information will be used for risk analysis purposes by Directory Network Manager. In addition, this information will be passed to remote directories for risk analysis purposes.

Setting a Preferred Payment Instrument

Alias Directory allows a payment credential to be marked as “Preferred”.
Alias Directory supports associating multiple payment instruments at multiple banks with a single Alias and allows selecting a preferred payment instrument for receiving payments. In the example above, John has four payment credentials associated with his Alias. He has selected “John's Debit Card at Bank A” as the preferred payment instrument so that any payment sent using his Alias will be received into this account.
For a given Alias, only one payment instrument of each payment instrument type may be marked as preferred. For example, the same Alias can have one card and one bank credential both marked as preferred.
- Please note that the above is the recommended configuration. However, certain programs may decide to allow more than one preferred credential.
If Bank A has marked a payment instrument as preferred, but a second client marks another payment instrument as preferred for the same Alias, then the second client's payment instrument will be marked as preferred and will be returned in Resolve API.

Duplicate Resolution

A common scenario that occurs is that a consumer may use the same Alias (e.g., phone) and register that Alias with multiple participants (e.g., the same phone number is registered at Bank A and Bank B)
During an Alias Resolution, Alias Directory Service applies a number of business rules to return a single payment credential to the requestor. A sample of some of those rules are below:

Rule Name	Description
Preferred Payment Credential	Prioritize the Payment Credential marked as preferred
Preferred Payment Credential Timestamp	If more than one Payment Credential is marked as preferred, return the preferred credential with the latest timestamp This scenario may occur if the program configuration allows for multiple preferred credentials. This scenario may also occur if a Remote Directory returns payment credentials that are marked as Preferred

Rule Name

Description

Preferred Payment Credential

Prioritize the Payment Credential marked as preferred

Preferred Payment Credential Timestamp

If more than one Payment Credential is marked as preferred, return the preferred credential with the latest timestamp

This scenario may occur if the program configuration allows for multiple preferred credentials.

This scenario may also occur if a Remote Directory returns payment credentials that are marked as Preferred

In the below example, the same consumer has registered the same Alias with 3 banks:

Phone	Participant	Marked as Preferred?	Preferred Timestamp
6505001234	Bank A (Local Directory)	Yes	1:00 pm, June 1, 2023
6505001234	Bank B (Remote Directory)	Yes	4:00 pm, June 10, 2023
6505001234	Bank C (Local Directory)	No

Given the above example, Alias Resolution would return Bank B’s Payment Credential.

Tokenization

Integration with Cybersource Token Management Service

Alias Directory Service supports tokenization for payment instruments through an integration with Cybersource Token Management Service. Token Management Service (TMS) creates a network token, which Alias Directory stores and associates with an Alias. The token protects sensitive customer payment data stored in secure Visa data centers and can be used in place of a PAN in an OCT.

Alias Directory currently uses TMS for tokenizing Visa payment credentials.

Please visit this link to learn more about Cybersource Token Management Service https://developer.cybersource.com/docs/cybs/en-us/tms/developer/ctv/rest/tms/tms-overview.html

Local Directory Tokenization

Tokenization can be enabled at the country level for all participants or at the bank level for individual participants.
If a client is configured for tokenization, Alias Directory Service will provision a network token during Create Alias and Create Payment Credential and store the token associated with the Alias
The token will be returned in Alias Resolve, Get Payment Credential by ID, and Get Payment Credential by Alias.
Alias Directory Service will throttle provision attempts to limit traffic to clients.
When a token is returned in Resolve, a field containing the last four digits of the PAN will be available to support recipient verification UX flows.
The accountNumberType field denotes if the account number is a token or a PAN.

Remote Directory Tokenization

This section details the case where a Remote Directory is providing a payment instrument to Alias Directory Service for use in Alias Resolve.

If the Remote Directory provides a PAN to Alias Directory, the PAN will be returned in Alias Resolve and a token will be provisioned offline for subsequent resolutions for this Alias and payment instrument.
Alias Directory will temporarily store the PAN in this scenario, but once the token is created, the PAN will be deleted.

Non-PCI Compliance and Tokenization

Clients who are configured as non-PCI compliant are now supported through the use of tokenization.

If a token is available, the PAN will be replaced with the token in the accountNumber field.
If no token is available, PCI information will be removed from Alias Resolve response.

Reporting

Alias Directory Service provides APIs for requesting and downloading reports. The available endpoints are listed below

Client
Create a report request

Visa
Return report ID

Client
Check report status

Client
Download completed report

Step	Endpoint	Description	Additional Details
Create Report	/reports (POST)	Create a report, specify the report type and define the parameters. Report ID is returned in response.	The field type specifies the type of report to be generated RESOLUTION_RECONCILIATION DIRECTORY_STATUS PAYMENT_CREDENTIAL_DETAIL PLATFORM_REQUESTS DIRECTORY_ACTIVITY The field filters defines the parameters used to create the report (e.g., startDate, endDate) Alias Directory will create the report offline and clients can download in the subsequent steps.
Get Report	/reports/{reportId} (GET)	Retrieves information about a specific Create Report request.	Clients can use this endpoint to check the status of a Create Report request. For example, the create report request may be “completed” or “in-progress” The response of this will also include the field "fileIds". The fileId will be used to download the report. Please note some reports may have multiple files due to the size of the report.
Download Report	/reports/{reportId}/file/{fileId} (GET)	Retrieves a file from a previously requested report with COMPLETED status.	This endpoint returns a base64 encoded file in csv format.

Step

Endpoint

Description

Additional Details

Create Report

/reports (POST)

Create a report, specify the report type and define the parameters.

Report ID is returned in response.

The field type specifies the type of report to be generated

RESOLUTION_RECONCILIATION
DIRECTORY_STATUS
PAYMENT_CREDENTIAL_DETAIL
PLATFORM_REQUESTS
DIRECTORY_ACTIVITY

The field filters defines the parameters used to create the report (e.g., startDate, endDate)

Alias Directory will create the report offline and clients can download in the subsequent steps.

Get Report

/reports/{reportId} (GET)

Retrieves information about a specific Create Report request.

Clients can use this endpoint to check the status of a Create Report request. For example, the create report request may be “completed” or “in-progress”

The response of this will also include the field "fileIds". The fileId will be used to download the report. Please note some reports may have multiple files due to the size of the report.

Download Report

/reports/{reportId}/file/{fileId} (GET)

Retrieves a file from a previously requested report with COMPLETED status.

This endpoint returns a base64 encoded file in csv format.

Resolution Reconciliation Report

Report Description:

Includes a detailed view of the Alias Resolutions requests of a participant. For example, if participant has made ten Alias Resolution requests, this report details the status and results of each request.
The following filters are applicable for this report: startDate, endDate

Report Fields:

Field Name: originationDateTime
Description: The date and time of the Alias Resolution request
Example: 2021-01-01T10:52:46.000Z

Field Name: programId
Description: The guid of the program that the participant belongs in
Example: a5d0bd35-16f5-4e98-86f5-b1a464215a63

Field Name: originatorActorId
Description: Participant id of the entity which sent the request
Example: 6ac54662-84da-401d-aab5-b86bac9a02a0

Field Name: onBehalfOf
Description: Participant id which the original_actor_id sent the request on behalf of. This is only applicable in certain cases.
Example: 1ff54662-84da-401d-aab5-b86bac9a02a2

Field Name: resolvedAlias
Description: The Alias value provided in the Alias Resolution request
Example: 123456789

Field Name: resolvedPaymentCredentialType
Description: The type of payment credential returned in the Alias Resolution response
Example: CARD

Field Name: statusCode
Description: The status code returned in the API response
Example: 200

Field Name: resolvedDirectory
Description: The name of the directory which returned the payment credential
Example: Directory A

Report Sample

[
    {
        "originationDateTime": "2023-07-31T20:15:18.679Z",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "statusCode": 200
    },
    {
        "originationDateTime": "2023-07-31T20:23:49.618Z",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "statusCode": 200
    }
]

Directory Status Report

Report Description:

Includes the cumulative number of Aliases and Payment credentials stored in the Alias Directory.
The following filters are applicable for this report: startDate, endDate, aliasType

Report Fields:

Field Name: programId
Description: The guid of the program that the participant belongs in
Example: a5d0bd35-16f5-4e98-86f5-b1a464215a63

Field Name: ownerParticipantId
Description: The participant id which owns this Alias and payment credential information
Example: 6ac54662-84da-401d-aab5-b86bac9a02a0

Field Name: objectType
Description: The type of this object
Possible values: ALIAS, PAYMENT_CREDENTIAL

Field Name: objectSubType
Description: The sub_type of this object
Possible values:
For Object_Type = ALIAS, then possible subtypes are: PHONE, EMAIL
For Object_Type = PAYMENT_CREDENTIAL, then possible subtypes are: CARD, BANK

Field Name: status
Description: The status of this object
Possible values: ACTIVE, DISABLED, BLOCKED, DELETED

Field Name: objectCount
Description: The number of types this object is in the Alias Directory
Example: 1200

Report Sample

[
    {
        "programId": "c0af8887-eac3-4b89-ad35-73c66e22088e",
        "ownerParticipantId": "d1ebd0da-54e5-493a-9ba3-4ccc21a183cc",
        "objectType": "ALIAS",
        "objectSubType": "PHONE",
        "status": "ACTIVE",
        "objectCount": 763739
    },
	{
        "programId": "c0af8887-eac3-4b89-ad35-73c66e22088e",
        "ownerParticipantId": "d1ebd0da-54e5-493a-9ba3-4ccc21a183cc",
        "objectType": "ALIAS",
        "objectSubType": "BANK",
        "status": "ACTIVE",
        "objectCount": 8772470
    }
]

Payment Credential Details

Report Description:

Provides a detailed view of the payment credentials stored in the Alias Directory. Each row is a payment credential.
The following filters are applicable for this report: startDate, endDate, aliasType, aliasStatuses
The startDate and endDate parameters will provide results based on when the payment credential was created.

Report Fields:

Field Name: paymentCredentialCreatedDateTime
Description: The time the payment credential was created
Example: 2021-01-01T10:52:46.000Z

Field Name: programId
Description: The guid of the program that the participant belongs in
Example: a5d0bd35-16f5-4e98-86f5-b1a464215a63

Field Name: ownerParticipantId
Description: Participant id which created the payment credential
Example: 9ed54662-84da-401d-aab5-b86bac9a02a0

Field Name: paymentCredentialId
Description: The internal ID of the payment credential
Example: 40f26d01-28b8-4261-8d9d-638e2bade69c

Field Name: paymentCredentialType
Description: The type of the payment credential
Example: CARD

Field Name: accountNumberLast4
Description: The last four digits of the account
Example: 3456

Field Name: paymentCredentialStatus
Description: The status of the payment credential
Example: ACTIVE

Field Name: aliasId
Description: The internal ID of the Alias associated with this payment credential
Example: daa3ceaa-c3d5-4b3c-b03e-9bc1eed60b78

Field Name: aliasValue
Description: The value of the Alias associated with this payment credential
Example: 51991512051

Field Name: aliasType
Description: The type of Alias
Example: Phone

Report Sample

[
    {
        "paymentCredentialCreatedDateTime": "2023-07-31T20:06:01.654426Z",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "ownerParticipantId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "paymentCredentialId": "06eeb39a-696a-4c6a-84f8-f3b2ad27ca11",
        "paymentCredentialType": "BANK",
        "accountNumberLast4": "1140",
        "paymentCredentialStatus": "ACTIVE",
        "aliasId": "967a3033-5cd3-4fe1-b09f-b6e4f1da5855",
        "aliasValue": "7568893885",
        "aliasType": "PHONE"
    },
    {
        "paymentCredentialCreatedDateTime": "2023-07-31T20:10:43.339798Z",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "ownerParticipantId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "paymentCredentialId": "1693aa4c-cb16-42ca-afa5-f0b6d6f75aeb",
        "paymentCredentialType": "BANK",
        "accountNumberLast4": "1140",
        "paymentCredentialStatus": "ACTIVE",
        "aliasId": "9564fb2a-c19c-4082-a973-c5233e5b0f24",
        "aliasValue": "9049748451",
        "aliasType": "PHONE"
    }
]

Platform Requests Report

Report Description:

Provides a view of the cumulative number of requests received in the Alias Directory.
The following filters are applicable for this report: startDate, endDate, billingEventTypes
Please note that if no billingEventTypes is specified, then all request types will be returned

Report Fields:

Field Name: programId
Description: The guid of the program that the participant belongs in
Example: a5d0bd35-16f5-4e98-86f5-b1a464215a63

Field Name: originatorActorId
Description: Participant id of the entity which sent the request
Example: 6ac54662-84da-401d-aab5-b86bac9a02a0

Field Name: operationType

Description: The type of operation the report must include.
Possible values:

aliasInquiry
createAlias
createBatch
createPaymentCredential
createReport
deleteAlias
deletePaymentCredential
getAlias
getAliasId
getAliasOnlineReport
getBatch
getBatchKeys
getBatchResult
getByExternalId
getPaymentCredential
getPaymentCredentials
getReport
getReportFile
resolveAlias
updateAlias
updateAliasStatus
updateBankPaymentCredential

Field Name: statusCode
Description: The status code returned in the API response
Example: 200

Field Name: operationsCount
Description: The aggregated amount of the number of requests
Example: 99

Report Sample

[
    {
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "operationType": "resolveAlias",
        "statusCode": 200,
        "operationsCount": 18
    },
    {
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "operationType": "resolveAlias",
        "statusCode": 422,
        "operationsCount": 4
    }
]

Resolution Directory Activity Report

Report Description:

Includes a detailed view of the Alias Resolutions requests received by a directory. This report is from the perspective of the directory itself and includes both local and remote directories. For example, a directory has received ten Alias Resolution requests, this report details the cumulative view of the requests by program and participant and its status.
The following filters are applicable for this report: startDate, endDate

Report Fields:

Field Name: resolveDirectory
Description: The directory which received the Alias Resolution requests.
Example: Directory A

Field Name: programId
Description: The guid of the program that the participant belongs in
Example: a5d0bd35-16f5-4e98-86f5-b1a464215a63

Field Name: originatorActorId
Description: Participant id of the entity which sent the request
Example: 6ac54662-84da-401d-aab5-b86bac9a02a0

Field Name: operationType

Description: The type of operation the report must include.
Possible values:

resolve_Alias

Field Name: statusCode
Description: The status code returned in the API response
Example: 200

Field Name: requestCount
Description: Total number of Alias Resolution requests
Example: 1200

Report Sample

[
    {
        "resolveDirectory": "STANDARD_5EF147CC",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "operationType": "resolve_alias",
        "statusCode": 422,
        "requestCount": 0
    },
    {
        "resolveDirectory": "STANDARD_GTB094FB",
        "programId": "baf85624-3cf6-4c52-b91f-b8f3493e7330",
        "originatorActorId": "012af73f-44d8-4c9c-bbee-628b07faae1c",
        "operationType": "resolve_alias",
        "statusCode": 200,
        "requestCount": 0
    }
]

Visa Alias Directory Service

Simplify the push payment experience. Link and resolve an Alias to a payment credential.

How to Use Lifecycle Management, Alias Resolution, and Reporting APIs

Quick Start

Step 1

Step 2

Step 3

Alias Lifecycle Management

Key Terms

Data Schema Overview

Alias Lifecycle Management APIs Overview

Alias and Payment Credential Status

External IDs

Overview

Retrieving Internal IDs using External IDs

Retrieving Internal IDs using Alias

Alias Resolution

Overview

Search Options

Alias Types

Filters

Additional details on Entity IDs

Transaction Details

User Details

Setting a Preferred Payment Instrument

Duplicate Resolution

Tokenization

Reporting

Resolution Reconciliation Report

Directory Status Report

Payment Credential Details

Platform Requests Report

Resolution Directory Activity Report