针对菲律宾市场,搭建一条稳定合规、支持 D0 结算的 GCash 支付通道,已成为游戏、电商、BC 盘、代理分佣类业务的标配要求。本文基于币付Pay的真实商户案例,系统梳理 GCash + GrabPay 聚合接口的接入流程,涵盖 创建订单、状态查询、WebHook 签名、代付接口 等核心模块,助力您快速上线、稳定收款。
1 | 接口能力总览
模块 | 接口路径 | 功能描述 |
---|---|---|
创建订单 | /createOrder | 生成支付二维码或跳转链接 |
查询订单 | /query | 根据商户单号获取订单状态 |
异步通知 | Webhook 回调 | 成功交易自动通知商户 |
代付接口 | /payout | 商户发起 GCash 或银行代付 |
查余额 | /balance | 获取资金池余额 |
2 | 创建收款订单
```json POST https://api.bifu.us/createOrder { "merchant_id": "100056789", "api_key": "xxx", "amount": 188.00, "currency": "PHP", "pay_method": "gcash", "order_id": "ORDER20250704123", "callback_url": "https://xxx.com/pay/notify", "return_url": "https://xxx.com/pay/success" } css 代码 返回示例: ```json { "code": 200, "msg": "success", "data": { "pay_url": "https://payment.bifu.us/pay/gcash/xyz123", "qr_img": "https://payment.bifu.us/qrcode/xyz123.png", "order_id": "ORDER20250704123" } }3 | 回调签名验证
每笔订单完成后,系统会通过 WebHook 向商户配置的地址推送订单状态。为确保安全,建议验证签名字段:
```json POST https://xxx.com/pay/notify { "order_id": "ORDER20250704123", "amount": "188.00", "status": "SUCCESS", "sign": "md5(order_id + amount + secret_key)" } bash 代码4 | 查询订单状态
```json POST https://api.bifu.us/query { "merchant_id": "100056789", "api_key": "xxx", "order_id": "ORDER20250704123" } 返回字段说明: status: PENDING, SUCCESS, FAILED remark: 状态说明或失败原因5 | GCash 代付接口
```json POST https://api.bifu.us/payout { "merchant_id": "100056789", "api_key": "xxx", "amount": 1680.00, "currency": "PHP", "gcash_account": "09171234567", "remark": "用户提现 1680PHP" } css 代码 返回结构: ```json { "code": 200, "msg": "Payout initiated", "tx_id": "TX202507041001" }6 | GrabPay 接口(支持聚合)
只需在参数中将 pay_method
设置为 grabpay
,其余参数一致:
如需聚合跳转页,可使用 gcash+grabpay+maya
自动分流,根据用户设备优先展示可用方式。
7 | 实时结算流程(D0)
系统支持开启资金池模式:商户交易完成即计入余额。
手动或自动触发 D0 结算,支持 PHP 本地银行、USDT(TRC20 / ERC20)出金。
结算记录支持 CSV 导出。
8 | 联络方式
客服邮箱:[email protected]
Telegram 通道 & 新接口公告:https://t.me/GcashNativePay
官方开户支持:@Bifuapp
发表评论
发表评论: