Z Zise Developers
/
全球收单 › API 参考 › 扫码付

扫码付只读配置（可付资产 · 余额 · 费率 · 限额）

GET /v1/qrpay/config scope: qrpay:read
代会员调用 · 必带 x-on-behalf-of

收银台开屏读这一条。available: false 时 reason 告诉你为什么，assets 是空数组。

── assets 是服务端过滤后的清单 ──原样用产品配置里那一串的话，运营下架某个资产之后，用户会走到最后一步才被拒。顺序按该会员自己的支付优先级排 ——第一行就是默认要扣的那个。

⚠ 扣款币种不由你指定。 POST /v1/qrpay/payments 的preferred_asset 只是「优先试这个」，合法取值就是这里的 assets[].asset。

── 费率只有明面两项 ── fee_bps 与 fee_fixed。汇率溢价与成本折让是毛利参数，一列都不出站。

── 限额 ──金额一律是格式化后的人读串，位数由 limits.ledger_scale 给。"" 表示没有这一档（不限）。kyc_trigger_amount 是「超过它要 L1」的门槛，"" 表示不设门槛 —— 不是「一律要实名」。

⚠ require_step_up 恒为 true：扫码付每一笔都要终端用户在我方托管屏上确认。下发这一位是为了让你能提前把那一跳画进流程，而不是等 POST /v1/qrpay/payments 回 400 才知道。

字段类型必填说明
x-on-behalf-of string 必填

响应

200OK
{
  "available": true,
  "assets": [
    {
      "asset": "USDT",
      "ledger_scale": 6,
      "display_scale": 2,
      "balance": "520.000000"
    }
  ],
  "pricing": {
    "fee_bps": 50,
    "fee_fixed": "0.000000"
  },
  "limits": {
    "ledger_scale": 6,
    "min_amount": "1.000000",
    "single_limit": "2000.000000",
    "daily_limit": "5000.000000",
    "kyc_trigger_amount": "500.000000"
  },
  "require_step_up": true
}
请求 
curl -X GET 'https://api.zise.com/v1/qrpay/config' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zise.com/v1/qrpay/config", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.get(
    "https://api.zise.com/v1/qrpay/config",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("GET", "https://api.zise.com/v1/qrpay/config",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/qrpay/config"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zise.com/v1/qrpay/config');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
200 
{
  "available": true,
  "assets": [
    {
      "asset": "USDT",
      "ledger_scale": 6,
      "display_scale": 2,
      "balance": "520.000000"
    }
  ],
  "pricing": {
    "fee_bps": 50,
    "fee_fixed": "0.000000"
  },
  "limits": {
    "ledger_scale": 6,
    "min_amount": "1.000000",
    "single_limit": "2000.000000",
    "daily_limit": "5000.000000",
    "kyc_trigger_amount": "500.000000"
  },
  "require_step_up": true
}