菲律宾支付通道接入指南：GCash 代收代付对接流程、回调验签与上线验收｜币付

本文面向出海商户与平台方，提供一份可长期复用的 GCash 支付通道接入指南，覆盖代收下单与支付确认、回调验签与幂等、订单查询兜底、代付出款与状态追踪、对账字段与结算口径、上线验收与监控告警。

币付官方对接：Telegram：@Bifuapp　邮箱：[email protected]

实时费率（GCash & QRPH）

[rate-table type="all"]

一、你需要的不是“支付按钮”，而是“稳定闭环”

在菲律宾做业务，支付链路是否稳定，直接影响转化率与现金流。很多团队真正的痛点不是能不能收款，而是掉单与争议单不断、回调延迟导致订单状态不一致、重复回调引发重复发货或重复加点、对账口径混乱、结算节奏不可预期。

高频业务要跑稳，至少要做到以下四件事：

支付确认可靠：以回调通知或订单查询为准，保证订单状态最终一致。
回调可重入：重复回调只处理一次，避免重复入账、重复发货或重复发放权益。
可对账：订单号、通道单号、手续费、结算金额、状态口径统一。
可监控：成功率、回调延迟、失败原因分布、异常峰值具备告警。

二、上线前准备：资料与技术条件一次备齐

1）商户侧建议准备的信息

业务类型：电商、订阅、数字内容、平台、充值等，并简述交易链路。
交易结构：单笔金额区间、预计日订单量、峰值并发、退款与异常预期。
是否需要代付：仅代收，或代收 + 代付闭环。
结算诉求：希望同日或更快结算的节奏与对账口径要求。

2）技术侧必须具备的基础条件

notify_url 回调地址：长期稳定可访问，建议具备监控与容灾。
服务器时间同步：避免时间戳校验失败导致验签异常。
日志留存：至少保留商户订单号、通道单号、回调原文、验签结果、处理结果与耗时。
幂等存储：同一订单的重复回调只能成功处理一次。

三、代收接入流程：从下单到支付确认

Step 1：服务端创建订单（唯一可信入口）

建议由服务端创建订单并返回支付参数，避免前端伪造与金额被篡改。订单建议至少包含：

merchant_order_no：商户订单号，全局唯一、可追溯。
amount / currency：金额与币种。
user_id：你系统内部用户或会员标识。
biz_type：业务标识，用于风控分层、对账汇总与运营统计。

Step 2：发起支付（前端成功不等于支付成功）

用户进入支付流程不代表支付完成。最终结果必须以回调通知或订单查询确认。不要用前端返回状态直接发货、加点或开通会员。

Step 3：回调通知（验签 + 金额校验 + 幂等）

回调处理建议遵循三要素：可达、可验、可重入。

可达：回调地址稳定，超时或失败要能告警。
可验：严格验签；关键字段（订单号、金额、状态、时间戳等）必须参与校验。
可重入：重复回调只允许成功一次，幂等可追溯。

推荐的回调处理顺序：

验签 + 金额校验。不通过则拒绝并记录完整日志。
落库更新订单状态。用“订单号 + 最终态”保证幂等。
触发业务动作。发货、加点、开通会员等只执行一次。
返回回调成功响应。

Step 4：订单查询兜底（解决掉单与争议单的关键）

回调延迟或网络抖动在高频业务里一定会发生。必须做查询兜底，让订单状态最终一致：

对处理中或超时订单设置定时查询，直到收敛到最终态（成功、失败、关闭等）。
为客服提供一键查询入口：输入订单号即可输出状态与失败原因，减少人工扯皮。

四、代付接入流程：出款要可追踪、可审计

Step 1：提交代付请求（先做风险分层）

代付比代收更需要风控。建议按用户等级、历史行为、金额区间做分层策略；对异常行为可采取延迟审核、分批出款或补充验证。核心目标是可控、可审计、可追责。

Step 2：状态追踪与失败原因分类

payout_order_no：代付订单号，全局唯一，可追溯。
通道单号：每笔代付都应可查询最终状态。
失败原因分类：便于客服解释与用户引导，避免无结论工单积压。
重试规则清晰：哪些失败可自动重试，哪些需要人工介入，提前定义。

五、对账与结算：把口径一次定清楚

对账报表建议至少包含以下字段，并保证代收与代付口径统一：

商户订单号、通道订单号
订单金额、手续费、结算金额
订单状态、失败原因
支付完成时间、入账时间、结算时间

务必在系统内区分：支付成功、入账成功、可结算成功。三者混在一起，会直接导致财务对不上、客服解释不清、现金流误判。

六、上线验收清单（建议逐项打勾）

回调验签：签名错误能否被拒绝？关键字段是否纳入校验？
金额一致性：回调金额与下单金额不一致能否拦截并告警？
幂等：重复回调是否只处理一次？是否可追溯处理流水？
查询兜底：回调延迟时能否自动收敛订单状态？
失败原因：是否可分类输出，便于客服解释与运营优化？
对账字段：订单号、通道号、手续费、结算金额、状态是否齐全可核对？
灰度放量：是否先小流量验证，再逐步全量？
监控告警：成功率、回调延迟、错误码分布、异常峰值是否有告警？

七、常见对比：如果你也在评估其他平台

很多团队在菲律宾会同时对比与组合多种通道，例如 GCash、QRPH、Maya、GrabPay、Coins.ph、ShopeePay 等。真正决定稳定性的，不是平台名字，而是你是否把“下单 → 回调验签 → 幂等 → 查询兜底 → 对账 → 结算 → 代付”打通成统一闭环。

币付（Bifu）的价值在于：统一接口、统一回调、统一对账、统一结算与统一风控，把多通道接入与运营成本压到最低。

八、币付官方对接方式

如需开通 GCash 代收代付并安排对接，建议提前准备：业务类型、预计日/月订单量、单笔金额区间、峰值并发、notify_url 回调域名、技术对接人联系方式，便于快速评估并推进。

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

安全提示：请勿相信任何非官方渠道散布的客服账号、钱包地址或收款二维码。对接与开通信息以以上官方渠道确认为准。