菲律宾 GCash 原生支付已成为本地各行业代收主流手段，尤其在博彩、电商、游戏充值等领域中，API 对接成为资金效率与风控合规的核心保障。本文将详细介绍 币付Pay GCash API 的对接流程，从接口结构、验证机制、回调逻辑到风控策略，帮助开发者 1 日内实现完整接入。

一、接口简介（RESTful）

• 支持参数签名验证（MD5 或 RSA）
• 每笔交易均有订单号、交易号、状态码
• 金额单位：PHP，支持小数

二、创建订单字段说明

 { "merchant_id": "12345678", "order_no": "ORD168XXXX", "amount": "1500.00", "notify_url": "https://example.com/notify", "sign": "xxxxx", "timestamp": 1720000000 } 

• merchant_id：平台分配的商户号
• order_no：商户订单号，唯一性保障
• amount：支付金额（PHP），需大于 1
• notify_url：订单回调通知地址（需公网可访问）
• sign：签名字段（默认 MD5）
• timestamp：时间戳，用于防止重放攻击

三、回调参数与验签逻辑

GCash 支付完成后，平台将向 notify_url 推送订单结果。建议使用签名校验机制确保来源可信：

 { "order_no": "ORD168XXXX", "gcash_txn_id": "TXN123456", "status": "SUCCESS", "amount": "1500.00", "sign": "xxxxx" } 

验签方式：将所有字段按参数名排序后拼接+密钥，再执行 MD5 加密，与 sign 字段比对。

四、常见错误码列表

五、风控机制与接入建议

• IP 限频：建议 QPS ≤ 1000
• 金额校验：同一用户每日不超 50 000 PHP
• Webhook 重推机制：未返回 200 OK 会自动重试 3 次

六、接入流程

1. 联系 @Bifuapp 获取商户信息与密钥
2. 联调 /v1/order/create 接口
3. 配置 notify_url
4. 测试回调与验签
5. 上线生产环境

七、参考与支持

✅ 文档官网：https://bifu.us/post/4985.html
📮 客服邮箱：[email protected]
📢 渠道通知频道：https://t.me/GcashNativePay

币付Pay · 菲律宾 GCash 聚合支付服务商
Copyright © 2025 Bifu.us