Z Zise Developers
全球收单 › 指南

码制、可支付资产、支付授权票据 —— 三个词。

核心概念

码制

不同地区的收款码格式不同。用GET /v1/qrpay/schemes拿我方给你开了哪些。

认不出的码一律当场拒,不猜。猜错的表现是钱付给了另一个商户。

可支付资产

报价按会员当前能付的每一种资产各给一份。他余额里没有的、或者这条码不支持的,都不在清单里。

清单为空不是故障 —— 它的意思是「这个会员现在付不了这笔」。界面上要说清是哪一种:余额不够,还是这条码不支持他持有的资产。

扣款资产的挑法

扣款币种不由你指定。 我方按该会员自己的支付设置里的优先级挑。

preferred_asset 只是「优先试这个」——而且指定了一个上游这次报不出价的资产会直接拒,不会静默换一个。悄悄换个币扣钱是替用户做决定。

⚠ 我方自营 App 里那道「支付授权票据 + 强认证」的闸不在开放 API 上 ——

在这个模型下会员的身份与安全归你管,所以那一层由你自己按需要加。

你这一侧至少要保证:payments 的那一刻,用户真的按了确认。

顺序不可颠倒


① 先锁会员的钱
② 再通知上游放行

颠倒的表现是:上游放了行(商户那边显示已收款),而我方没锁到钱。那笔差额没有任何办法追回。