List Merchant Payment Controls

GET 
/v1/acquirer/merchants/:merchant_id/payment_controls/:type

List the payment controls of a single merchant for the given identifier type.

Required permission: payment_controls_read.

Request

Path Parameters

merchant_id stringrequired

Acquirer-assigned merchant identifier (the merchant_id field of the merchant, not its internal UUID).

type stringrequired

Possible values: [bin_range, bin_country, pan, fingerprint, ip, ip_country, eci, tds_status]

The identifier type of the rules to operate on.

Responses

200

Payment controls of the requested type.

application/json

Schema

Schema

• Array [

id uuidrequired

A 36-character UUIDv7 identifier.

identifier_type stringrequired

Possible values: [bin_range, bin_country, pan, fingerprint, ip, ip_country, eci, tds_status]

identifier stringrequired
owner_type stringrequired

Possible values: [Acquirer, Merchant]

Whether the rule is acquirer-level or merchant-level.

owner_id uuidrequired

A 36-character UUIDv7 identifier.

activity stringrequired

Possible values: [allow, deny]

created_at date-timerequired

ISO 8601 UTC timestamp with time zone designator.

updated_at date-timerequired

ISO 8601 UTC timestamp with time zone designator.

• ]

Example (from schema)

[
  {
    "id": "0191f5a7-3d99-7f81-b7ec-962a5f5fdd7c",
    "identifier_type": "bin_range",
    "identifier": "SA",
    "owner_type": "Acquirer",
    "owner_id": "0191f5a7-3d99-7f81-b7ec-962a5f5fdd7c",
    "activity": "allow",
    "created_at": "2025-01-15T14:30:00Z",
    "updated_at": "2025-01-15T14:30:00Z"
  }
]

400

Business rule violation.

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "Invalid type"
}

401

Authentication failed.

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "Missing authentication information"
}

403

The API key lacks the required permission.

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "Unauthorized"
}

404

The referenced resource does not exist or belongs to another acquirer.

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "The Order you are looking for was not found."
}

Loading...