PesaBridge
开发者文档

使用 PesaBridge API 进行开发。

涵盖收款、付款、托管收银台和 webhooks 的指南,示例可直接粘贴到终端运行。所有功能都先在沙盒中测试。

基础 URL

https://pesa-bridge.com/api/bridgepay/v1

POST/oauth/token
POST/partner/stk
GET/partner/status
POST/partner/b2c
POST/checkout/create
POST/partner/webhooks/endpoints

53 个接口 · OpenAPI 3 · 基于 HTTPS 的 JSON

API 参考

小巧而可预期的接口面。

POST/oauth/token用客户端凭证换取持有者令牌。
POST/partner/stk向客户推送一笔扣款(推送收款)。
GET/partner/status轮询扣款状态。
GET/partner/balance查询收款账户余额。
POST/biz/request商户发起收款请求。
POST/ussdUSSD 菜单网关回调。

通道与集成

只接入您市场所需。

通道皆为共用同一接口的可插拔适配器——收款、放款、余额与回调——因此新连接器绝不触及核心。

银行

RTGS / ACH / SWIFT / SEPA 结算与往来账户管理。

移动货币

各个市场的移动货币运营商,通过通道适配器接入。

卡组织与支付服务商

主要卡组织网络的收单与处理机构集成。

账单机构与电信

水电、电视、政府、学费与话费充值。

为资金而设计

一套表现得像支付系统的 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…"
}

安全与合规

信任即产品。

金融服务的存亡系于正确性与可控性。PesaBridge 将两者都烙进核心。

结构性复式记账

每一次流动都记录平衡的借贷分录——账目始终对账归零。

PIN 码、KYC 与限额

可配置的 KYC 等级、单笔与每日限额、PIN 码尝试次数与钱包锁定。

幂等且可冲正

幂等键杜绝重复扣款;统一冲正引擎可撤销任意业务部门的交易。

签名 Webhook

HMAC-SHA256 签名与重试,让合作系统信任每一次回调。

完整审计追踪

不可篡改的账本分录与交易历史,供监管方与争议处理使用。

分国家合规

证件类型、KYC 规则与费率随市场自动切换,皆由配置驱动。

遇到问题了?

我们的工程师解答集成问题。把请求参考号发给我们,我们会找到那次调用。