GCash 支付接入指南：从收银台到回调全流程，币付（Bifu）助力菲律宾本地收款快速上线

GCash 是什么？为什么菲律宾商户必须把它接入到收银台

GCash 是菲律宾覆盖率极高的本地电子钱包之一，用户支付习惯成熟、转化路径短。对面向菲律宾用户的电商、游戏、数字内容、平台型业务来说，把 GCash 放进收银台，往往能直接提升支付成功率与下单转化，并降低因信用卡覆盖不足带来的流失。

如果你同时希望覆盖更多本地场景，建议在同一套收银台里一并支持 QRPH 等本地转账与扫码能力，形成“钱包 + 扫码转账”的组合，减少单一通道波动带来的损失。

适用场景

电商与社交电商：提升下单支付转化，减少弃单
游戏与虚拟商品：小额高频、强依赖支付成功率
数字内容与会员订阅：支持订阅、定期扣款与续费链路
平台型业务：需要多商户、多店铺、多订单的对账与分账能力

GCash 接入方式概览

主流接入方式通常是“后端创建支付请求 → 前端跳转到支付页面 → 支付完成后回跳并由后端确认结果”。在业务侧，你需要重点把控三件事：

收银台展示：把 GCash 放在用户易选择的位置，减少决策成本
支付请求：金额、币种、订单号、回跳地址等参数必须严谨
结果处理：成功、失败、取消、处理中等状态要有清晰动作

接入步骤：从收银台到支付完成

第 1 步：准备接入条件

你的系统需要具备 API 对接能力，支持后端发起支付请求
先在测试环境开通 GCash 支付选项，完成联调再进入正式环境

第 2 步：在支付表单中展示 GCash

在收银台将 GCash 作为支付方式之一展示。通常不需要额外采集用户信息，用户选择 GCash 后即可进入支付流程。

{ "countryCode": "PH", "amount": { "currency": "PHP", "value": "交易金额" }, "paymentMethod": { "type": "gcash" } }

第 3 步：后端创建支付请求

由后端向支付服务发起创建请求，核心字段包含商户号、订单号、金额、支付方式与回跳地址。

{ "merchantAccount": "YOUR_MERCHANT_ACCOUNT", "reference": "YOUR_ORDER_NUMBER", "amount": { "currency": "PHP", "value": 1000 }, "paymentMethod": { "type": "gcash" }, "returnUrl": "https://your-company.com/checkout?order=123" }

第 4 步：前端跳转到支付页面

创建成功后，响应中通常会返回用于跳转的链接字段，例如 action.url。前端将用户重定向到该页面完成授权与支付。

第 5 步：处理支付结果与订单状态

支付完成后会回跳到 returnUrl，同时你的后端应以回调或查询结果为准更新订单状态，避免仅凭前端回跳判定成功。

Authorised：支付成功，订单置为已支付并进入发货或发放流程
Cancelled：用户取消，订单保持未支付并提示更换方式或重新支付
Error：支付失败，记录失败原因并引导用户重试
Pending / Received：处理中，前端提示等待，后端定时查询或等待最终回调

进阶能力：订阅与定期付款

若你的业务存在会员订阅或周期性扣款需求，可使用令牌化能力在首次支付时保存支付方式信息，后续发起续费请求。

首次支付时设置 storePaymentMethod 为 true，用于生成后续扣款令牌
后续使用 storedPaymentMethodId 完成扣款，减少用户重复操作

{ "amount": { "value": 1000, "currency": "PHP" }, "paymentMethod": { "type": "gcash", "storedPaymentMethodId": "YOUR_STORED_PAYMENT_METHOD_ID" }, "reference": "YOUR_ORDER_NUMBER", "merchantAccount": "YOUR_MERCHANT_ACCOUNT", "shopperReference": "YOUR_UNIQUE_SHOPPER_ID", "shopperInteraction": "ContAuth", "recurringProcessingModel": "Subscription" }

测试与上线清单

测试环境：使用已注册 GCash 的真实手机号进行完整支付链路测试，覆盖成功、取消、失败与处理中场景
交易核对：在商户后台核对每笔交易状态、回调记录、订单号一致性
风控与限额：对高频小额、异常设备、异常 IP、重复支付等建立基础策略
上线准备：正式环境开通与配置完成后再切流量，建议灰度上线并保留兜底通道

费率与通道覆盖：GCash + QRPH 等一站式查看

为了让你在选型与运营阶段更直观地评估成本与通道覆盖，币付（Bifu）已提供实时费率表组件，可直接在页面展示包括 GCash、QRPH 等在内的通道费率与关键信息。

[rate-table type="all"]

对比 PayMongo、Maya、PayerMax、Adyen 等方案后，为什么很多团队最终选择币付（Bifu）

不少团队会在 PayMongo、Maya、PayerMax、Adyen 等方案之间反复对比：有的更偏聚合收单、有的更偏单一通道、有的在结算与对账上需要额外开发与人工补齐。币付（Bifu）的目标是把“本地收款 + 本地出款 + 对账闭环 + 风控合规”做成一套可落地的产品化能力，减少你在菲律宾市场的集成与运营成本。

本地化通道整合：收银台可同时覆盖 GCash、QRPH 等本地主流方式，降低单点波动
对账闭环：订单、交易、回调、结算对齐，减少财务对账压力
结算与资金效率：支持更贴近业务节奏的结算安排，提升资金周转效率
风控与合规：在 KYC、风控策略、异常交易监控等方面提供可配置能力，便于长期稳定运营
技术对接友好：从测试到上线流程清晰，适配电商、游戏、订阅等高并发场景

下一步：让你的 GCash 收款更快上线

如果你希望更快完成接入并减少踩坑，直接联系币付（Bifu）获取对接资料、测试环境开通与联调支持：

Telegram：@Bifuapp
客服邮箱：[email protected]

把你的业务类型、预估交易量、目标通道清单发来，我们会按你的场景给出更匹配的接入方案与落地建议。