Engineering · 11 分钟阅读
# 1. Exchange your key pair for a 1-hour token curl -s https://pesa-bridge.com/api/bridgepay/v1/oauth/token \ -H "Content-Type: application/json" \ -d '{"client_id":"pk_test_…","client_secret":"sk_test_…"}' # 2. Push a payment prompt to the customer's phone curl -s https://pesa-bridge.com/api/bridgepay/v1/partner/stk \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"payer_msisdn":"254708374149","amount":250, "reference":"INV-1001","idem":"inv-1001-1"}'← 200 {"charge_ref":"STK0000123","state":"pending"}→ webhook charge.completed KES 250.00 ✓
快速入门
四步完成从零到订单付款
一切都在沙盒中使用测试密钥运行，您可以在任何真实资金流动之前搭建完整流程。
- 1
创建账户
在开发者控制台注册。测试密钥和正式密钥立即发放。
/developer/signup - 2
获取令牌
用密钥对换取有效期一小时的 Bearer 令牌。
POST /oauth/token - 3
向手机发起收款
推送付款请求。客户在自己的手机上用 PIN 确认。
POST /partner/stk - 4
接收 webhook
已签名的 charge.completed 事件通知您的服务器订单已付款。
charge.completed ✓
您可以构建什么
一个 API，搞定收款、付款及相关的一切
12 个分组共 53 个接口，统一的认证方式和统一的错误格式。
为资金而设计
一套表现得像支付系统的 API。
多数 API 传输数据，这套 API 流转资金——因此它具备幂等性、已签名，并围绕一个值得信赖的扣款生命周期构建。
认证采用 OAuth2 客户端凭证：您用密钥和密文换取短时有效的持有者令牌。每一次会改变状态的调用都携带幂等键，因此网络重试只会结算一次——这是涉及真金白银时最重要的特性。
一次收款就是一笔扣款。您将其推送至客户号码；推送收款出现在其手机上；客户凭 PIN 码确认。扣款经历 待处理 → 已授权 → 已完成（或已拒绝 / 已过期 / 已失败）的流转，您可通过两种方式获知结果：轮询状态接口，或——更佳地——在状态变更的瞬间接收 Webhook。
Webhook 以 HMAC-SHA256 签名，密钥仅您与 PesaBridge 共享，并带退避重试直至您的端点确认——因此您可放心构建，不必担心事件遗漏或伪造。余额与交易接口为对账闭环收尾，沙盒运行与生产完全一致的契约，让您满怀信心地上线。
扣款生命周期
pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}API 参考
小巧而可预期的接口面。
POST
/oauth/token用客户端凭证换取持有者令牌。POST
/partner/stk向客户推送一笔扣款（推送收款）。GET
/partner/status轮询扣款状态。GET
/partner/balance查询收款账户余额。POST
/biz/request商户发起收款请求。POST
/ussdUSSD 菜单网关回调。安全与合规
信任即产品。
金融服务的存亡系于正确性与可控性。PesaBridge 将两者都烙进核心。
结构性复式记账
每一次流动都记录平衡的借贷分录——账目始终对账归零。
PIN 码、KYC 与限额
可配置的 KYC 等级、单笔与每日限额、PIN 码尝试次数与钱包锁定。
幂等且可冲正
幂等键杜绝重复扣款；统一冲正引擎可撤销任意业务部门的交易。
签名 Webhook
HMAC-SHA256 签名与重试，让合作系统信任每一次回调。
完整审计追踪
不可篡改的账本分录与交易历史，供监管方与争议处理使用。
分国家合规
证件类型、KYC 规则与费率随市场自动切换，皆由配置驱动。
190+
可上线运营的国家
4
四款原生应用，同一平台
4
渠道 — 应用 · USSD · 网页 · API
100%
复式记账，始终平衡
常见问题
问题，一一解答。
PesaBridge 是共享平台，还是我自己的？
是您自己的。PesaBridge 是 BridgeERP 转售的产品——每家运营商都获得为其定制品牌与配置的专属部署。没有共享数据库，没有共享超级管理员。
支持哪些国家和货币？
任意皆可。国家、货币、语言和 KYC 规则皆为取自完整 ISO 集合的配置——并非硬编码。我们今日已有上线市场，并能无需重写地开通新市场。
它能在功能机上使用吗？
可以。整套钱包通过 USSD 运行——转账、取款、缴费、扫码购物、话费、余额与账单——并在与应用相同的账本上结算。
我能接入自己的银行和支付通道吗？
可以。通道皆为可插拔适配器——银行、移动货币、卡组织和支付服务商——因此您只需接入市场所需。
我们多快能上线？
以周计，而非以年计。配置品牌与国家、接入通道，然后从同一平台交付应用、USSD 代码与网页门户。
它安全且可审计吗？
每一次流动都采用复式记账并平衡归零，受 PIN 码与 KYC 管控，配备签名 Webhook 和面向监管的完整审计追踪。
运营商及其客户能获得哪些应用？
四款原生 Android 应用：面向客户的用户应用，用于存取款和流动资金的代理 / 超级代理应用，用于收款和结算的商户应用，以及支持双人审批批量付款的企业应用（也可作为网页门户使用）。iOS 版本已在规划中。
结算与对账如何运作？
资金实时结算至相应钱包。每一笔交易都生成可对账的平衡账本分录，配有账单与导出，并提供对接您会计系统的总账桥接。
它能处理贷款、储蓄和群组金融吗？
能——透支信贷、带还款计划与风险敞口（PAR）的小额信贷贷款、目标储蓄，以及储蓄群组（互助会 / 轮流会）都是平台的一部分，并按市场逐一开启。
你们支持薪资、援助或补贴的批量发放吗？
可以。企业门户和 API 可向数千个钱包批量付款，支持制单/复核审批、收款人名册、定时发送和完整对账。
日常运营需要哪些工作？
单一的运营商管理控制台即可管理品牌、费率、KYC、代理与商户网络、账本、冲正、支持与关键指标——日常运营无需任何代码。
部署与数据归谁所有？
归您所有。每家运营商运行各自的部署与数据库——为其定制品牌与配置。这是一款您以自有品牌转售的产品，而非共享的 SaaS 租户。
