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

面向在菲律宾开展线上收款与资金结算业务的商户与平台方，GCash 代收代付通道的核心价值在于：提升本地付款覆盖率、优化收款成功率、实现自动化代付与资金清分，并通过标准化对账与风控体系降低运营成本。币付（Bifu）为商户提供可落地的一体化接入与稳定运营能力，同时支持 GCash、QRPH 等本土支付场景。

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

一、什么是菲律宾代收代付

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

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

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

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

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

关键组件建议

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

四、代收接入流程要点

1）标准交易链路

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

2）必须做的三项校验

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

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

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

五、代付接入流程要点

1）代付适用场景

用户提现、代理佣金发放、商户结算、活动派奖、退款与冲正（按通道与业务策略）。

2）标准代付链路

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

3）代付稳定性关键点

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

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

1）建议对账字段

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

2）差错处理闭环

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

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

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

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

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

九、费率与结算

费率表：

[rate-table type="all"]

十、币付对接支持

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

Telegram：@Bifuapp
邮箱：[email protected]

上线前检查建议

回调幂等验证：重复回调、乱序回调、延迟回调都能稳定收敛到同一结果。
异常场景演练：断网、超时、重复请求、补单、退款与冲正（如启用）全流程可回放。
对账差异处理：差异识别、冻结策略、补单路径、人工工单闭环可执行。
压测与告警：成功率、延迟、失败码分布、代付失败原因聚合有监控与告警阈值。