Engineering · 11 分钟阅读
深入了解
开发者 API 为资金而生，而非仅仅为请求而生。您用客户端凭证换取短时令牌，然后向客户推送一笔扣款；客户在钱包中确认，一旦清算完成您即收到签名 Webhook。每一次调用都具备幂等性，因此连接中断后的重试绝不重复扣款。
一笔扣款经历清晰的生命周期——待处理、已授权、已完成、已拒绝或已过期——您可轮询或经 Webhook 接收。Webhook 以 HMAC-SHA256 签名并重试直至确认，因此您的系统可信任每一次回调，余额与交易查询让您得以对账。沙盒运行与生产相同的契约，通道被抽象在 API 之后，因此您只需集成一次，即可切换供应商而无需改动代码。
为何重要
为值得信赖而生。
- OAuth2 客户端凭证，含沙盒与生产环境密钥。
- 推送收款（STK Push）配合状态轮询。
- HMAC-SHA256 签名并重试的 Webhook，您的系统可信赖。
内含什么
开发者 API — 详解。
01
OAuth2 令牌
用客户端凭证换取持有者令牌。
02
扣款与状态
推送一笔扣款并轮询其生命周期。
03
Webhook
扣款清算的瞬间发出签名回调。
04
余额与历史
查询收款余额与交易。
真实流程
实际如何运作。
在此能力所处理的各段旅程间切换。每一段都核查余额与限额，然后等待 PIN 码或生物识别授权，再向账本记录平衡分录。
商户推送（STK）
商户推动一笔扣款走完其生命周期；客户批准推送。
以PIN 码或生物识别授权 ——在客户确认之前，账本不会记录任何分录。
- 首先核查余额与限额
- 校验 / 授权关卡
- 已记录平衡的借贷分录
客户
系统
01
系统商户推送一笔扣款
02
系统创建扣款 · 状态 = 待处理
客户手机上出现推送
03
04
系统 · 校验校验并核查余额
客户 · 校验授权——PIN 码或生物识别
05
06
系统借记付款方，贷记商户
07
系统状态 = 已完成
08
系统签名 Webhook + 重试直至确认
系统 · 完成已支付 ✓ · 显示回执
步骤 校验 / PIN 码 已完成
190+
可上线运营的国家
4
四款原生应用，同一平台
4
渠道 — 应用 · USSD · 网页 · API
100%
复式记账，始终平衡
更多平台能力
