Merchants Overview - MX Documentation

For example, if you buy a coffee at Starbucks, the transaction merchant will be Starbucks. Use the merchant_guid and a merchant_location_guid on any transaction object to access Merchant endpoints for details like the merchant’s name, logo URL, website, street address, and more.

Merchant Fields

Field	Data Type	Description
`created_at`	String	The date and time at which the `merchant` was created.
`guid`	String	The unique identifier for the `merchant`. Defined by MX.
`logo_url`	String	The URL for a 100px X 100px logo for the `merchant`.
`logo_updated_at`	String	The date and time the logo associated with this `merchant` was last updated.
`name`	String	A human-readable name for the `merchant` for display to the end user.
`updated_at`	String	The date and time at which the `merchant` was last updated.
`website_url`	String	The URL for the merchant’s website, e.g. `https://www.xfinity.com`.

Merchant Location Fields

Field	Data Type	Definition
`city`	String	The city in which the `merchant` is located.
`country`	String	The country in which the `merchant` is located.
`guid`	String	The unique identifier for the `merchant` location. Defined by MX.
`latitude`	Decimal	The latitude of the `merchant` location. This number is a signed decimal (e.g., Rio de Janeiro’s latitude is -22.9027800 and Tokyo’s latitude is 35.689488).
`longitude`	Decimal	The longitude of the `merchant` location. This number is a signed decimal (e.g., Rio de Janeiro’s longitude is -43.2075000 and Tokyo’s longitude is 139.691706).
`merchant_guid`	String	The unique identifier for the `merchant` to which this location belongs. Defined by MX.
`phone_number`	String	The phone number for the `merchant` location.
`postal_code`	String	The postal code in which the `merchant` is located.
`state`	String	The state in which the `merchant` is located.
`street_address`	String	The street address at which the `merchant` is located.
`updated_at`	String	The date and time the `merchant_location` was last updated.

Merchant Category Codes

List of merchant category codes

