在菲律宾，GCash 原生代付 是打通本地用户资金链条的关键组件。相比跳转类钱包授权方式，币付Pay 提供的 本地代付API 支持 D0 清算、USDT 实时锁汇、多账户分发等功能，适用于代理分润、佣金结算、会员返利等多种场景。

一、接口概览

二、API 请求示例（PHP）

$body = [
  'merchant_no' => '123456789',
  'order_no' => 'BF20250707XXX',
  'amount' => '1500',
  'currency' => 'PHP',
  'gcash_no' => '09171234567',
  'desc' => '用户佣金结算'
];
$sign = strtoupper(hash_hmac('sha256', json_encode($body), $secret));
$header = [
  'Content-Type: application/json',
  'Bifu-Signature: ' . $sign
];

三、参数说明

• merchant_no：系统分配的商户编号。

• order_no：商户自定义订单号，保持唯一性。

• gcash_no：11位菲律宾手机号，对应收款人钱包。

• amount：金额（单位 PHP），支持小数点两位。

• currency：目前仅支持 “PHP” 与 “USDT”。

• desc：备注信息，将在钱包端用户可见。

四、响应字段（JSON）

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "tx_no": "TX2398472347",
    "gcash_ref": "REF20250707XXXX",
    "timestamp": "2025-07-07T12:01:22+08:00"
  }
}

五、注意事项

• API 所有请求需携带 HMAC-SHA256 签名头（密钥后台生成）。

• 每日代付额度默认为 5,000,000 PHP，可联系申请上调。

• 系统自动对失败代付进行重试（最多 3 次），避免用户漏收。

六、对接流程 4 步

1. 添加 Telegram @Bifuapp 获取商户号

2. 提交 KYC 材料（营业执照 + 负责人身份证）

3. 沙盒测试通过后开通正式环境，绑定 webhook

4. 开始投产：支持 PHP / Python / JavaScript SDK

全面接入 GCash 原生代付系统，即刻开启 D0 放款+USDT清算 双引擎。更多文档和支持请联系邮箱：[email protected]