# Create a checkout with the business's publishable key 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"}'<- 200 {"checkout_id":"chk_8Q2T","url":".../pay/chk_8Q2T","status":"open"}-> send the shopper to url
快速开始
五步从获取密钥到正式上线。
- 1
获取密钥
几分钟内即可在开发者门户获取测试和正式密钥。
- 2
创建支付
使用可公开密钥调用一次，即可返回页面地址。
- 3
监听事件
添加 Webhook 端点并验证签名。
- 4
测试每种结果
使用沙盒号码模拟批准、拒绝或超时。
- 5
正式上线
通过上线检查清单，切换到正式密钥。
沙盒
在真实资金流动前测试每种结果。
使用测试密钥时，所有调用都在沙盒中运行。付款人手机号的最后几位决定结果：
| …0002 | 付款人拒绝 |
| …0003 | 余额不足 |
| …0004 | 超时未响应 |
| 其他号码 | 批准 |
工具
开发者期望的一切。
OpenAPI 规范
根据发布的规范生成任意语言的客户端。
控制台与日志
试用接口，查看每个请求、事件和投递。
Webhook 工具
拥有独立密钥的端点、测试事件、托管回显接收器和重放。
幂等性与限流
写操作支持幂等键，错误信息清晰，返回 429 时附重试提示。
事件
付款、退款、争议、结算和订阅事件，类型化并带版本。
上线检查
在基础配置正确之前阻止使用正式密钥的检查清单。
常见问题
运营商常问的问题
有客户端库吗？
提供 cURL、Node.js、Python 和 PHP 代码示例，以及可生成任意语言类型化客户端的 OpenAPI 规范。
测试模式会涉及真实资金吗？
不会。测试密钥只在沙盒中运行；正式密钥会拒绝沙盒数据。
API 变更如何处理？
新增字段不会破坏现有调用，每项变更都记录在更新日志中。