Merchants Overview
Merchants are representations of a transaction’s origin. For example, if you buy a coffee at Starbucks, the transaction merchant will be Starbucks.
Use the merchant_guid and a merchant_location_guidon 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 |
| 7829 | Picture/Video Production | Movies & DVDs |
| 7800 | Government-Owned Lotteries | Entertainment |
| 7801 | Government Licensed On-Line Casinos (On-Line Gambling) | Entertainment |
| 7802 | Government-Licensed Horse/Dog Racing | Entertainment |
| 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 |