List Merchants

GET 
/v1/acquirer/merchants

Retrieves a list of all merchants associated with the acquirer

Responses

200

Successfully retrieved list of merchants

application/json

Schema

Schema

• Array [

id string
name stringrequired
arabic_name stringrequired
merchant_id stringrequired
mcc stringrequired
trading_name stringrequired
cr_number stringrequired
unified_number stringrequired
goods_description stringrequired
website url
timezone stringrequired
mada_terminal_id stringrequired

Possible values: >= 8 characters and <= 8 characters

visa_terminal_id stringrequired

Possible values: >= 8 characters and <= 8 characters

master_terminal_id stringrequired

Possible values: >= 8 characters and <= 8 characters

rule_precedence stringnullable
vault_name stringnullable
card_auth_preference stringnullable
addressobjectrequired
line_1 stringrequired
line_2 stringrequired
city stringrequired
state stringrequired
country stringrequired
Possible values: Value must match regular expression ^[A-Z]{2}$
zip stringrequired
company stringrequired
visa_settingsobjectnullable
identifier string
Possible values: >= 8 characters and <= 8 characters
verification_value string
Possible values: >= 10 characters and <= 10 characters
market_indicator stringnullable

mastercard_settings

objectnullable

assigned_id string

Possible values: >= 6 characters and <= 6 characters

created_at stringrequired
updated_at stringrequired

• ]

Example (from schema)

[
  {
    "id": "string",
    "name": "string",
    "arabic_name": "string",
    "merchant_id": "string",
    "mcc": "string",
    "trading_name": "string",
    "cr_number": "string",
    "unified_number": "string",
    "goods_description": "string",
    "website": "string",
    "timezone": "string",
    "mada_terminal_id": "string",
    "visa_terminal_id": "string",
    "master_terminal_id": "string",
    "rule_precedence": "string",
    "vault_name": "string",
    "card_auth_preference": "string",
    "address": {
      "line_1": "string",
      "line_2": "string",
      "city": "string",
      "state": "string",
      "country": "string",
      "zip": "string",
      "company": "string"
    },
    "visa_settings": {
      "identifier": "string",
      "verification_value": "string",
      "market_indicator": "string"
    },
    "mastercard_settings": {
      "assigned_id": "string"
    },
    "created_at": "string",
    "updated_at": "string"
  }
]

Example

[
  {
    "id": "0194f9b2-9c42-7a2c-adf3-532a310fe172",
    "name": "Merchant 1",
    "arabic_name": "الإسم العربي",
    "merchant_id": "4738211",
    "mcc": "3114",
    "trading_name": "Merchant 1",
    "cr_number": "6049108673",
    "unified_number": "669707591354",
    "goods_description": "distinctio dicta nemo aut tempore ipsa assumenda dolor animi qui",
    "website": "http://ondricka-adams.example/tyrone_wisozk",
    "timezone": "Asia/Riyadh",
    "mada_terminal_id": "MD323396",
    "visa_terminal_id": "VC766964",
    "master_terminal_id": "MC545756",
    "rule_precedence": "acquirer",
    "vault_name": "memory_vault",
    "card_auth_preference": null,
    "address": {
      "line_1": "5088 Gilberto Trafficway",
      "line_2": "3731",
      "city": "Riyadh",
      "state": "Riyadh",
      "country": "SA",
      "zip": "01264-6155",
      "company": "Steuber-Zieme"
    },
    "acquirer": {
      "id": "0194f9b2-99bf-778c-9b7d-9d51bfb61c3d",
      "name": "ac1"
    },
    "visa_settings": {
      "identifier": "79999563",
      "market_indicator": null,
      "verification_value": "9687567350"
    },
    "mastercard_settings": {
      "assigned_id": "536651"
    },
    "created_at": "2025-02-12T10:26:59Z",
    "updated_at": "2025-02-12T10:26:59Z"
  },
  {
    "id": "0194f9b2-9c53-75f6-bdb8-e782c59cfb7f",
    "name": "Merchant 2",
    "arabic_name": "الإسم العربي",
    "merchant_id": "7178842",
    "mcc": "3262",
    "trading_name": "Merchant 2",
    "cr_number": "1859492394",
    "unified_number": "686493484409",
    "goods_description": "ad et id quae nihil facilis fugit quod facere asperiores",
    "website": "http://champlin.test/malcom_bergstrom",
    "timezone": "Asia/Riyadh",
    "mada_terminal_id": "MD411423",
    "visa_terminal_id": "VC276865",
    "master_terminal_id": "MC768150",
    "rule_precedence": "mixed",
    "vault_name": "memory_vault",
    "card_auth_preference": null,
    "address": {
      "line_1": "354 Kautzer Forge",
      "line_2": "8576",
      "city": "Riyadh",
      "state": "Riyadh",
      "country": "SA",
      "zip": "26447-0634",
      "company": "Ortiz Inc"
    },
    "acquirer": {
      "id": "0194f9b2-99bf-778c-9b7d-9d51bfb61c3d",
      "name": "ac1"
    },
    "visa_settings": {
      "identifier": "21356068",
      "market_indicator": null,
      "verification_value": "5744358486"
    },
    "mastercard_settings": {
      "assigned_id": "538525"
    },
    "created_at": "2025-02-12T10:26:59Z",
    "updated_at": "2025-02-12T10:26:59Z"
  }
]

Loading...