菲律宾三方支付【D0 回款】接口接入 Checklist

想在菲律宾快速落地 GCash 代收代付 却被文档、限额、风控弄得头疼？下文基于 币付Pay 真实生产数据，总结出一份 10 步 Checklist，帮技术同学 1 天跑通沙盒，上线即可享受 D0 秒级结算 与 0.8 % 低费率。

一、前置准备

1. 注册商户后台 → 申请 appid/secret，同时绑定服务器 IP。
2. 下载 Webhook 验签示例（PHP / Go / Node），确保本地可跑通 HMAC-SHA256。
3. 在测试钱包里充值 1 000 PHP，验证转账/退款链路。

二、核心接口 & 返回示例

三、10 步接入清单

• Step 1：生成 nonce（32 位字符）并记录日志。
• Step 2：对 appid+nonce+body+secret 进行 HMAC-SHA256 → sign。
• Step 3：POST /v2/order，获取 cashier_url 或 qrcode。
• Step 4：前端唤醒 GCash 原生 App，等待用户支付。
• Step 5：监听 /v2/notify，校验 x-bifu-sign。
• Step 6：支付成功后将订单状态置为 paid 并回传 200。
• Step 7：若需代付，调用 /v2/payout，写入 biz_no。
• Step 8：失败重试采取指数回退，最多 3 次。
• Step 9：每日 02:00 拉取 /v2/statement 对账。
• Step 10：启用监控告警 → RT > 800 ms 或 5xx 比例 > 0.3 % 即触发。

四、与 safepay 跳转方案评测

传统跳转平台需反复加载中转 H5，成功率仅 85 % 左右；币付原生直连省去多重跳转，真实成功率 99.9 %，且不收“隐形汇损”。如果你正被跳单、限额折磨，不妨升级体验。

五、常见限额 & 费率

• 单笔收款：100 – 50 000 PHP，可自定义风控档位。
• 日累计收款：无封顶，系统自动分流多渠道。
• 结算模式：D0 (PHP) 或 USDT +1.5 ‰ 点差。
• 手续费：GCash 0.8 %，GrabPay 1.0 %，API 调用免费。

六、接入加速包

新商户可申请「24h 快速上线包」——包含 SDK、Postman 集合与沙盒账号，技术对接群实时答疑。
申请方式：Telegram @GcashNativePay 或邮箱 [email protected]。

币付Pay — 菲律宾原生支付 · 稳定 · 合规 · 低费率