# 用商户的可公开密钥创建收银台会话 curl -s https://pesa-bridge.com/api/bridgepay/v1/checkout/create \ -H "Content-Type: application/json" \ -d '{"key":"pk_test_...","amount":4800,"currency":"KES", "reference":"ORDER-1042", "success_url":"https://shop.example/thanks", "cancel_url":"https://shop.example/cart"}' # then send the shopper to the url in the reply<- 200 {"checkout_id":"chk_8Q2T","url":".../pay/chk_8Q2T","status":"open"}
快速开始
五步从获取密钥到正式上线。
- 1
获取密钥
几分钟内即可在开发者门户获取测试和正式密钥。
- 2
创建支付
使用可公开密钥调用一次,即可返回页面地址。
- 3
监听事件
添加回调通知端点并验证签名。
- 4
测试每种结果
使用沙盒号码模拟批准、拒绝或超时。
- 5
正式上线
通过上线检查清单,切换到正式密钥。
沙盒
在真实资金流动前测试每种结果。
使用测试密钥时,所有调用都在沙盒中运行。付款人手机号的最后几位决定结果:
| …0002 | 付款人拒绝 |
| …0003 | 余额不足 |
| …0004 | 超时未响应 |
| 其他号码 | 批准 |


常见问题
运营商常问的问题
有客户端库吗?
提供 cURL、Node.js、Python 和 PHP 代码示例,以及可生成任意语言类型化客户端的 OpenAPI 规范。
测试模式会涉及真实资金吗?
不会。测试密钥只在沙盒中运行;正式密钥会拒绝沙盒数据。
API 变更如何处理?
新增字段不会破坏现有调用,每项变更都记录在更新日志中。