菲律宾支付系统开发者文档：GCash D0原生接口指南（2025开发版）

8个月前 (04-10) 菲律宾四方支付 3711 0

本开发文档适用于接入币付 PAY（bifu.us）菲律宾 GCash 原生支付系统的开发者。支持创建订单、主动查询、Webhook 异步回调、D0 结算及多通道聚合（GrabPay、Maya 等）。本指南面向技术接入开发者，适配 Node、PHP、Python、Go 等主流语言，可嵌入至 App、小程序、H5 或独立服务中。

菲律宾支付系统开发者文档：GCash D0原生接口指南（2025开发版）

1｜接口概览

功能地址说明
创建订单/v2/order/create创建二维码/链接
订单查询/v2/order/query主动轮询或定时对账
异步回调商户自定义异步通知状态
发起代付/v2/payout/create提现、转账功能
查询余额/v2/account/balance查询可结算余额

2｜订单创建接口

 POST https://api.bifu.us/v2/order/create Content-Type: application/json
{
"merchant_id": "10086",
"api_key": "xxxxxxx",
"amount": 499.50,
"currency": "PHP",
"order_id": "ORDER20250704001",
"pay_method": "gcash",
"notify_url": "https://your.domain/notify",
"return_url": "https://your.domain/thankyou",
"timestamp": "1720009123",
"sign": "md5(merchant_id + order_id + amount + api_secret)"
}
返回结构： json 代码 { "code": 200, "msg": "success", "data": { "pay_url": "https://paylink.bifu.us/redirect/XYZ123", "qrcode": "https://paylink.bifu.us/qrcode/XYZ123.png", "order_id": "ORDER20250704001" } }

3｜Webhook 异步通知

服务器收到 POST 请求，默认格式如下：

```json { "order_id": "ORDER20250704001", "amount": "499.50", "status": "SUCCESS", "timestamp": "1720009255", "sign": "md5(order_id + amount + timestamp + api_secret)" } ``` 验证建议：按字段生成签名本地校验，确保金额、状态、签名一致后回写 SUCCESS 即可。

4｜查询接口（主动）

 POST /v2/order/query { "merchant_id": "10086", "order_id": "ORDER20250704001", "timestamp": "1720009260", "sign": "md5(merchant_id + order_id + timestamp + api_secret)" }
返回状态：SUCCESS / PENDING / FAILED

5｜代付接口（提现）

 POST /v2/payout/create { "merchant_id": "10086", "api_key": "xxx", "amount": 2000.00, "currency": "PHP", "account": "09171234567", "account_type": "gcash", // or "bank" "order_id": "PAYOUT20250704001", "timestamp": "1720009269", "sign": "md5(merchant_id + order_id + amount + timestamp + api_secret)" }
支持收款类型： gcash：手机号 bank：提供银行编码、账户名称、账号

6｜安全建议

  • 每次请求加入随机字符串 nonce 防重放攻击
  • 签名建议加入时间戳校验有效期 <300 秒
  • 如支持白名单，务必绑定固定 IP
  • 异步通知应开启 HTTPS + 双向签名

7｜聚合多通道接入

将参数 pay_method 设置为：

  • gcash：GCash 原生通道
  • grabpay：Grab 钱包聚合
  • maya：PayMaya 钱包（默认仅大额）
  • auto：系统根据用户行为智能分配通道

8｜实时结算机制（D0）

  • 每日自动对账：系统在 17:00 对账后生成结算记录
  • 支持自动出金（银行/USDT）：17:15 起出款
  • 后台控制代付频次：默认每天最多 5 次

9｜联系支持 & 接口申请

📧 技术客服邮箱：[email protected]
📢 Telegram 技术群公告：https://t.me/GcashNativePay
💬 接口申请顾问：@Bifuapp

查看更多 GCash 技术文档 >>

需要接入菲律宾本地支付通道？

币付PAY 专注菲律宾 GCash / GrabPay / QRPH 等本地钱包支付，支持 USDT/PHP 结算， 适合跨境电商、游戏娱乐、会员充值等多种场景。

👉 接入流程说明： 币付PAY 接入完整教程

👉 唯一官方客服： Telegram @bifuapp

温馨提示：请勿相信其他渠道散布的“客服账号 / 钱包地址 / 收款二维码”，避免资金风险。

猜你喜欢

发表评论

发表评论: