菲律宾 GCash 代收代付接入指南｜Pay-in 下单确认、回调幂等、代付出款与对账口径（币付）

适用场景：菲律宾电商、订阅、数字内容、平台型业务、充值类业务。目标是把代收、代付、对账、结算做成闭环，避免掉单、重复入账、争议单与财务口径混乱。

在菲律宾做本地收款，GCash依然是高频选择；不少商户也会同时对比或补充接入 Maya（PayMaya）、Coins.ph、GrabPay 等渠道，以覆盖更多用户支付偏好。币付（Bifu）提供菲律宾本地代收代付能力，支持通过 GCash 完成收款与出款，并按业务形态与风险表现匹配结算策略。

一、上线前准备：先把业务与风控边界定清楚

业务类型与商品形态：电商、订阅、数字内容、平台、充值等。不同形态对应不同风控策略与限额逻辑。
交易画像：单笔金额区间、日订单量、峰值并发、退款与争议比例预估。
资金闭环需求：仅代收，或代收加代付。平台型业务通常更需要闭环能力。
结算诉求：同日结算、D0、T+N 等属于策略能力，需要结合开通方案与规则执行。

二、代收 Pay-in 接入流程：从下单到最终确认

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

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

merchant_order_no：商户订单号，全局唯一，建议可追溯。
amount 与 currency：金额与币种。
user_id：你系统内部用户标识。
biz_code：业务标识，用于风控分层、运营统计、对账汇总。
notify_url：回调地址，长期稳定可访问。

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

无论是收银台、跳转、唤起 App，最终都必须以回调通知或订单查询作为“最终裁决”。不要把“用户支付完成页面”当作最终成功依据。

Step 3：回调通知：验签与幂等是稳定性的底线

回调要做到三件事：可达、可验、可重入。

可达：notify_url 具备监控、容灾与自动重试接收能力。
可验：严格验签，订单号、金额、状态、时间戳等关键字段必须参与签名校验。
可重入：同一订单可能多次回调，多次通知只能入账一次。

推荐处理顺序：先入库落状态与回调原文，再执行业务动作（发货、加点、开通会员）。业务动作务必基于“幂等锁”或“状态机”触发，避免重复处理。

Step 4：订单查询兜底：终结“用户说扣款但系统没到账”

对处于“处理中、超时、未知”等中间态的订单定时查询，直到进入最终态。
为客服提供一键查询入口，直接输出明确结论与时间线，减少争议与误判。

三、代付 Pay-out 接入流程：出款要可控、可追踪、可审计

Step 1：提交代付请求：先做分层风控

代付比代收更敏感。建议按用户等级、历史行为、金额区间做分层策略；对异常行为启用延迟审核、分批出款、补充验证等手段。

Step 2：出款状态追踪：必须可查询、可回调

payout_order_no：每笔代付要有代付单号，支持查询最终状态。
channel_payout_no：通道单号用于通道侧追溯。
失败原因可分类：便于客服解释与用户引导。
重试规则清晰：哪些失败允许自动重试，哪些必须人工介入，要提前定义。

Step 3：代付对账与审计：避免口径混乱

建议代付与代收统一字段与状态定义，统一时间口径，统一报表结构，减少财务与运营对不上账的概率。

四、对账字段与结算口径：一次定清楚，后期省大量人力

对账报表建议至少包含：

商户订单号 merchant_order_no、通道订单号 channel_order_no
订单金额 amount、手续费 fee、结算金额 settle_amount
订单状态 status、失败原因 fail_reason
支付完成时间 paid_at、入账时间 credited_at、结算时间 settled_at

建议在系统里明确区分三类状态：

支付成功：用户侧付款完成。
入账成功：平台侧确认记账完成。
可结算：满足风控与结算规则，资金进入可结算或可用状态。

五、关于更快结算：D0 与同日的正确理解

更快结算的核心是“在满足风控规则前提下更早进入可用状态”，不是无条件秒到。商户在开通前应确认：

结算触发条件：业务类型、交易质量、异常率与结算策略之间的关系。
口径定义：什么状态算可结算，异常单如何处理。
节奏可预期：规则透明、节奏稳定，现金流可预测。

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

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

七、GCash 与 QRPH 实时费率表

[rate-table type="all"]

八、常见问题与处理建议

1）回调收不到怎么办

先看你方 notify_url 是否可达、是否有拦截与超时。
用订单查询兜底收敛最终状态，不依赖单次回调。

2）重复回调导致重复入账怎么办

用 merchant_order_no 做唯一幂等键。
状态机只允许从“未确认”推进到“已确认”一次。

3）用户说扣款但系统没成功怎么办

不要人工拍脑袋补单，走“订单查询兜底”自动判定。
把查询结果与时间线输出给客服，减少争议。

4）代付失败怎么解释与处理

失败原因要可分类：账户问题、风控拦截、通道异常、信息不匹配等。
明确哪些失败支持自动重试，哪些需要人工核验后再处理。

九、联系币付开通对接

如需通过 GCash 接入菲律宾代收代付服务，并获得收款、代付、对账与结算的一体化方案，请准备以下信息以加速评估与开通：

业务类型、预计日月订单量、单笔金额区间、峰值并发
是否需要代付闭环，代付规则是否涉及分账、分批、审核
notify_url 回调域名与技术对接人信息

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

安全提示：请仅通过以上官方渠道确认对接信息，不要相信非官方来源的“客服账号、钱包地址或收款二维码”。