Docs play_arrow Merchant Search

Merchant Search Documentation

Ready to start coding?

Things to Know

The Merchant Search API can be used by developers in the sandbox. To use the API in production, client must be pre-approved by Visa. The Merchant Search API licensing agreement and approval process is available as part of the Production Onboarding.  Use of the service is subject to the use restrictions and other terms and conditions set forth in the applicable agreement.

Merchant Data is only available for the U.S. Merchants at this point in time. For additional queries, contact developer@visa.com. 

The sandbox and samples only show the basic list of attributes available. For a full list of attributes, contact your Visa representative or email developer@visa.com with the subject “Merchant Data API”.

Visa does not make any warranty or representation as to the accuracy, currentness, or completeness of the information provided via the Merchant Search API, nor does Visa assume any liability or responsibility for claims or damages that may result from reliance on such information. Users of this information should communicate directly with the business entity for verification of accuracy.

Availability

The following table lists the regional availability for Merchant Search. To view availability of all products, refer to the Availability Matrix.

Available in entire region

Limited availability in region

Not available

Product Name Availability Notes
Merchant Search Available in United States
Product Name Availability Notes
Merchant Search
Product Name Availability Notes
Merchant Search
Product Name Availability Notes
Merchant Search
Product Name Availability Notes
Merchant Search

Getting Started

Merchant Search helps enhance the power of your services by providing access to Visa- accepting merchant identification data that uses Visa’s transaction data, third party data, and other systematic intelligence to improve data quality across the Visa payment network.

The Merchant Search API lets clients find the merchant identification information using the acquirer provided Merchant Name and other attributes such as address and card acceptor identifiers.

Group Names  

All merchants will be assigned one or more Group Name(s) that are configured with attributes. When the clients specify the Group Name in the request, the attributes assigned to such Group Name will be sent in the response.

Wildcard Search

The clients can use the wildcard search with the Merchant Name when at least the first 3 characters of the Merchant Name are known.

Max Records per Request

The clients can use the maximum record functionality to limit the number of records returned in response to each request. When maximum record is not defined, a default of up to 50 records will be sent in the response.

How Does It Work?

The Merchant Search API is easy to use.

  1. Search
    You can search for the merchant identification data using the acquirer provided Merchant Name, Country Code, and other attributes such as Address or Card Acceptor Identifiers. The API supports wildcard searches on Merchant Name if the entire Merchant Name is not available. You can choose to receive only those records that are an exact match or a list of records that matched on certain attributes.
  2. Receive Cleansed Merchant Data
    You can receive back enriched merchant and merchant location level attributes. The API returns maximum of up to 50 records per request. Records returned are from highest to lowest match score. The match score is calculated based on the number of search attributes that matched.

Why Use It?

Issuer

Support cardholder inquiries to improve transaction recognition and reduce fraud, as well as find potential partners for new programs.

Independent Developers*

Search for merchant information or Visa’s merchant IDs to identify merchants to support your products.

*subject to Visa approval

APIs Included

Search

The Search API is easy to integrate and allows clients to search for marchant identification data to support their products and services.