菲律宾本地支付通道接入指南：GCash 与 QRPH 扫码支付一体化集成（币付）

面向在菲律宾开展业务的电商、线上娱乐、数字服务、线下门店与平台型商户，币付提供两类最核心的本地收款能力：GCash 钱包支付与QRPH 扫码支付。通过统一的支付通道与标准化接口，帮助商户降低接入成本、缩短上线周期，并提升到账稳定性与对账效率。

一、为什么需要同时接入 GCash 与 QRPH 扫码支付

• 覆盖更广的付款场景：线上收银台适配电商与数字服务；线下门店、自助终端、地推活动更依赖扫码支付。
• 降低支付链路中断风险：单一方式波动会直接影响成交，多通道能力可显著提升整体成功率。
• 对账与资金管理更清晰：统一订单号、统一回调、统一对账口径，减少人工核对与漏单风险。

二、币付支付通道能力概览

• GCash 支付：支持用户使用 GCash 钱包完成线上收款，适配 Web、H5、App 收银台场景。
• QRPH 扫码支付：支持生成二维码并完成支付确认，适配门店收银、自助终端、线下活动等场景。
• 统一支付接口：同一套下单、查询、回调、对账接口，按支付方式参数差异化处理。
• 资金与对账：提供交易流水、渠道订单号映射、对账查询与必要的售后能力，具体以实际开通为准。

三、典型业务场景与推荐接入方式

1）线上业务：Web / H5 / App

• 收银台跳转：用户在收银台选择 GCash，跳转授权并完成支付。
• 支付结果确认：建议采用“异步回调 + 主动查询”的双保险方式确认最终状态，降低漏单概率。

2）线下门店 / 自助场景：QRPH 扫码支付

• 静态码：一码多付，适合固定收银点；由收银端录入金额并绑定订单号。
• 动态码：按订单生成二维码，强绑定订单金额与订单号，对账与风控体验更好。

四、标准接入流程

1. 提交商户资料与业务信息：主体信息、经营范围、结算账户等基础资料登记。
2. 开通支付方式与环境配置：获取商户号、密钥、回调地址、白名单等关键配置。
3. 联调接口：下单创建交易 → 拉起支付或展示二维码 → 接收回调 → 查询与对账。
4. 灰度上线：小流量验证成功率、回调稳定性、对账一致性后再全量放开。

五、接口与回调要点

• 订单号规范：商户侧订单号建议全局唯一，长度与字符集固定，便于排查与对账。
• 签名校验：回调与敏感接口必须验签，避免被伪造请求影响资金与订单状态。
• 幂等处理：回调可能重复到达，商户侧必须按订单号或渠道单号做幂等更新。
• 状态机清晰：区分已创建、处理中、已成功、已失败、已关闭、已退款等状态，避免状态回滚。
• 超时策略：超过支付时限的订单建议自动关闭，并向前端提示重新发起。

六、安全与风控建议

• 回调防护：回调地址固定可达，启用来源校验与必要的白名单策略。
• 异常交易监控：高频小额、同设备多账号、短时集中失败等信号建议触发限流或人工复核。
• 对账闭环：建议每日自动对账，发现差异自动告警并留痕，便于快速定位问题。
• 权限与审计：涉及退款、冲正、资金分发等操作建议启用强权限控制与审计日志。

七、费率与结算说明

GCash 与 QRPH 的费率与结算规则以实际开通与商户资质评估为准，详细费率如下：

[rate-table type="all"]

八、商户上线前自检清单

• 回调地址可达、验签通过、幂等处理完成。
• 订单状态机与关单逻辑正确，超时订单可控。
• 已接入查询与对账能力，差异可定位、可追溯。
• 支付成功页与失败页文案清晰，支持用户重试与二次支付。
• 风控与限流策略启用，关键链路日志完整可追踪。

九、接入咨询与技术支持

如需开通 GCash 与 QRPH 扫码支付能力、获取接口文档与联调支持，请联系币付客服：

• Telegram：@Bifuapp
• 邮箱：[email protected]