> ## Documentation Index
> Fetch the complete documentation index at: https://docs-payment-merchant.keysecure.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取支持卡 BIN

获取支持的卡 BIN 列表（**授权模式**）。

## 请求头

<ParamField header="Api-Key" type="string" required placeholder="your_api_key">
  apiKey（商户凭证，与 IP 白名单绑定）
</ParamField>

<ParamField header="Timestamp" type="string" required>
  Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
</ParamField>

<ParamField header="Access-Token" type="string" required placeholder="your_access_token">
  登录标识（除获取 Token 外必填）
</ParamField>

<ParamField header="Content-Type" type="string" default="application/json">
  固定为 `application/json`
</ParamField>

## 请求体

<ParamField body="card_bin_no" type="string">
  卡 BIN 单号
</ParamField>

<ParamField body="page" type="number" default="0">
  查询页码，默认 `0`
</ParamField>

<ParamField body="size" type="number" default="10">
  查询条数，默认 `10`（最多 100 条）
</ParamField>

## 返回参数

<ResponseField name="code" type="number">
  响应状态码，`0` 表示成功
</ResponseField>

<ResponseField name="msg" type="string">
  响应消息
</ResponseField>

<ResponseField name="data" type="object">
  返回数据

  <Expandable title="data">
    <ResponseField name="list" type="object[]">
      BIN 列表

      <Expandable title="list">
        <ResponseField name="card_bin_no" type="string">卡 BIN 单号</ResponseField>
        <ResponseField name="card_bin" type="string">卡 BIN</ResponseField>
        <ResponseField name="organization" type="string">卡组织</ResponseField>
        <ResponseField name="support_physical" type="boolean">是否支持实体卡（true-支持，false-不支持）</ResponseField>
        <ResponseField name="support_virtual" type="boolean">是否支持虚拟卡（true-支持，false-不支持）</ResponseField>
        <ResponseField name="currencies" type="string[]">卡基础币种</ResponseField>

        <ResponseField name="balance_limit" type="object">
          卡 BIN 限额信息

          <Expandable title="balance_limit">
            <ResponseField name="limit_balance" type="string">终身限额</ResponseField>
            <ResponseField name="limit_week_balance" type="string">每周限额</ResponseField>
            <ResponseField name="limit_atm_day_balance" type="string">ATM 每天限额</ResponseField>
            <ResponseField name="limit_atm_month_balance" type="string">ATM 每月限额</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --request POST \
    --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/support/bins \
    --header 'Content-Type: application/json' \
    --header 'Api-Key: your_api_key' \
    --header 'Timestamp: 1716307200000' \
    --header 'Access-Token: your_access_token' \
    --data '{
      "card_bin_no": "",
      "page": 0,
      "size": 10
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "code": 0,
    "msg": "Success",
    "data": {
      "list": [{
        "card_bin_no": "",
        "card_bin": "",
        "organization": "",
        "support_physical": true,
        "support_virtual": true,
        "currencies": ["USD"],
        "balance_limit": {
          "limit_balance": "",
          "limit_week_balance": "",
          "limit_atm_day_balance": "",
          "limit_atm_month_balance": ""
        }
      }]
    }
  }
  ```
</ResponseExample>