Zise Developers

Zise 业务线 API

发卡 · 汇款 · 扫码付 · 兑换 · 站内转账 · 理财。

状态枚举的纪律（必须传导给你的实现）

收到未知状态值时按未知处理并告警，不要 fallback 成「处理中」。

我方承诺新增枚举值时提前通知并在变更日志登记；你的 default 分支

不该假装认识它。

报价与出款的幂等纪律相反

搞反的后果分别是「第二笔真实付款」和「拿着过期报价下单」。

强认证

需强认证的动作返回 400 step_up_required + hosted_url。

终端用户在我方托管屏完成后，重发同一请求（同幂等键）并带

x-step-up: <challenge_id>。

⚠ 我方绝不接受请求体里的 step_up_passed: true。

端点

GET/v1/cards/products
可申请的卡产品（按商户授权的 BIN 过滤）
Scope cards:read · 作用域 商户
GET/v1/cards
卡列表（**前六后四**，永不含完整卡号）
Scope cards:read · 作用域 会员（需 x-on-behalf-of）
POST/v1/cards/applications
提交开卡申请（虚拟/实体经 form_factor 区分）
Scope cards:write · 作用域 会员（需 x-on-behalf-of）
GET/v1/cards/applications/{id}
申请状态
Scope cards:read · 作用域 会员（需 x-on-behalf-of）
POST/v1/cards/{id}/secure-session
换取一次性卡密查看票据

返回的是一个指向我方托管页的一次性 URL，卡密从上游实时拉取后

直接渲染给终端用户。卡密永不经商户服务器。

Scope cards:secure · 作用域 会员（需 x-on-behalf-of）
GET/v1/remit/corridors
可用走廊（按商户授权过滤）
Scope remittances:read · 作用域 商户
GET/v1/remittances/{id}
汇款订单详情

⚠ 出参不含上游成本与我方毛利。你看到的是「这笔业务扣了你多少」。

按 status_version 做向前合并（只许向前更新）——

少了它，慢响应会把「已到账」打回「处理中」。

Scope remittances:read · 作用域 会员（需 x-on-behalf-of）
GET/v1/qrpay/orders/{id}
扫码付订单详情
Scope qrpay:read · 作用域 会员（需 x-on-behalf-of）
GET/v1/exchange/pairs
币对（**按方向配**：A→B 与 B→A 是两条独立记录）
Scope exchange:read · 作用域 商户
GET/v1/transfers/{id}
站内转账详情（原子、不可逆、无中间态）
Scope transfers:read · 作用域 会员（需 x-on-behalf-of）
GET/v1/earn/products
理财产品（按 grant_scope + 授权表过滤）
Scope earn:read · 作用域 商户
GET/v1/earn/positions
持仓与累计收益

⚠ 续期枚举是 principal_interest，不是 both。

申购接口对认不出的值是静默回落到产品默认 —— 传错了不会报错，

成交的是别的档。

Scope earn:read · 作用域 会员（需 x-on-behalf-of）