GCash 与 QRPH 支付接入指南：一套 API 打通菲律宾原生收款与对账闭环

为什么在菲律宾一定要优先接入 GCash 与 QRPH

在菲律宾市场，本地钱包与扫码支付覆盖面极广。对电商、线上娱乐、数字内容、订阅平台、出海应用来说，接入 GCash 与 QRPH 往往直接决定支付成功率、转化率与复购体验。与只做银行卡的方案相比，原生本地通道更贴近用户习惯，付款路径更短，跳失更少。

如果你正在对比 PayMongo、Maya（PayMaya）、Xendit、Dragonpay、2C2P、PayerMax 等平台，核心要看三点：通道覆盖是否完整、回调与对账是否稳定、以及费率与结算体验是否可控。币付（Bifu）的定位，是用统一接入方式把菲律宾主流原生通道整合到一套可运营、可风控、可对账的收款体系中。

币付（Bifu）支持的菲律宾本地支付方式

GCash：菲律宾主流电子钱包，覆盖线上支付与多场景消费人群。
QRPH：菲律宾统一二维码标准，适合扫码收款与线下转线上场景。
银行卡与本地银行转账能力：覆盖常见本地银行线上支付需求，适配不同客群。

实时费率与可用通道一览

你可以直接在页面中展示币付（Bifu）已配置完成的实时费率与通道状态，便于访客快速决策与提交咨询：

[rate-table type="all"]

接入前准备清单

基础信息：商户名称、业务类型、预计日单量与客单价区间、主要流量来源与投放地区。
回调地址：支付成功与失败跳转地址，以及服务端异步通知地址，需支持 HTTPS。
订单规则：订单号唯一、可幂等处理，避免重复扣款或重复记账。
风控与合规：准备基本的用户登录、订单凭证、退款与争议处理流程，便于后续稳定放量。

标准接入流程：创建支付源 Source → 发起支付 Charge → 处理回调与查单

币付（Bifu）采用标准化支付流程，便于你把 GCash、QRPH 等通道统一在同一套逻辑里。以下以 GCash 为例说明关键步骤。

步骤一：创建支付源 Source

创建 Source 的目的，是为本次交易生成一个唯一的支付标识，并绑定币种、通道类型与跳转地址。

{
  "currency": "PHP",
  "type": "gcash",
  "redirect": {
    "success": "https://merchant.com/payment/result?status=success",
    "fail": "https://merchant.com/payment/result?status=fail"
  }
}

示例响应：

{
  "id": "src_Syo4wsSSdu5rqTci0",
  "source_type": "gcash",
  "currency": "php",
  "redirect": {
    "success": "https://merchant.com/payment/result?status=success",
    "fail": "https://merchant.com/payment/result?status=fail"
  },
  "used": false,
  "object": "source"
}

步骤二：创建支付请求 Charge

拿到 Source ID 后，发起 Charge，生成用户付款链接或收银台地址，并进入待支付状态。

{
  "amount": 100,
  "currency": "php",
  "source": "src_Syo4wsSSdu5rqTci0",
  "description": "GCash payment",
  "statement_descriptor": "MerchantName",
  "capture": true
}

示例响应：

{
  "id": "ch_RurstbusX8QLYWsrYdJvs",
  "amount": 100,
  "status": "pending",
  "currency": "PHP",
  "gateway": "gcash",
  "checkout_url": "https://payments.gcash.com/gcash-cashier-web/confirm?bizNo=123456×tamp=1616475550993"
}

步骤三：引导用户完成付款并接收结果

前端跳转：将用户重定向至 checkout_url，完成登录与确认付款。
同步跳转：用户完成支付后会跳回 success 或 fail 页面，用于展示结果与引导下一步。
异步通知：服务端必须接收异步通知并落库为准，避免仅依赖前端跳转导致漏单。

GCash 付款体验要点：如何减少跳失、提升成功率

减少页面层级：下单后直接跳转收银台，避免多次确认页面造成流失。
明确金额与币种：展示 PHP 金额与订单信息，减少用户疑虑与误操作。
支付状态实时反馈：支付中、成功、失败都应有明确提示，并提供返回商户页面的引导。

上线必做的三件事：回调校验、幂等处理、对账闭环

回调安全校验：对回调参数做签名校验与来源校验，避免伪造通知。
幂等与重复通知处理：同一订单多次通知必须只记账一次，避免重复发货或重复入账。
对账与补单机制：建立定时查单与对账流程，异常订单自动拉单补齐，运营可追踪。

为什么建议用币付（Bifu）做菲律宾本地收款的主通道

统一接入：GCash、QRPH 等本地能力用一套接入方式管理，减少多平台拼接成本。
面向运营的可控性：支付状态、失败原因、风控策略与对账逻辑更清晰，适合规模化放量。
更适合出海业务形态：支持电商、数字内容、游戏点卡、订阅等高频交易场景的稳定链路。
对比常见平台的落地优势：在你评估 PayMongo、Maya（PayMaya）、Xendit、Dragonpay、2C2P、PayerMax 等方案时，币付（Bifu）更强调“通道可用性 + 回调稳定性 + 对账闭环 + 服务响应”的综合结果，而不是只给一个接口就结束。

获取接入资料与测试环境支持

如果你希望快速评估适配度，建议直接发来你的业务类型与预估量级，我们可同步提供接入要点、通道建议与上线检查清单。

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

现在就对接币付（Bifu），把菲律宾原生支付从“能用”升级到“稳定可运营”。