在菲律宾跨境电商高速增长的当下,GCash 代收代付已成为卖家冲刺 GMV 的标配通道。本文基于 币付Pay 最新 V2.0 API,为技术 & 运营团队拆解“30 分钟上线 + D0 到账”全过程,助您低成本取代 SafePay 这类高费率方案。
一、接入前准备
- 开通商户:TG 联系
@Bifuapp
,提交域名 + 营业执照,1 小时下发 merchant_no / app_secret。 - 白名单配置:登录 商户后台 → 技术对接 → 填写服务器出口 IP。
- 文档下载:发送邮件至 [email protected],主题“GCash API 文档申请”。
二、创建收款订单(示例)
POST https://open.bifu.us/v2/order/create { "merchant_no": "1025888", "order_no": "PH20250703-001", "amount": 1288.50, "currency": "PHP", "pay_type": "GCASH_NATIVE", "notify_url": "https://yourshop.com/api/notify", "return_url": "https://yourshop.com/thankyou", "sign": "MD5签名" }
qrcode
字段直接渲染为二维码,移动端可 Deep Link 唤醒 GCash。- 默认 expire_time 300 秒,支持自定义 60-900 秒。
三、Webhook 回调字段
参数 | 说明 |
---|---|
order_no | 商户订单号 |
amount | 实付金额 |
status | SUCCESS / CLOSED |
pay_time | yyyy-MM-dd HH:mm:ss |
sign | MD5 签名 |
接收后请返回 success
字符串,避免重复推送。
四、费率 & 结算
- 收款费率:0.8%(日单量 < 3 万 PHP 时 1.2%)。
- D0 结算:24 h 内自动放款,可选 USDT / PHP。
- 风控阈值:单笔 100 – 50 000 PHP;日限 3 000 000 PHP。
五、常见落坑 & 对策
回调 IP 与 Header 校验
使用官方提供的 /ip/list
接口每日自动更新白名单,防止误拦截。
二维码过期导致用户支付失败
在前端倒计时 5 秒前自动刷新二维码,或使用轮询查询接口同步订单状态。
六、对接时间线(A/B 版)
- 👨💻 技术版: 30 min 获取密钥 → 90 min 集成 SDK → 3 h 灰度上线
- 🚀 免开发版: 收银台 H5 链接,即刻开卖
七、效果数据
2025-Q2 真实商户样本
日均 14 082 笔 | 成功率 94% | 手续费节省 38 000 PHP / 月
八、下一步行动
- 邮件 [email protected] 索取 PDF 文档;
- 加入通知频道 t.me/GcashNativePay 获取最新通道状态;
- 添加客服
@Bifuapp
,15 分钟开通沙盒测试; - 将
/create
与/notify
接口接入生产环境,享受 D0 回款!
币付Pay — 让菲律宾收款像呼吸一样简单
发表评论
发表评论: