菲律宾GCash代收代付通道接入指南：支付系统架构、对账清分与风控要点

面向在菲律宾开展线上收款与资金结算业务的商户与平台方，GCash 代收代付通道的核心价值在于：提升本地付款覆盖率、优化收款成功率、实现自动化代付与资金清分，并通过标准化对账与风控体系降低运营成本。

本文从“系统架构—接口流程—对账清分—风控合规—运营稳定性”五个层面，梳理菲律宾代收代付服务的接入要点，帮助技术与运营团队快速落地。

一、什么是菲律宾代收代付（Collection & Payout）

代收（Collection）：用户通过 GCash 完成付款，平台侧获取支付结果通知，并完成订单入账与业务履约。
代付（Payout）：平台向用户/代理/商户发起资金打款（如提现、佣金、退款、结算），并接收代付状态回调与结果对账文件。
适用业务：电商、数字内容、游戏点卡、平台型撮合、订阅续费、代理分佣、跨境业务本地收款与本地放款等。

二、接入前需要明确的业务模型（避免后续返工）

资金流向：款项入账主体、结算主体、是否存在分账/多级清分、是否需要批量代付。
订单模型：单订单单支付 / 合并支付 / 预付-补差 / 退款与冲正策略。
回调策略：前端同步返回（页面跳转）与后端异步回调（Webhook）并行，确保“用户体验+数据一致性”。
幂等要求：订单号、代付单号必须全链路唯一；重复请求不应重复入账或重复出款。
对账口径：交易成功定义、手续费口径、净额/毛额、差错处理与补单机制。

三、系统架构建议：四层拆分，稳定可控

交易层：下单、支付、代付、订单查询、退款/冲正（如适用）。
通知层：Webhook 回调接收、验签、重试、去重、入库、投递到消息队列。
账务层：入账、出账、手续费、清分、余额、冻结、分账（如适用）。
风控层：黑名单、限额、频控、设备/账号风险、异常交易拦截、人工复核通道。

建议的关键组件

订单中心：统一管理支付单、代付单、退款单、冲正单，状态机可追溯。
回调网关：独立服务，专门负责验签、幂等、落库、重试、告警。
对账服务：按日拉取账单/流水，做差异对比，支持自动补单与人工工单。
监控与告警：成功率、回调延迟、超时率、异常码分布、代付失败原因聚合。

四、代收（Collection）接入流程要点

1）标准交易链路

创建订单：传入金额、币种、订单号、用户标识、回跳地址、回调地址等。
发起支付：引导用户完成 GCash 付款（H5/跳转/聚合收银台等形态按业务选择）。
接收回调：以 Webhook 为准，前端回跳仅作提示，避免“用户关页导致漏单”。
订单确认：以“验签+金额校验+商户号校验+状态机流转”为准，入账后再发货/发币/开通权益。

2）必须做的三项校验

验签校验：所有回调、查询结果都需要验签，禁止只信任前端返回。
金额校验：币种、金额必须与下单一致；出现不一致直接进入异常队列。
订单状态机：只允许“待支付→支付成功/失败→已入账（或已履约）”的可控流转，禁止跨状态写入。

3）回调与补单的工程化建议

幂等键：使用“商户订单号 + 通道流水号”作为唯一约束，重复回调只更新一次。
重试策略：回调接收后先快速返回成功响应，再异步处理业务，避免回调超时触发通道重复推送。
补单机制：定时扫描“超时未确认订单”，主动调用订单查询接口进行状态拉齐。

五、代付（Payout）接入流程要点

1）代付适用场景

用户提现、代理佣金发放、商户结算、活动派奖、退款（若业务与通道支持）。

2）标准代付链路

创建代付单：代付单号、收款人信息、金额、用途、备注等。
发起出款：提交到通道；通道返回受理结果（不等于最终成功）。
接收代付回调：回调状态可能经历“受理中→成功/失败”。
出款落账：账务层按最终状态记账；失败支持自动重试或转人工复核。

3）代付稳定性关键点

受理与最终状态分离：不要把“已受理”当作“已成功”。
失败原因归因：将失败码映射为可运营的原因分类（信息不一致、风控拒绝、余额不足、网络异常等）。
批量代付：批次号 + 单笔明细号双层结构，便于追踪与重跑。
幂等与防重：同一代付单号重复提交必须返回同一结果，避免重复打款。

六、对账清分：把“钱”和“订单”对齐

1）建议对账字段

商户订单号/代付单号
通道流水号
交易金额、手续费、净额
交易状态、交易时间戳（以通道流水口径为准）
付款方标识/收款方标识（如适用）

2）差错处理闭环

长时间无回调：主动查询 + 延迟重试 + 人工工单。
回调成功但本地未入账：以对账为准补入账，记录补单来源与原因。
本地已成功但对账失败：进入风险队列，冻结该订单后续结算，等待核查。

七、风控与合规：让业务跑得久、跑得稳

基础风控：单用户限额、单日限额、频控（同设备/同IP/同账号）、黑名单、异常金额拦截。
交易一致性：支付账号与业务账号的绑定策略（必要时要求一致或二次校验）。
反欺诈策略：设备指纹、行为特征、地理位置异常、短时间高频小额/大额切换等。
敏感业务控制：对高风险类目采用更严格的准入与审核；保留可追溯日志与审计链路。
数据留存与审计：订单全链路日志、回调原文、验签结果、状态变更记录、操作人记录（后台）统一留存。

八、接口落地清单：技术团队可直接对照实施

支付接口：下单、发起支付、订单查询、关闭订单（如适用）。
代付接口：创建代付、代付查询、批量代付、失败重试（按策略）。
通知接口：支付回调、代付回调、对账文件通知（如适用）。
安全能力：签名/验签、IP 白名单（可选）、重放防护、敏感字段脱敏。
运营能力：监控面板、成功率报表、失败码分析、自动补单、对账差异工单。

九、费率与结算

费率表：

[rate-table type="all"]

十、币付对接支持

如需获取对接参数、联调指引、回调验签示例、对账字段说明与上线检查清单，可联系币付客服：

Telegram：@Bifuapp
邮箱：[email protected]

提示：上线前务必完成回调幂等验证、异常场景演练（断网/超时/重复回调/补单）、以及对账差异处理流程的全链路压测与回放。