GCash作为菲律宾最大电子钱包之一，开放了原生 API 支付接口，适用于独立站、电商、BC、游戏与充值等多类场景。本文将从“前端生成订单”到“后端异步回调处理”，为你完整展示 GCash 原生支付的对接过程，适合具备一定开发能力的运营者或工程师快速接入。

一、API 接口概览（币付聚合版）

二、环境要求

• ✅ PHP ≥ 7.2 或 Node / Python / Java 环境
• ✅ 开启 SSL 的服务器（用于接收 Notify 回调）
• ✅ 已申请币付商户权限（TG联系 @Bifuapp）
• ✅ 支持 PHP Curl 或 HTTP Client 请求

三、PHP Demo 示例

// Step 1 获取 Token $resp = http_post('https://api.bifu.us/oauth/token', [ 'client_id' => 'your_client_id', 'client_secret' => 'your_client_secret', 'grant_type' => 'client_credentials' ]); $token = $resp['access_token']; // Step 2 创建订单 $order = [ 'amount' => ['currency' => 'PHP', 'value' => '88.00'], 'referenceId' => 'ORD'.time(), 'callbackUrl' => 'https://yourdomain.com/notify', 'redirectUrl' => 'https://yourdomain.com/return', 'description' => '充值订单' ]; $result = http_post_json('https://api.bifu.us/v1/payments', $order, $token); echo $result['qrUrl']; // 用于生成二维码展示 

四、Notify 回调处理逻辑

// GCash通知结果 POST 到你的 notify URL $json = file_get_contents("php://input"); $data = json_decode($json, true); if ($data['status'] == 'SUCCESS') { $orderId = $data['referenceId']; $txid = $data['transaction_id']; $amount = $data['paid_amount']; // 更新数据库订单状态 }

建议加入签名验证机制，例如返回字段 signature 与私钥匹配。

五、前端快速集成

• 扫码支付：将 qrUrl 值转为 base64 显示
• App 跳转：使用 deeplinkUrl 唤起 GCash
• 移动端兼容：建议判断 UA 自动切换跳转方式

六、接入注意事项

七、币付平台优势

• 📈 聚合 GCash / GrabPay / Maya 等主流钱包
• 📊 多终端支持：PC + 移动 + App
• 💰 自定义分账、支持代付与返佣
• 📆 每日 D0 清算，支持 USDT/本地银行兑付

八、商务合作与申请测试账号

• 客服邮箱： img1231@163.com
• 商户接入频道： https://t.me/GcashNativePay
• 对接人 Telegram： @Bifuapp

币付为您提供菲律宾市场最完整的 GCash 原生支付 API 文档与接入支持，
部署完成，即可稳定跑量，实现自动结算与实时入账！