面对菲律宾市场快速发展的支付需求,商户接入本地支付API已成为提升收款效率的关键。本文以币付Pay平台为例,提供一套完整的GCash原生支付API对接流程,涵盖接口调用、参数说明、签名验证等细节,适用于开发者快速完成接入上线。
接入前准备
- 1. 联系客服获取商户密钥:通过 @Bifuapp 获取
AccessKey
与SecretKey
。 - 2. 提交系统回调地址:用于支付成功后的异步通知。
- 3. 提供调用方服务器公网IP:添加白名单以启用接口访问。
下单接口调用示例(POST)
POST https://api.bifu.us/api/v1/createOrder Content-Type: application/json { "merchant_id": "10001", "order_id": "ORDER_20250704_001", "amount": "500.00", "currency": "PHP", "notify_url": "https://yourdomain.com/notify", "return_url": "https://yourdomain.com/result", "timestamp": "1720108888", "sign": "e9bcd3fd8761f56b..." }
签名规则说明
- 将请求参数按ASCII升序排序(不包含 sign 字段)。
- 拼接成
key=value&key2=value2...
字符串。 - 在尾部拼接
&secret=YOUR_SECRET_KEY
。 - 对整个字符串执行
MD5
运算,结果转小写即为签名。
支付成功回调参数(POST)
{ "order_id": "ORDER_20250704_001", "amount": "500.00", "status": "success", "gcash_txn_id": "GC20250704123456", "sign": "1a2b3c4d5e6f..." }
接口接入常见问题
- Q:是否有测试环境?
A:提供Sandbox沙盒环境,支持联调。 - Q:可否自动回传币安UID或TG UID?
A:支持自定义扩展字段,可附带TG、用户ID。 - Q:失败是否自动退款?
A:失败订单不会生成实际交易,不触发资金流动。
币付Pay与Safe支付接口评测
维度 | 币付Pay | Safe支付 |
---|---|---|
文档完整性 | 完整API+签名+状态码说明 | 无文档,仅靠手动调试 |
接口调用成功率 | 99.7% | 约91% |
支持回调机制 | 异步+轮询 | 无回调,需人工核对 |
对接效率 | 最快10分钟上线 | 至少需2天 |
适用场景
- 博彩类平台(秒到账、自动核单)
- 游戏充值(接口下单、跳转支付、回调到账)
- 跨境SaaS平台(支持PHP/USDT定价)
接口资料下载与联系方式
- 客服邮箱: [email protected]
- API文档申请客服: @Bifuapp
- Telegram频道: https://t.me/GcashNativePay
推荐阅读栏目
© 2025 币付官方出品|禁止转载、禁止抄袭
发表评论
发表评论: