GCash 原生接入 + 代收代付闭环全流程：下单、回调验签、幂等、查询兜底、对账与出款｜币付

在菲律宾做业务，支付从来不是“接上就完事”，而是一套需要长期稳定运行的系统。订单量越大，越容易暴露问题：支付成功率波动、回调延迟导致掉单、争议单堆积、对账口径混乱、结算不可预期影响现金流。

本文从商户实操出发，讲清 GCash 原生接入与代收代付 Pay-in / Pay-out 的完整闭环：下单、拉起支付、回调验签与幂等、订单查询兜底、对账报表、结算口径，以及代付出款的风控与状态追踪。需要对接开通可联系币付官方渠道：Telegram @Bifuapp / 邮箱 [email protected]。

实时费率参考

[rate-table type="all"]

说明：以上为 GCash 与 QRPH 的实时费率展示，实际以开通方案与通道配置为准。

一、先把概念讲清楚：什么是代收代付？为什么必须做闭环？

代收代付本质是两条能力的组合：

代收 Pay-in：用户完成付款后，你的系统能可靠确认交易结果，并形成可追溯记录。
代付 Pay-out：你能向用户、代理、渠道、员工等进行资金下发，且出款状态可追踪、失败原因可定位。

商户真正需要的是闭环：下单 → 支付确认 → 对账 → 结算 → 出款 → 异常处理全链路口径一致。闭环没建立，跑量后一定会出现：客服解释不清、财务对不上账、资金周转不可控。

二、为什么强调 GCash 原生接入？

体验更顺：链路更短、跳转更少，降低用户中途放弃，提高转化率。
确认更稳：回调与查询更容易做成闭环，减少掉单与争议单。
更适合跑量：订单量上来后，稳定确认与对账口径比能不能支付更重要。

如果你同时覆盖线下扫码或多场景收款，建议叠加 QRPH 聚合能力，便于统一码体系与提升覆盖面。

三、代收 Pay-in 全流程：从下单到最终确认

第 1 步：上线前必须明确的准备项

业务类型：电商、订阅、数字内容、平台、充值等，不同业务风控策略不同。
交易结构：单笔金额区间、订单频率、峰值并发、退款比例预估。
技术准备：稳定的回调域名 notify_url、服务器时间同步、日志留存与可追溯策略。

第 2 步：创建订单：服务端下单是唯一可信入口

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

商户订单号：全局唯一，建议可追溯，例如含业务线、日期、序号
金额与币种
用户标识：你系统内部用户 ID、会员 ID 等
业务标识：用于风控分层与对账汇总

第 3 步：拉起支付：前端展示顺利不代表支付成功

无论是收银台还是跳转唤起，前端只是进入流程。最终以回调通知或订单查询确认结果为准，不要用前端成功当作入账依据。

第 4 步：回调通知：关键是验签与幂等

回调必须满足三要素：可达、可验、可重入。

可达：notify_url 长期稳定可访问，具备监控与容灾。
可验：严格验签，关键字段如订单号、金额、状态、时间戳参与校验；金额与订单号必须与本地订单一致。
可重入：同一订单可能重复回调，多次通知只能入账一次。

推荐幂等策略：以商户订单号 + 最终态作为幂等键；先落库再触发发货、加点、开通会员等业务动作，避免重复发货或重复加点。

第 5 步：订单查询兜底：解决争议单的核心

高频投诉常见场景：用户说扣款了但系统没确认。不要靠人工查单，必须用查询兜底自动收敛：

对超时或处理中订单做定时查询，直到进入最终态：成功、失败、关闭。
客服侧提供一键查单能力，能看到交易状态与失败原因，减少扯皮与误判。

四、代付 Pay-out 全流程：出款要可控、可追踪、可审计

第 1 步：代付请求：先做风控分层，再提交出款

代付比代收更需要风控。建议按用户等级、历史行为、金额区间进行分层：高风险用户可采取延迟审核、分批出款、补充验证等策略。

第 2 步：出款状态追踪：必须可查询、可回调、可重试

状态可查询：每笔出款都能通过通道单号查询到最终状态。
失败原因可定位：失败需有清晰分类，便于客服解释与用户引导。
重试机制清晰：哪些失败允许自动重试，哪些必须人工介入，需要明确规则与日志链路。

第 3 步：对账与审计：资金口径一致的最后一公里

代付对账建议与代收统一口径：同一套报表字段、同一套状态定义、同一套时间口径，避免财务与运营对不上。

五、对账与结算：口径一次定清楚，后期就省事

对账报表建议至少包含以下字段：

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

强烈建议在系统内区分三种口径：支付成功、入账成功、可结算成功。把它们混在一起，会直接导致财务对不上、客服解释不清、现金流误判。

六、关于 D0 与同日结算：正确理解更快结算策略

更快结算不是无条件秒到，更准确的理解是：在满足业务与风控评估的前提下，让资金更早进入可用状态。实际开通与规则以最终审批方案为准。

商户应重点确认：

结算条件：业务类型、交易质量、异常率与结算策略的关系。
结算口径：什么状态算可结算？异常单如何处理？
可预期性：规则透明、节奏稳定，能预测现金流，而不是每天问客服。

七、上线前验收清单：建议逐项打勾

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

八、联系币付对接开通：官方渠道

如你需要菲律宾代收代付方案：GCash 原生接入 + 代收代付闭环 + 回调、查询、对账、结算口径清晰，也可同时支持 QRPH 聚合收款，建议提前准备以下信息，便于快速评估：

业务类型、预计日订单量与月订单量
单笔金额区间、峰值并发、是否需要代付
回调域名 notify_url：如已准备
技术对接人联系方式

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

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