Merchants

Get matched merchant information for a given card acceptor id

Returns merchant details for matched merchants given a card acceptor id and optional country code. (IMPORTANT - Only card acceptor ids that can be uniquely mapped to one merchant location are accepted)

get/merchants-by-card-acceptor-ids

Request

Base URL
https://api.mastercard.com/merchant-identifier
Auth
none declared
TypeScript
https://skmtc.dev/mastercard/apis/merchant-identifier-api/docs/merchants-by-card-acceptor-ids/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

card_acceptor_idstring required

Card Acceptor Id

country_codestring

ISO 3166-1 alpha-3 country code of card acceptor id

Response

Information for this merchant identifier

Example response

{
  "merchants": [
    {
      "address": {
        "line1": "UNIT 2 248 WELSHPOOL RD",
        "line2": "12",
        "city": "Springfield",
        "postalCode": "6106",
        "country": {
          "code": "AUS",
          "name": "Australia"
        },
        "countrySubdivision": {
          "code": "WA",
          "name": "Western Australia"
        }
      },
      "brandName": "DOLIUM PTY LTD",
      "phoneNumber": "893582575",
      "merchantCategory": "5533 - AUTOMOTIVE PARTS  ACCESSORIES STORES",
      "merchantDbaName": "DOLIUM PTY LTD",
      "cardAcceptorId": "C928456",
      "legalCorporateName": "DOLIUM PTY LTD",
      "locationId": 344147943,
      "isBrickAndMortar": true,
      "isEcommerce": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.