Update Merchant

PUT 
/v1/acquirer/merchants/:id

Updates an existing merchant's information.

Request

Path Parameters

id stringrequired
Example: 0194f9b2-a81e-7979-b3bc-e41d6242ddcd

application/json

Body

name stringrequired
arabic_name stringrequired
merchant_id stringrequired
mcc stringrequired
trading_name stringrequired
cr_number stringrequired
unified_number stringrequired
goods_description stringrequired
website urlrequired
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 stringnullablerequired
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_settingsobjectnullable

assigned_id string

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

Responses

200

Successfully updated merchant

application/json

Schema

Schema

id stringrequired
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

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",
  "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-a68c-7c4f-a71f-ed888c6beb8e",
  "name": "Merchant 7",
  "arabic_name": "الإسم العربي",
  "merchant_id": "2849347",
  "mcc": "5598",
  "trading_name": "Merchant 7",
  "cr_number": "6729327887",
  "unified_number": "460370301339",
  "goods_description": "repellendus suscipit fugit tempora eum voluptatem asperiores repudiandae error doloribus",
  "website": "http://erdman.example/leigh_rath",
  "timezone": "Asia/Riyadh",
  "mada_terminal_id": "MD302095",
  "visa_terminal_id": "VC455050",
  "master_terminal_id": "MC115369",
  "rule_precedence": "acquirer",
  "vault_name": "memory_vault",
  "card_auth_preference": "default",
  "address": {
    "line_1": "3180 Little Ridges",
    "line_2": "6212",
    "city": "Riyadh",
    "state": "Riyadh",
    "country": "SA",
    "zip": "48320",
    "company": "Schoen, Skiles and Schumm"
  },
  "acquirer": {
    "id": "0194f9b2-a50c-7dd6-bf66-8ba64481150a",
    "name": "ac7"
  },
  "visa_settings": {
    "identifier": "19963350",
    "market_indicator": null,
    "verification_value": "2709578647"
  },
  "mastercard_settings": {
    "assigned_id": "491579"
  },
  "created_at": "2025-02-12T10:27:02Z",
  "updated_at": "2025-02-12T10:27:02Z"
}

403

returns forbidden

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "string"
}

Example

{
  "message": "Unauthorized"
}

422

returns validation error

application/json

Schema

Schema

message stringrequired
errorsobjectrequired
name string[]required

Example (from schema)

{
  "message": "string",
  "errors": {
    "name": [
      "string"
    ]
  }
}

Example

{
  "message": "Data validation failed",
  "errors": {
    "name": [
      "This field is missing."
    ]
  }
}

Loading...