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