菲律宾第三方支付对接指南：GCash原生通道与代收代付集成全流程

想在菲律宾做本地收款与批量代付，最关键的是两件事：支付成功率与资金结算稳定性。本文以GCash原生通道 + QRPH为核心场景，整理一套面向商户、平台、出海团队可直接落地的代收代付集成全流程，覆盖从接入准备、API对接、回调通知、对账结算到风控合规的完整链路。

一、什么是菲律宾代收代付，适合哪些业务

代收：用户通过本地支付方式完成付款，例如 GCash、QRPH 等，平台或商户完成订单入账。

代付：平台向用户、代理、商户发起资金付款，支持单笔、批量、自动化打款，常用于提现、佣金结算、工资、退款、派奖等。

常见落地场景

电商与数字产品：本地钱包收款，退款与补偿出款
游戏与娱乐充值：充值代收，代理佣金与用户提现代付
跨境出海：PHP 本币收款，对公或对私批量结算
平台招商：多商户分账、统一收单、周期结算

二、GCash原生通道与QRPH，为什么是标配组合

覆盖广：GCash 是菲律宾高频使用的钱包之一；QRPH 作为统一二维码标准，有利于提升多入口支付成功率。
体验顺：唤起与跳转路径清晰，适合 H5、APP、收银台页等多端。
对账清晰：订单号、回调、支付状态能形成闭环，更易做自动化对账与风控。

三、接入前准备：把上线阻力提前清零

1）商户资料与业务信息

公司或个人主体信息，联系人与技术负责人
业务类型与资金流向说明，包含代收、代付、分账等
预计交易量级、客单价区间、主要收款方式
网站或APP信息与支付页面截图，如有

2）技术侧必备能力

HTTPS：接口请求与回调建议全程 HTTPS
回调可达：公网可访问的 notify_url，并能快速返回确认
幂等处理：同一订单重复回调或重复查询，不应造成重复入账
对账数据沉淀：至少保存订单、支付流水、回调原文、签名校验结果

四、系统架构建议：代收与代付的闭环模型

为了稳定与可扩展，建议将支付系统拆成三层：

订单层：创建订单、金额校验、订单状态机，created / paying / success / failed / closed
通道层：收单与代付接口封装、签名、重试、限流、通道降级
结算层：余额台账、对账、清分、商户结算、异常处理，补单、冲正、退款

五、代收对接流程：从创建订单到回调入账

Step 1：创建支付订单，服务端

生成 merchant_order_no，全局唯一
写入订单金额、币种 PHP、用户标识、商品信息
请求通道创建支付，获取支付链接、二维码或唤起参数

Step 2：前端收银台展示，H5或APP

展示 GCash 支付按钮或 QRPH 二维码
明确提示金额、订单号、支付有效期与常见失败原因
支付完成后引导用户返回，并显示正在确认支付结果

Step 3：异步回调，notify_url

回调到达后先做签名校验与金额校验
通过后更新订单状态为 success，并记录上游流水号
对回调做幂等：同一订单多次回调仅允许成功入账一次

Step 4：主动查询兜底，query

任何网络环境都可能出现回调延迟或丢失。建议上线后保持：

支付完成页触发一次查询
后台定时补单：对 paying 状态订单进行多次间隔查询，最终确认成功或关闭

六、代付对接流程：提现、佣金、批量打款如何更稳

1）代付发起策略

提现：建议申请、审核、打款三段式，降低欺诈风险
批量佣金与工资：按批次生成 payout_batch_no，单笔生成 payout_order_no
失败重试：可重试错误走队列重试；不可重试错误进入人工处理

2）代付状态机建议

created：已创建
processing：处理中
success：成功
failed：失败，附失败码与原因

3）代付风控关键点

收付一致性：新用户首次提现额度与频率限制
设备与行为：异常登录、异常IP、短时间大量申请
名单策略：黑名单、灰名单、白名单分层，减少误杀与漏放

七、回调与签名：线上最容易翻车的地方

回调处理建议

回调接口必须快速响应：先落库，再异步处理耗时业务
必须校验：签名、金额、币种、订单号是否存在、订单状态是否允许变更
回调原文建议完整保存，便于排障与争议处理

幂等的最低实现

订单表增加 success_time 与 paid_trade_no
订单状态从 paying 到 success 只能成功一次，数据库层加约束更稳

八、对账与结算：把资金安全感做出来

代收代付系统想长期稳定跑量，必须建立每日对账与异常兜底机制：

订单对账：本地订单对比通道订单，定位本地失败但通道成功、本地成功但通道失败等差异
资金对账：入账、手续费、退款、代付、余额变动可追溯
异常处理：补单、冲正、退款、人工复核都有清晰入口

实时费率

[rate-table type="all"]

九、上线前自检清单

支付订单号全局唯一，且可追溯到用户与业务场景
notify_url 可公网访问，签名校验通过率稳定
回调幂等已完成，重复回调不会重复入账
主动查询与补单任务已跑通
代付批次与单笔状态可追踪，失败原因可解释
对账报表能输出成功、失败、差异、资金汇总
日志齐全：请求、响应、回调原文、错误码、重试记录

十、常见问题

Q1：为什么要回调加主动查询双保险

回调依赖网络与链路稳定性，任何环节抖动都可能造成延迟或丢失。双保险能显著降低用户已付款但订单未入账的纠纷率。

Q2：代付失败怎么处理更合理

先区分可重试与不可重试。可重试走队列重试；不可重试进入人工复核，并给出明确失败原因与二次处理方案，例如更换账户、调整金额、延后打款。

Q3：多商户多业务线，如何做清分与结算

建议使用主订单、子订单、商户台账模型：收单统一进入主账户，再按规则拆分到不同商户台账，最后按周期或阈值结算。

十一、为什么选择币付：更适合长期稳定跑量的团队

菲律宾本地支付覆盖：GCash 原生与 QRPH 场景可落地
代收代付一体：同一套系统完成收款与付款闭环
对账与风控思路清晰：更利于规模化运营与降低纠纷
技术对接友好：接口封装、签名校验、回调与补单策略可协助落地

立即获取对接方案与测试资料

如需按你的业务场景定制对接方案、结算模型与风控策略，直接联系币付：

Telegram：@Bifuapp
邮箱：[email protected]