Mastercard · Schema

Mastercard Merchant

A merchant or card acceptor registered in the Mastercard network. Represents businesses that accept Mastercard payments, with location, categorization, and terminal capability data. Used across Merchant Locations, Checkout Solutions, fraud reporting, and analytics APIs.

Credit CardsDigital IdentityFinancial ServicesFraud DetectionOpen BankingPayments

Properties

Name	Type	Description
merchantId	string	Card acceptor or merchant unique identification number assigned by the acquirer.
id	integer	Numerical merchant identifier within the Mastercard Merchant Locations system.
merchantName	string	Legal or trade name of the merchant.
dbaName	string	Doing Business As (DBA) name, the merchant name visible to cardholders.
merchantCategoryCode	string	Four-digit ISO 18245 Merchant Category Code (MCC) classifying the business type.
category	string	Human-readable merchant category description from the Mastercard category taxonomy.
categoryId	string	Mastercard internal category identifier for the merchant.
merchantType	string	Classification of the merchant by acceptance capability.
address	object
location	object
distance	number	Distance from a search reference point to this merchant location.
distanceUnit	string	Unit of measure for the distance value.
geocodingResult	string	Geocoding result quality indicator for the merchant address.
terminalCapabilities	object
cashbackMaximumAmount	string	Maximum cashback amount permitted at this merchant location.
dpa	object
acquirerId	string	ICA number of the acquiring institution for this merchant.
acquirerMerchantId	string	Merchant identifier assigned by the acquirer.
websiteUrl	string	URL of the merchant website.
logoUrl	string	URL of the merchant logo image.
offerMerchantId	string	Unique identifier representing the merchant as a sponsor of offers.

View JSON Schema on GitHub