Getting Started with Merchant Measurement

About Merchant Measurement

Merchant Measurement provides insight into how well your merchant portfolios perform, by tracking sales metrics at multiple industry and geographic levels. You are also able to compare performance against many Visa card accepting locations. For example, by using an aggregated and deidentified transaction dataset, you can compare sales growth and chargeback performance.

Things to Know

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

For additional information, contact your Visa representative or email developer@visa.com with the subject “Merchant Measurement Benchmark API”.

Visa does not make any warranty or representation as to the accuracy, timeliness or completeness of the information provided by the Merchant Measurement Benchmark 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.

Merchant Measurement lets clients access aggregated merchant data collected across the Visa network.

Group List

All metrics are assigned to a group, which must be specified in the Group List parameter for retrieval. When clients possess the requisite permission level, they can receive the metrics corresponding to the requested group.

Mixed Input

Users must always specify a Country in order to retrieve data. To retrieve data for the New York City postal code 10010, enter Country = US and postalCode = 10010.

Users cannot mix inputs from the following retrieval levels in the same request:

  • Merchant Category Group (MCG) Level and Merchant Category Code (MCC) Level
  • Metropolitan Statistical Area (MSA) Level and Postal Code Level
  • GroupList = Cardholder and accountFundingSource ≠ ALL
  • GroupList = Cardholder and platformID ≠ ALL
  • GroupList = Cardholder and eciIndicator ≠ ALL
  • GroupList = Cardholder and posEntryMode ≠ ALL
  • GroupList = Chargebacks and accountFundingSource ≠ ALL
  • GroupList = Chargebacks and platformID ≠ ALL
  • GroupList = Chargebacks and eciIndicator ≠ ALL
  • GroupList = Chargebacks and posEntryMode ≠ ALL

Availability

The following table lists the regional availability for Visa Transaction Controls. To view availability of all products, refer to the Availability Matrix.

Available in entire region

Limited availability in region

Not available

Region Availability Notes
North America Available in United States
Asia-Pacific
Europe
CEMEA
LAC

Merchant Category Code Limitations

All users are limited to requesting a maximum of 10 MCCs in a single request. Some MCCs due to the size of the categories are limited to only 2 per request. After completing the licensing agreement the user will be provided confirmation of the MCCs they are approved access to and any limitations.

Maximum Number of List Elements (in Arguments Accepting List Input)

Merchant Measurement product API arguments which accept list input.

MerchantCategoryCodes 10
MerchantCategoryGroupsCodes 5
naicsCodes 3
countryList 1
countrySubdivisionList 3
msaList 3
zipList 25
accountFundingSource 6
platformID 4
eciIndicator 10
posEntryMode 6
monthList 12

Wildcard inputs and regular expression inputs are not supported in the Merchant Measurement Benchmark API.

APIs Included

Merchant Measurement Benchmark API

The Merchant Measurement Benchmark API provides access to purchase trend data at industry and sector levels by using an aggregated and anonymous transaction dataset.