支付渠道查詢|TokenEpay

支付渠道查詢:

查詢平臺當前已啟用的鏈與代幣組合，用於收銀台展示支付方式，避免把不支援的鏈或代幣硬編碼到前端。

項	值
請求方法	`GET` 或 `POST`
請求地址	{閘道域名}/api/pay/channel?apikey={apikey}

參數名	必填	說明
apikey	是	商戶 API Key
chain_id	否	按真實鏈 ID 篩選，支援 `chain_id=56,1` 不傳返回全部。返回順序與傳入順序一致

響應示例

{
  "code": 1,
  "msg": "success",
  "time": 1792945542,
  "data": {
    "count": 1,
    "list": [
      {
        "chain_id": 56,
        "name": "BNB Smart Chain",
        "for_short": "BNB",
        "icon": "https://gateway.example.com/assets/img/chain/bnb.png",
        "tokens": [
          {
            "token_type": 1,
            "token_name": "USDT",
            "token_icon": "https://gateway.example.com/assets/img/token/usdt.png",
            "chain_token_icon": "https://gateway.example.com/assets/img/token/usdt-bep20.png",
            "token_standard": "BEP20",
            "decimals": 18
          }
        ]
      }
    ]
  }
}

欄位	說明
count	返回的鏈數量
list[].chain_id	鏈 ID，下單時原樣使用
list[].name / for_short / icon	鏈名稱、簡稱與圖示 URL
tokens[].token_type	代幣類型，下單時使用
tokens[].token_name	代幣名稱
tokens[].token_standard	合約標準，如 ERC20 / BEP20 / TRC20
tokens[].decimals	代幣精度，展示金額時使用
token_icon / chain_token_icon	代幣圖示與鏈上代幣圖示 URL

使用建議渠道介面返回的是“當前可用”的鏈與代幣組合，建議在收銀台初始化時動態拉取並快取一段時間；下單失敗時也可重新拉取以重新整理可用列表。