如果你正在菲律宾运营一套本地收款系统，无论用于游戏充值、BC代收、Telegram项目、实体收银，都可以通过币付Pay提供的GCash原生接口，实现自动收款+自动回调+D0结算。本文将系统性教你如何部署代收服务，从注册账号、获取API密钥，到部署服务端、落地前端H5扫码页。

一、准备条件

提示：你可以使用宝塔 + Nginx 快速搭建 API 服务。建议购买菲律宾IP或中立国家IP，避免 GC 网络过滤。

二、GCash 接口流程图

三、接口调用详解（以 PHP 为例）

// Step 1: 获取Token $resp = http_post('https://api.bifu.us/oauth/token', [ 'client_id' => '你的client_id', 'client_secret' => '你的client_secret', 'grant_type' => 'client_credentials' ]); $token = $resp['access_token']; // Step 2: 创建订单 $order = [ 'amount' => ['currency' => 'PHP', 'value' => '88.00'], 'referenceId' => 'BIFU'.time(), 'callbackUrl' => 'https://你的域名.com/notify', 'redirectUrl' => 'https://你的域名.com/return', 'description' => '订单描述' ]; $payResp = http_post_json('https://api.bifu.us/v1/payments', $order, $token); echo $payResp['qrUrl']; // 返回二维码链接 

用户扫码或唤醒 GCash APP 后支付，后台将收到回调 POST 请求，结构如下：

{ "referenceId": "BIFU1719981732", "status": "SUCCESS", "paid_amount": "88.00", "currency": "PHP", "transaction_id": "G123XXX", "signature": "xxx..." }

请验证签名字段，确认订单状态再入账。

四、Webhook（回调）示例

$data = json_decode(file_get_contents("php://input"), true); if ($data['status'] === 'SUCCESS') { $order_id = $data['referenceId']; $amount = $data['paid_amount']; // 验签逻辑略，可加密参考文档 // 更新数据库订单为已支付 }

五、搭建前端收款页（H5扫码页）

你可以将后端生成的 qrUrl 转为 Base64 二维码，嵌入收银台或用户充值页。示例：

<img src="https://api.qrserver.com/v1/create-qr-code/?size=180x180&data=https://gcash.link/abc123" />

也可直接跳转至 deeplinkUrl 唤起 GCash，适用于 App 内。

六、稳定运行建议

• ✅ 启用定时轮询查询未回调订单，避免漏单
• ✅ 后台加入管理员收款监控界面
• ✅ 如用户收不到二维码，优先使用 GCash deeplink
• ✅ 使用防火墙屏蔽非法POST请求来源

七、币付优势 VS 同类平台

SafePay 接口结构冗长、频繁抽风，且风控审核慢、封号风险高；币付聚合原生 GCash + GrabPay，拥有完整资金链闭环与企业级 SLA 保证。

八、获取文档 + 测试账号

• 客服邮箱：[email protected]
• TG 支持频道：https://t.me/GcashNativePay
• 专属接入对接：联系 @Bifuapp

币付本地支付系统将让你的项目在菲律宾跑得更快更稳，
GCash 原生直连，即接即用，费用低至 0.8%，秒到账！