Merchant Category Code	Merchant Category	MX Category
742	Veterinary Services	Veterinary
763	Agricultural Cooperative	Food & Dining
780	Landscaping Services	Lawn & Garden
1520	General Contractors	Home Improvement
1711	Heating, Plumbing, A/C	Home Improvement
1731	Electrical Contractors	Home Improvement
1740	Masonry, Stonework, and Plaster	Home Improvement
1750	Carpentry Contractors	Home Improvement
1761	Roofing/Siding, Sheet Metal	Home Improvement
1771	Concrete Work Contractors	Home Improvement
1799	Special Trade Contractors	Home Improvement
`2741`	Miscellaneous Publishing and Printing	Printing
`2791`	Typesetting, Plate Making, and Related Services	Printing
`2842`	Specialty Cleaning	Home Services
3000	Default Category For 3000-3301	Air Travel
3351	Default Category For 3351-3441	Rental Car & Taxi
3501	Default Category For 3501-3836	Hotel
`4011`	Railroads	Travel
`4111`	Commuter Transport, Ferries	Travel
`4112`	Passenger Railways	Travel
`4119`	Ambulance Services	Doctor
`4121`	Taxicabs/Limousines	Rental Car & Taxi
`4131`	Bus Lines	Travel
`4214`	Motor Freight Carriers and Trucking	Shipping
`4215`	Courier Services	Shipping
`4225`	Public Warehousing and Storage - Farm Products, Refrigerated Goods	Shipping
`4411`	Cruise Lines	Travel
`4457`	Boat Rentals and Leases	Travel
`4468`	Marinas, Service and Supplies	Travel
`4511`	Airlines, Air Carriers	Air Travel
`4582`	Airports, Flying Fields	Travel
`4722`	Travel Agencies, Tour Operators	Travel
`4723`	TUI Travel - Germany	Travel
`4784`	Tolls/Bridge Fees	Travel
`4789`	Transportation Services (Not Elsewhere Classified)	Travel
`4812`	Telecommunication Equipment and Telephone Sales	Home Phone
`4814`	Telecommunication Services	Home Phone
`4816`	Computer Network Services	Internet
`4821`	Telegraph Services	Bills & Utilities
`4829`	Wires, Money Orders	Transfer
`4899`	Cable, Satellite, and Other Pay Television and Radio	Utilities
`4900`	Utilities	Utilities
`5013`	Motor Vehicle Supplies and New Parts	Service & Parts
`5021`	Office and Commercial Furniture	Furnishings
`5039`	Construction Materials (Not Elsewhere Classified)	Home Improvement
`5044`	Photographic, Photocopy, Microfilm Equipment, and Supplies	Business Services
`5045`	Computers, Peripherals, and Software	Electronics & Software
`5046`	Commercial Equipment (Not Elsewhere Classified)	Shopping
`5047`	Medical, Dental, Ophthalmic, and Hospital Equipment and Supplies	Health & Fitness
`5051`	Metal Service Centers	Home
`5065`	Electrical Parts and Equipment	Home
`5072`	Hardware, Equipment, and Supplies	Home
`5074`	Plumbing, Heating Equipment, and Supplies	Home
`5085`	Industrial Supplies (Not Elsewhere Classified)	Home
`5094`	Precious Stones and Metals, Watches and Jewelry	Shopping
`5099`	Durable Goods (Not Elsewhere Classified)	Shopping
`5111`	Stationary, Office Supplies, Printing and Writing Paper	Office Supplies
`5122`	Drugs, Drug Proprietaries, and Druggist Sundries	Pharmacy
`5131`	Piece Goods, Notions, and Other Dry Goods	Clothing
`5137`	Uniforms, Commercial Clothing	Clothing
`5139`	Commercial Footwear	Clothing
`5169`	Chemicals and Allied Products (Not Elsewhere Classified)	Home
`5172`	Petroleum and Petroleum Products	Gas
`5192`	Books, Periodicals, and Newspapers	Books
`5193`	Florists Supplies, Nursery Stock, and Flowers	Shopping
`5198`	Paints, Varnishes, and Supplies	Home Supplies
`5199`	Nondurable Goods (Not Elsewhere Classified)	Home
`5200`	Home Supply Warehouse Stores	Home
`5211`	Lumber, Building Materials Stores	Home
`5231`	Glass, Paint, and Wallpaper Stores	Home
`5251`	Hardware Stores	Home
`5261`	Nurseries, Lawn and Garden Supply Stores	Lawn & Garden
`5271`	Mobile Home Dealers	Shopping
`5300`	Wholesale Clubs	Shopping
`5309`	Duty Free Stores	Shopping
`5310`	Discount Stores	Shopping
`5311`	Department Stores	Shopping
`5331`	Variety Stores	Shopping
`5399`	Miscellaneous General Merchandise	Shopping
`5411`	Grocery Stores, Supermarkets	Groceries
`5422`	Freezer and Locker Meat Provisioners	Groceries
`5441`	Candy, Nut, and Confectionery Stores	Groceries
`5451`	Dairy Products Stores	Groceries
`5462`	Bakeries	Groceries
`5499`	Miscellaneous Food Stores - Convenience Stores and Specialty Markets	Groceries
`5511`	Car and Truck Dealers (New & Used) Sales, Service, Repairs Parts and Leasing	Auto & Transport
`5521`	Car and Truck Dealers (Used Only) Sales, Service, Repairs Parts and Leasing	Auto & Transport
`5531`	Auto and Home Supply Stores	Auto & Transport
`5532`	Automotive Tire Stores	Auto & Transport
`5533`	Automotive Parts and Accessories Stores	Auto & Transport
`5541`	Service Stations	Gas
`5542`	Automated Fuel Dispensers	Gas
`5551`	Boat Dealers	Auto & Transport
`5561`	Motorcycle Shops, Dealers	Auto & Transport
`5571`	Motorcycle Shops and Dealers	Auto & Transport
`5592`	Motor Homes Dealers	Auto & Transport
`5598`	Snowmobile Dealers	Sporting Goods
`5599`	Miscellaneous Auto Dealers	Auto & Transport
`5611`	Men’s and Boy’s Clothing and Accessories Stores	Clothing
`5621`	Women’s Ready-To-Wear Stores	Clothing
`5631`	Women’s Accessory and Specialty Shops	Clothing
`5641`	Children’s and Infant’s Wear Stores	Clothing
`5651`	Family Clothing Stores	Clothing
`5655`	Sports and Riding Apparel Stores	Clothing
`5661`	Shoe Stores	Clothing
`5681`	Furriers and Fur Shops	Clothing
`5691`	Men’s, Women’s Clothing Stores	Clothing
`5697`	Tailors, Alterations	Clothing
`5698`	Wig and Toupee Stores	Hair
`5699`	Miscellaneous Apparel and Accessory Shops	Clothing
`5712`	Furniture, Home Furnishings, and Equipment Stores, Except Appliances	Furnishings
`5713`	Floor Covering Stores	Furnishings
`5714`	Drapery, Window Covering, and Upholstery Stores	Furnishings
`5718`	Fireplace, Fireplace Screens, and Accessories Stores	Furnishings
`5719`	Miscellaneous Home Furnishing Specialty Stores	Furnishings
`5722`	Household Appliance Stores	Home
`5732`	Electronics Stores	Electronics & Software
`5733`	Music Stores-Musical Instruments, Pianos, and Sheet Music	Music
`5734`	Computer Software Stores	Electronics & Software
`5735`	Record Stores	Music
`5811`	Caterers	Restaurants
`5812`	Eating Places, Restaurants	Restaurants
`5813`	Drinking Places	Alcohol & Bars
`5814`	Fast Food Restaurants	Fast Food
`5815`	Digital Goods Media - Books, Movies, Music	Entertainment
`5816`	Digital Goods - Games	Entertainment
`5817`	Digital Goods - Applications (Excludes Games)	Shopping
`5818`	Digital Goods - Large Digital Goods Merchant	Shopping
`5912`	Drug Stores and Pharmacies	Pharmacy
`5921`	Package Stores-Beer, Wine, and Liquor	Alcohol & Bars
`5931`	Used Merchandise and Secondhand Stores	Clothing
`5932`	Antique Shops	Shopping
`5933`	Pawn Shops	Shopping
`5935`	Wrecking and Salvage Yards	Service & Parts
`5937`	Antique Reproductions	Shopping
`5940`	Bicycle Shops	Sporting Goods
`5941`	Sporting Goods Stores	Sporting Goods
`5942`	Book Stores	Books
`5943`	Stationery Stores, Office, and School Supply Stores	Office Supplies
`5944`	Jewelry Stores, Watches, Clocks, and Silverware Stores	Shopping
`5945`	Hobby, Toy, and Game Shops	Shopping
`5946`	Camera and Photographic Supply Stores	Shopping
`5947`	Gift, Card, Novelty, and Souvenir Shops	Shopping
`5948`	Luggage and Leather Goods Stores	Shopping
`5949`	Sewing, Needlework, Fabric, and Piece Goods Stores	Shopping
`5950`	Glassware, Crystal Stores	Shopping
`5960`	Direct Marketing - Insurance Services	Financial
`5962`	Direct Marketing - Travel	Travel
`5963`	Door-To-Door Sales	Shopping
`5964`	Direct Marketing - Catalog Merchant	Shopping
`5965`	Direct Marketing - Combination Catalog and Retail Merchant	Shopping
`5966`	Direct Marketing - Outbound Tele	Shopping
`5967`	Direct Marketing - Inbound Tele	Shopping
`5968`	Direct Marketing - Subscription	Shopping
`5969`	Direct Marketing - Other	Shopping
`5970`	Artist’s Supply and Craft Shops	Shopping
`5971`	Art Dealers and Galleries	Arts
`5972`	Stamp and Coin Stores	Shopping
`5973`	Religious Goods Stores	Shopping
`5975`	Hearing Aids Sales and Supplies	Health & Fitness
`5976`	Orthopedic Goods - Prosthetic Devices	Health & Fitness
`5977`	Cosmetic Stores	Personal Care
`5978`	Typewriter Stores	Office Supplies
`5983`	Fuel Dealers (Non Automotive)	Gas
`5992`	Florists	Shopping
`5993`	Cigar Stores and Stands	Shopping
`5994`	News Dealers and Newsstands	Books
`5995`	Pet Shops, Pet Food, and Supplies	Pet Food & Supplies
`5996`	Swimming Pools Sales	Home
`5997`	Electric Razor Stores	Personal Care
`5998`	Tent and Awning Shops	Shopping
`5999`	Miscellaneous Specialty Retail	Shopping
6010	Manual Cash Disburse	Cash
6011	Automated Cash Disburse	Cash
6012	Financial Institutions	Financial
6050	Quasi Cash - Member Financial Institution	Uncategorized
6051	Non-FI, Money Orders	Transfer
6211	Security Brokers/Dealers	Investments
6300	Insurance Underwriting, Premiums	Financial
6399	Insurance - Default	Financial
6513	Real Estate Agents and Managers - Rentals	Mortgage & Rent
6536	MoneySend Intracountry	Transfer
6540	Non-Financial Institutions - Stored Value Card Purchase/Load	Uncategorized
7011	Hotels, Motels, and Resorts	Hotel
7012	Timeshares	Vacation
7032	Sporting/Recreation Camps	Vacation
7033	Trailer Parks, Campgrounds	Vacation
7210	Laundry, Cleaning Services	Laundry
7211	Laundries	Laundry
7216	Dry Cleaners	Laundry
7217	Carpet/Upholstery Cleaning	Home Services
7221	Photographic Studios	Shopping
7230	Barber and Beauty Shops	Hair
7251	Shoe Repair/Hat Cleaning	Clothing
7261	Funeral Services, Crematories	Uncategorized
7273	Dating/Escort Services	Entertainment
7276	Tax Preparation Services	Financial
7277	Counseling Services	Doctor
7278	Buying/Shopping Services	Shopping
7296	Clothing Rental	Clothing
7297	Massage Parlors	Spa & Massage
7298	Health and Beauty Spas	Spa & Massage
7299	Miscellaneous General Services	Business Services
7311	Advertising Services	Advertising
7321	Credit Reporting Agencies	Financial
7333	Commercial Photography, Art and Graphics	Business Services
7338	Quick Copy, Repro, and Blueprint	Printing
7339	Secretarial Support Services	Business Services
7342	Exterminating Services	Home
7349	Cleaning and Maintenance	Home
7361	Employment/Temp Agencies	Business Services
7372	Computer Programming	Business Services
7375	Information Retrieval Services	Business Services
7379	Computer Repair	Electronics & Software
7392	Consulting, Public Relations	Business Services
7393	Detective Agencies	Business Services
7394	Equipment Rental	Business Services
7395	Photo Developing	Business Services
7399	Miscellaneous Business Services	Business Services
7511	Truck Stop	Gas
7512	Car Rental Agencies	Rental Car & Taxi
7513	Truck/Utility Trailer Rentals	Rental Car & Taxi
7519	Recreational Vehicle Rentals	Rental Car & Taxi
7523	Parking Lots, Garages	Parking
7531	Auto Body Repair Shops	Service & Parts
7534	Tire Retreading and Repair	Service & Parts
7535	Auto Paint Shops	Service & Parts
7538	Auto Service Shops	Service & Parts
7542	Car Washes	Service & Parts
7549	Towing Services	Service & Parts
7622	Electronics Repair Shops	Electronics & Software
7623	A/C, Refrigeration Repair	Home
7629	Small Appliance Repair	Home
7631	Watch/Jewelry Repair	Shopping
7641	Furniture Repair, Refinishing	Furnishings
7692	Welding Repair	Service & Parts
7699	Miscellaneous Repair Shops	Service & Parts
7800	Government-Owned Lotteries	Entertainment
7801	Government Licensed On-Line Casinos (On-Line Gambling)	Entertainment
7802	Government-Licensed Horse/Dog Racing	Entertainment
7829	Picture/Video Production	Movies & DVDs
7832	Motion Picture Theaters	Movies & DVDs
7841	Video Tape Rental Stores	Movies & DVDs
7911	Dance Hall, Studios, Schools	Entertainment
7922	Theatrical Ticket Agencies	Entertainment
7929	Bands, Orchestras	Entertainment
7932	Billiard/Pool Establishments	Entertainment
7933	Bowling Alleys	Entertainment
7941	Sports Clubs/Fields	Entertainment
7991	Tourist Attractions and Exhibits	Entertainment
7992	Golf Courses - Public	Entertainment
7993	Video Amusement Game Supplies	Entertainment
7994	Video Game Arcades	Entertainment
7995	Betting/Casino Gambling	Entertainment
7996	Amusement Parks/Carnivals	Entertainment
7997	Country Clubs	Entertainment
7998	Aquariums	Entertainment
7999	Miscellaneous Recreation Services	Entertainment
8011	Doctors	Doctor
8021	Dentists, Orthodontists	Dentist
8031	Osteopaths	Doctor
8041	Chiropractors	Doctor
8042	Optometrists, Ophthalmologist	Eyecare
8043	Opticians, Eyeglasses	Eyecare
8044	Opticians, Eyeglasses	Eyecare
8049	Chiropodists, Podiatrists	Doctor
8050	Nursing/Personal Care	Health & Fitness
8062	Hospitals	Doctor
8071	Medical and Dental Labs	Doctor
8099	Medical Services	Doctor
8111	Legal Services, Attorneys	Legal
8211	Elementary, Secondary Schools	Education
8220	Colleges, Universities	Education
8241	Correspondence Schools	Education
8244	Business/Secretarial Schools	Education
8249	Vocational/Trade Schools	Education
8299	Educational Services	Education
8351	Child Care Services	Babysitter & Daycare
8398	Charitable and Social Service Organizations - Fundraising	Gifts & Donations
8641	Civic, Social, Fraternal Associations	Gifts & Donations
8651	Political Organizations	Gifts & Donations
8661	Religious Organizations	Gifts & Donations
8675	Automobile Associations	Gifts & Donations
8699	Membership Organizations	Gifts & Donations
8734	Testing Laboratories	Health & Fitness
8911	Architectural/Surveying Services	Business Services
8931	Accounting/Bookkeeping Services	Business Services
8999	Professional Services	Business Services
9211	Court Costs, Including Alimony and Child Support - Courts of Law	Legal
9222	Fines - Government Administrative Entities	Legal
9223	Bail and Bond Payments	Legal
9311	Tax Payments - Government Agencies	Taxes
9399	Government Services (Not Elsewhere Classified)	Uncategorized
9402	Postal Services - Government Only	Shipping
9405	U.S. Federal Government Agencies or Departments	Taxes
9950	Intra-Company Purchases	Business Services

​Merchant Fields

​Merchant Location Fields

​Merchant Category Codes

Merchant Fields

Merchant Location Fields

Merchant Category Codes