菲律宾 GCash 原生支付接入与代收代付对接指南：合规流程与技术实现要点｜币付

本文面向需要在菲律宾开展收款（Pay-in）与代收代付/代付（Payout）业务的商户与开发团队，梳理 GCash 原生接入、QRPH（QR Ph） 扫码收款的落地方式，以及合规风控、回调验签、幂等、防重放、对账补单与代付闭环的关键实现要点，帮助你更快上线并长期稳定跑量。

一、先选对接入方式：原生直连 vs 聚合平台

在菲律宾接入 GCash、QRPH、Maya（原 PayMaya）、GrabPay、Coins.ph 等本地渠道时，最容易走弯路的点是：接口越多、状态越乱、对账越碎、运维越重。一般有两条路线：

官方原生直连（Native / Direct）：适合资质齐全、规模稳定、愿意自建风控与对账体系的团队。
聚合服务商（Aggregator）：适合希望快速上线、减少多渠道差异与运维成本，同时要把“收款→对账→结算→代付”做成一套可运营闭环的商户。

选择前先明确三点：交易体量（预期日订单/峰值TPS）、结算诉求（D0/T+N/分账/批量代付）、团队能力（回调可靠性、风控、对账、告警与排障）。

二、合规与风控：代收代付真正的门槛

代收代付属于资金流转敏感场景，建议一开始就按合规体系设计，避免后补材料导致重构或业务被动停摆。常见关注点：

KYB/KYC：商户主体、受益所有人、业务真实性证明、资金用途与流向说明。
AML/制裁名单：异常交易识别、黑名单命中处置、可疑交易留痕与内部处理流程。
争议/退款：撤销与退款路径、证据留存、差异单处理责任人机制。
数据隐私与安全：最小化采集、敏感字段加密存储、访问控制与审计日志。

最重要的一句：先把业务边界写清楚——你收什么、付给谁、为什么付、如何证明——再做接口对接，后续开通更快、风控更稳。

三、GCash 收款（Pay-in）对接：标准技术流程

1）商户侧系统准备

订单中心：生成唯一订单号（不可重复、可追溯），记录金额、币种、商品/服务信息、用户标识。
支付状态机：至少包含待支付、支付中、成功、失败/关闭、退款中、已退款，并保证幂等写入。
回调接收服务：可验签、可防重放、可追踪；支持重试与快速返回。
查询兜底与补单：回调延迟/丢失时，支持主动查询并自动修正订单状态。

2）发起支付与用户完成支付

典型链路：服务端创建支付请求 → 返回支付凭证/跳转信息 → 前端引导用户完成支付（App/H5/收银台）→ 平台异步通知结果。

金额与订单号校验：金额以服务端为准，前端只展示；订单号必须全局唯一。
有效期控制：支付请求设置超时与关闭策略，避免悬挂订单长期占用库存与风控额度。
体验细节：展示商户名称、金额、用途，减少误付与争议。

3）回调通知：验签、幂等、防重放、重试

回调处理是支付接入的核心，建议做到：

验签/验密：对回调参数做签名校验，拒绝伪造通知。
幂等：同一笔交易可能多次回调；按“渠道流水号/平台支付单号/商户订单号 + 状态机”幂等落库。
防重放：校验时间戳/nonce；记录已处理的回调指纹（hash）与窗口期。
快速响应：回调接口先落库/入队列再异步处理，避免超时导致平台重复推送。

4）对账与异常处理

日常对账：以渠道账单与商户订单双基准定位差异单（少单/多单/金额不一致/状态不一致）。
补单策略：回调缺失、网络抖动、用户中断支付，都要能自动修复状态并补发业务通知。
退款链路：退款必须走可追踪链路，避免线下处理导致财务不可控与争议升级。

四、代收代付/代付（Payout）：把“可控”放在第一位

1）三类典型场景

退款与撤销：与原订单绑定，强调可核对、可追溯、可审计。
佣金/激励发放：批量代付，强调批次管理、失败重试与预算控制。
工资/补贴：强调合规与收款人信息准确性，必须有审批与留痕流程。

2）核心设计：批次、限额、风控、幂等、重试

批次号：一批代付一个批次号，便于统计、对账与追踪。
收款人信息管理：收款账号/标识的新增与修改需要审核，降低内部风险。
限额与预算：按日/按用户/按业务线设置额度；超限触发人工复核或延迟发放。
失败重试策略：区分可重试失败（网络/超时）与不可重试失败（账号错误/风控拒绝）。
幂等键：同一笔代付重复提交时不重复扣款、不重复打款。

3）到账与对账：代付必须闭环

代付不是“发起成功”就结束，必须闭环到“到账可确认”。建议每笔代付至少三段式状态：已提交 → 处理中 → 成功/失败，并记录失败原因与可行动建议（例如补充资料/更换收款信息/重新发起）。

五、QRPH（QR Ph）扫码收款：适合线下与多钱包覆盖

如果你需要覆盖更多扫码钱包（不仅 GCash），或者有线下收银、门店收款、代理点等场景，通常会引入 QRPH：

动态码：按订单生成，适合电商、点单、收银台“付款即核销”。
静态码：固定码，适合摊位/门店；需要配合“备注/金额校验/付款截图”类流程，建议做更强的对账与风控。

落地重点：订单绑定、金额校验、回调一致口径、扫码成功但回调延迟的兜底查询，避免“已付不到账/不到账已发货”的争议单。

六、多渠道一起上（GCash + QRPH + Maya/PayMaya + GrabPay + Coins.ph）：建议做统一支付编排层

当你不只要 GCash，还要 Maya（PayMaya）、GrabPay、Coins.ph 等渠道时，最容易踩坑的是接口差异导致业务逻辑分裂、对账碎片化、运维成本飙升。更稳妥的做法是：

统一下单模型：订单号、金额、用户标识、商品信息结构一致。
统一回调规范：各渠道回调转换成内部标准事件（成功/失败/关闭/退款）。
统一对账与报表口径：按渠道、业务线、时间维度输出一致口径。
统一风控：黑名单、限额、频控、设备/IP 策略集中管理。

市场上也存在多种第三方聚合平台与通道服务商（例如 UUpay、Safepay、NomuPay、HaiPay、Wallyt 等）。无论选择哪家，建议你用“统一接口/统一回调/统一对账/统一结算/统一风控”的标准评估，避免后期被渠道差异拖垮交付与运维。

七、上线前检查清单

业务侧：交易流程、退款规则、争议处理流程可落到系统并可追责。
财务侧：对账口径一致，差异单处理流程与责任人明确。
技术侧：验签、幂等、重试、查询兜底、日志追踪、告警齐备。
风控侧：限额、黑名单、异常检测、人工复核机制可执行。
运维侧：成功率、回调延迟、超时率、失败原因分布等指标可视化。

八、选择币付：把本地收款与代收代付做成一体化能力

如果你希望更快上线、减少多渠道对接与运维成本，同时把收款与代付做成可追踪、可对账、可风控的一体化能力，币付（Bifu） 可提供面向菲律宾本地场景的整合方案：GCash + QRPH 多通道覆盖，统一下单、统一回调、统一对账与结算，并支持代收代付闭环与风控策略落地。

九、GCash & QRPH 实时费率参考

[rate-table type="all"]

十、联系我们（官方对接入口）

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

沟通时建议准备：业务类型（收款/代付/两者）、预期日交易量级、是否需要多渠道（GCash/QRPH/Maya/GrabPay/Coins.ph 等）、以及现有系统形态（网站/App/H5/线下收银）。这样对接更快、方案更精准。