REST API for Verify

API Entry Point

POST /v1/payment-instruments/{token}/verifications

Request

{
"verify": {  
 "accountName": {
    "firstName": "string",
    "lastName": "string"
  }
}

Response

{
  "scheme": "VISA",
  "accountNameResult": {
    "overall": "MATCH",
    "firstName": "MATCH",
    "lastName": "MATCH"
  }
}

Possible results for:

First and last names:

MATCH
PARTIAL_MATCH,
NO_MATCH

Overall:

MATCH
PARTIAL_MATCH,
NO_MATCH

📘
firstName/lastName match results may be omitted when the scheme does not provide them.

Success codes

The following top level Visa ANI outcomes are successful BR-DGE Verify requests and returned with HTTP 200:

MATCH
PARTIAL_MATCH
NO_MATCH

For partial and no matches, you are informed of the status of the match.

Error codes

The following error codes may occur when using Verify:

Error code (HTTP/BR-DGE response code)	Cause
400/4000	Invalid request. `Request Error - The request is invalid.First name cannot be blank or Last name cannot be blank.`
400/4102	Visa account verification not enrolled. `Request Error - Merchant account config error on payment processor.Visa account name verification is not enrolled for this payment instrument or configuration.`
400/4102	Visa account verification enrollment incomplete. `Request Error - Merchant account config error on payment processor.Visa account name verification enrollment is incomplete for this payment instrument or configuration.`
400/4218	Payment Instument is not a card. `Request error - Unsupported operation for this payment instrument.The supplied payment instrument is not a card.`
400/4700	Card-on-File is not Visa. `Request error - Unsupported card network. Account name verification is currently only supported for Visa Card-on-File tokens.`
400/4806	Issuer does not support account name verification. `Request error - Account name verification is not supported.The issuer does not support account name verification for this payment instrument.`
401	Unauthorised request
403/4031	Verify not enabled. `Request Error - This functionality is not enabled for the retail channel.BR-DGE Verify or Visa Network Tokens are not enabled. Please contact Customer Support.`
404/4253	Active multi-use token not found. `Request Error - Active payment instrument not found. Could not find an active Card-on-File for the supplied token.`
404/4703	Network token not found, `No Network Token found for this Card-on-File.` `No active Network Token is associated with the supplied Card-on-File.`
500/5001	Internal server error. `Unexpected error.` An internal server error occurred upstream while processing the request. Learn more about the possible response codes.
502/5003	Visa service unavailable. `Unexpected error.A downstream service was unavailable while processing the account name verification request.`
502/5305	Visa accøunt verification timed out. `Network timeout.The account name verification request to Visa timed out.`