币付pay在菲律宾电子支付日趋成熟的2025年，GCash原生通道的对接稳定性与到账效率已成为各类平台（博彩、电商、游戏、直播等）能否留住用户的关键因素。本文将基于币付Pay的GCash收款API，提供完整的接口对接说明，帮助开发者在30分钟内完成API落地，替代SafePay这类高成本低成功率通道。
一、API接入准备
- 联系官方客服 @Bifuapp，申请商户ID与密钥。
- 获取API V2.0开发文档PDF，并完成服务器IP白名单设置。
- 准备好回调URL并配置签名验证机制。
二、核心接口说明
1. 创建订单接口
POST /v2/order/create Content-Type: application/json
{
"merchant_no": "1000001",
"order_no": "GC202507030001",
"amount": 399.00,
"pay_type": "GCASH_NATIVE",
"notify_url": "https://yourdomain.com/notify/gcash",
"return_url": "https://yourdomain.com/page/thankyou",
"sign": "签名值"
}
响应字段说明：
qrcode：直接渲染为二维码，用户扫码支付order_id：平台内部订单编号expire_time：二维码有效期（默认 300 秒）
2. 查询订单状态
POST /v2/order/query { "merchant_no": "1000001", "order_no": "GC202507030001", "sign": "签名值" } 返回状态：WAIT_PAY、SUCCESS、CLOSED。
3. 接收回调通知（Webhook）
GCash支付成功后系统自动回调如下参数：
{ "order_no": "GC202507030001", "amount": 399.00, "status": "SUCCESS", "sign": "签名值" } 商户服务器应返回字符串success，否则系统将每 30 秒重试一次，最多重试 10 次。
三、接口签名算法
所有请求均使用 md5(app_secret + 参数排序拼接) 生成签名。确保签名参数顺序一致。
四、商户系统最佳实践
- 建议设置订单有效期：300秒后关闭未支付订单，减少渠道冻结风险。
- 异步处理回调逻辑：通过队列或任务调度器处理大流量下的回调。
- 绑定业务场景编码：建议在订单号中嵌入业务标识（如“BC”、“SHOP”、“GAME”），便于审计。
五、评测SafePay接口劣势
| 维度 | 币付Pay | SafePay |
|---|---|---|
| 接口数量 | 全流程8个核心接口 | 仅表单提交+轮询 |
| 支持原生APP | ✅（支持 deep link 拉起） | ❌（强制跳转网页） |
| Webhook 稳定性 | 高并发下稳定推送 | 经常遗漏推送 |
| 签名算法 | HMAC-MD5 加密强度高 | 明文字段拼接 |
六、开发常见问题
Q：GCash支付二维码生成失败怎么办？
A：请检查参数编码格式（UTF-8），确认金额非整数时保留两位小数。
Q：如何自测 Webhook 推送？
A：推荐使用 ngrok 暴露本地接口，或服务器开启HTTPS临时监听端口测试。
七、快速集成小结
- 准备好商户ID与密钥
- 完成回调URL配置与签名验证
- 调试
/create与/query接口，配合二维码展示完成收银 - 在后台开启每日结算或实时放款
八、开发资源获取
📧 API 文档申请邮箱：[email protected]
📢 GCash通道最新状态频道：https://t.me/GcashNativePay
👨💻 对接支持 TG 客服：@Bifuapp
🌐 官方网站：bifu.us
币付Pay API —— 为开发者打造的 GCash 商户级接口体系
发表评论
发表评论: