在菲律宾,GCash 原生代付 是打通本地用户资金链条的关键组件。相比跳转类钱包授权方式,币付Pay 提供的 本地代付API 支持 D0 清算、USDT 实时锁汇、多账户分发等功能,适用于代理分润、佣金结算、会员返利等多种场景。
一、接口概览
接口名 | 功能 | 调用频率 |
---|---|---|
/v1/transfer | 发起代付 | ≥2000 TPS |
/v1/transfer/query | 订单查询 | 无限制 |
/v1/balance | 余额查询 | 每分钟 1 次 |
/v1/rate | USDT–PHP 汇率获取 | 每 5 分钟 |
二、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 步
添加 Telegram @Bifuapp 获取商户号
提交 KYC 材料(营业执照 + 负责人身份证)
沙盒测试通过后开通正式环境,绑定 webhook
开始投产:支持 PHP / Python / JavaScript SDK
全面接入 GCash 原生代付系统,即刻开启 D0 放款+USDT清算 双引擎。更多文档和支持请联系邮箱:[email protected]
发表评论
发表评论: