本篇文档旨在为各类菲律宾线上平台(网站、App、小程序等)提供完整的GCash原生支付接口说明。币付系统支持多支付方式调度(GCash、USDT、银行卡),具备完善风控、稳定监听与高转化设计,本文为技术开发者提供标准API字段说明与调用示例,便于快速部署与上线。
一、基础参数配置
| 参数名称 | 说明 | 类型 | 示例 |
|---|---|---|---|
| merchant_id | 商户编号 | string | BIFUAPP001 |
| api_key | 商户私钥 | string | 2fb3a938cb1ad8c8e1... |
| gateway_url | 网关地址 | string | https://bifu.us/api/pay |
所有接口请求均使用 POST 方式,Header 推荐 Content-Type 为 application/json。
二、创建支付订单 API
请求地址:
POST https://bifu.us/api/pay/create
请求参数:
| 字段 | 说明 | 类型 | 是否必填 |
|---|---|---|---|
| order_id | 商户订单号(唯一) | string | 是 |
| amount | 支付金额(单位 PHP) | float | 是 |
| pay_type | 支付方式:gcash / usdt | string | 是 |
| notify_url | 支付成功后异步回调地址 | string | 是 |
| return_url | 支付完成后跳转地址 | string | 否 |
| sign | 参数签名 | string | 是 |
签名规则:
将以下字段按顺序拼接:order_id + amount + pay_type + notify_url + api_key,然后使用 MD5 加密,转小写。

返回示例(JSON):
{ "code": 200, "msg": "success", "data": { "order_id": "BF1234567890", "pay_url": "https://bifu.us/qrcode/BF1234567890" } } 三、支付成功回调接口
说明:支付完成后,系统将向商户 notify_url POST 一次支付结果。
回调字段:
| 字段 | 说明 | 类型 |
|---|---|---|
| order_id | 原始订单号 | string |
| amount | 实际到账金额 | float |
| status | 状态(固定为 success) | string |
| txid | 交易单号/转账码 | string |
| sign | 签名字段 | string |
签名校验规则:
字段拼接顺序:order_id + amount + txid + api_key → MD5 → 小写。
回调响应要求:
商户系统需返回:success(不区分大小写),否则视为未接收,币付系统将再次回调。
四、常见状态码说明
| 状态码 | 含义 | 说明 |
|---|---|---|
| 200 | 成功 | 请求处理成功 |
| 400 | 参数错误 | 缺少必填字段 |
| 403 | 签名错误 | sign无效 |
| 500 | 服务异常 | 接口故障或超时 |
五、附加说明
- 所有金额单位均为菲律宾披索 PHP,小数点后最多两位
- 建议在订单生成后10分钟内完成支付,过期二维码会失效
- 建议启用 自动补单接口 或使用 系统通道状态订阅 提升稳定率
六、技术对接支持
- 技术对接TG:
@Bifuapp - 更新频道:https://t.me/GcashNativePay
- 客服邮箱:[email protected]
GCash系统接入,从币付API开始。
稳定、安全、高效,助力您的支付闭环系统真正落地。
需要接入菲律宾本地支付通道?
币付PAY 专注菲律宾 GCash / GrabPay / QRPH 等本地钱包支付,支持 USDT/PHP 结算, 适合跨境电商、游戏娱乐、会员充值等多种场景。
👉 接入流程说明: 币付PAY 接入完整教程
👉 唯一官方客服: Telegram @bifuapp
温馨提示:请勿相信其他渠道散布的“客服账号 / 钱包地址 / 收款二维码”,避免资金风险。
币付pay
发表评论
发表评论: