REST API for Verify

API Entry Point

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

Request

{
  "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

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. First name cannot be blank or Last name cannot be blank
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.`
400/4700	Card on file is not VISA; `Request error - the request is invalid, Account name verification is currently only supported by Visa Card-on-File tokens`
400/4806	Issuer does not support account name verification (ANI). `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. Visa account name verification is not enrolled for this payment instrument or configuration.` OR `Request Error - This functionality is not enabled for the retail channel. Visa account name verification enrollment is incomplete for this payment instrument or configuration.`
404/4703	No Network Token was found for the supplied Card-on-File. Returned when BR-DGE finds the supplied Card-on-File, but no active Network Token is assigned to it. `Entity not found. No active Network Token is associated with the supplied Card-on-File.`
500	Unknown server error. Returned when BR-DGE cannot complete the account name verification because Visa or a downstream dependency is unavailable. `Unexpected errorA downstream service was unavailable while processing the account name verification request.`
502/5003	Downstream Visa service unavailable or returned an unsuccessful response.