使用 PesaBridge API 进行开发。
涵盖收款、付款、托管收银台和 webhooks 的指南,示例可直接粘贴到终端运行。所有功能都先在沙盒中测试。
https://pesa-bridge.com/api/bridgepay/v1
53 个接口 · OpenAPI 3 · 基于 HTTPS 的 JSON
API 参考
小巧而可预期的接口面。
/oauth/token用客户端凭证换取持有者令牌。/partner/stk向客户推送一笔扣款(推送收款)。/partner/status轮询扣款状态。/partner/balance查询收款账户余额。/biz/request商户发起收款请求。/ussdUSSD 菜单网关回调。通道与集成
只接入您市场所需。
通道皆为共用同一接口的可插拔适配器——收款、放款、余额与回调——因此新连接器绝不触及核心。
银行
RTGS / ACH / SWIFT / SEPA 结算与往来账户管理。
移动货币
各个市场的移动货币运营商,通过通道适配器接入。
卡组织与支付服务商
主要卡组织网络的收单与处理机构集成。
账单机构与电信
水电、电视、政府、学费与话费充值。
为资金而设计
一套表现得像支付系统的 API。
多数 API 传输数据,这套 API 流转资金——因此它具备幂等性、已签名,并围绕一个值得信赖的扣款生命周期构建。
认证采用 OAuth2 客户端凭证:您用密钥和密文换取短时有效的持有者令牌。每一次会改变状态的调用都携带幂等键,因此网络重试只会结算一次——这是涉及真金白银时最重要的特性。
一次收款就是一笔扣款。您将其推送至客户号码;推送收款出现在其手机上;客户凭 PIN 码确认。扣款经历 待处理 → 已授权 → 已完成(或已拒绝 / 已过期 / 已失败)的流转,您可通过两种方式获知结果:轮询状态接口,或——更佳地——在状态变更的瞬间接收 Webhook。
Webhook 以 HMAC-SHA256 签名,密钥仅您与 PesaBridge 共享,并带退避重试直至您的端点确认——因此您可放心构建,不必担心事件遗漏或伪造。余额与交易接口为对账闭环收尾,沙盒运行与生产完全一致的契约,让您满怀信心地上线。
扣款生命周期
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}安全与合规
信任即产品。
金融服务的存亡系于正确性与可控性。PesaBridge 将两者都烙进核心。
结构性复式记账
每一次流动都记录平衡的借贷分录——账目始终对账归零。
PIN 码、KYC 与限额
可配置的 KYC 等级、单笔与每日限额、PIN 码尝试次数与钱包锁定。
幂等且可冲正
幂等键杜绝重复扣款;统一冲正引擎可撤销任意业务部门的交易。
签名 Webhook
HMAC-SHA256 签名与重试,让合作系统信任每一次回调。
完整审计追踪
不可篡改的账本分录与交易历史,供监管方与争议处理使用。
分国家合规
证件类型、KYC 规则与费率随市场自动切换,皆由配置驱动。