菲律宾代收代付平台接入指南：GCash收款与批量付款一体化解决方案

面向在菲律宾开展业务的平台与商户，币付 Pay 提供基于 GCash 等本地钱包的代收代付能力，覆盖收款、付款、对账、风控与结算管理，支持 API 快速接入与多场景资金流转，帮助业务提升转化与资金周转效率。

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

代收通常指平台为商户或业务方完成线上收款能力的落地，例如通过 GCash 等本地钱包完成用户付款与订单支付。

代付则指平台按业务规则向用户、供应商、代理等发起单笔或批量付款，用于提现发放、佣金结算、退款补偿、活动派奖等资金分发场景。

在菲律宾市场，代收代付的核心价值在于：本地化支付覆盖 + 稳定的资金结算链路 + 可审计的对账与风控，让业务在合规与可控的前提下实现规模化运营。

二、典型业务场景

线上平台收款：电商、内容订阅、游戏点卡、数字服务等，为用户提供 GCash 付款入口。
批量代付：代理返佣、主播与骑手结算、兼职薪酬、供应商货款结算、活动派奖、用户提现等。
订单型资金流：订单支付成功后按规则拆分平台服务费、渠道成本、商户结算额。
退款与补偿：订单取消、售后补偿、差额返还等自动化出款与闭环处理。

三、币付 Pay 方案概览

币付 Pay 以“收款—通知—入账—对账—结算—付款”的闭环为目标，提供可直接落地的菲律宾本地资金处理能力：

代收能力：支持 GCash 等本地支付方式收款，适配多终端与多订单模式。
代付能力：支持单笔与批量出款，按业务字段与风控策略执行。
对账能力：提供交易流水、账务明细、渠道账单核对与差异定位。
风控能力：黑白名单、频控限额、账号与设备风险策略、回调校验与签名机制。
结算能力：支持按周期或按规则结算，提供资金看板与统一报表口径。

四、接入前需要准备的资料与边界

为保障交易稳定性与资金安全，建议在对接前明确以下要点：

业务形态：交易类型与资金流向，例如用户到平台或商户、平台到用户或供应商。
订单结构：订单号规则、金额币种、商品或服务描述、回调入账口径。
结算规则：是否拆分、是否冻结、是否需要风控审核后出款。
风控要求：单笔限额、日累计、异常订单处理、退款策略与申诉流程。
技术条件：HTTPS、回调白名单、签名验签实现能力、服务器可访问性。

五、标准接入流程

1）商户开通与参数下发

分配商户号 Merchant ID 与密钥 API Key/Secret。
配置回调地址 Notify URL 与跳转地址 Return URL。
确认 IP 白名单、签名算法与时间戳规则。

2）代收下单与收款

创建支付订单：传入订单号、金额、用户标识与业务扩展字段。
返回支付要素：跳转链接、二维码或支付凭证等。
用户完成支付后，系统通过回调通知订单状态。

3）回调验签与幂等处理

回调处理建议遵循以下原则：

先验签后入账：验签通过再更新订单状态与账务信息。
幂等防重：同一订单多次通知不得重复入账或重复发货。
状态机管理：订单状态按既定路径流转，避免回退与覆盖。

4）对账与结算

按商户维度提供交易流水与账务口径。
支持按周期导出或拉取对账数据，定位差异订单并形成闭环。
按约定结算规则执行结算，输出可追溯的结算批次与明细。

5）代付出款与提现

创建代付请求：传入出款单号、收款人信息、金额、用途与扩展字段。
风控校验：频次、限额、黑名单、异常行为触发审核或延迟。
代付结果回调：返回成功、失败或处理中状态，以及渠道流水号与失败原因。

六、关键能力说明

1）风控策略建议

限额体系：单笔、单日、单账户、单设备多维度分层限额。
频控策略：短时间高频下单或高频提现触发拦截、二次验证或人工审核。
名单体系：黑名单拒绝，灰名单审核或延迟，白名单快速通行。
风险审计：保留关键字段如 IP、UA、设备指纹与业务扩展参数，便于追溯。

2）对账口径与数据字段

交易口径：订单金额、手续费、实收金额、渠道流水号、订单状态。
账务口径：入账时间、结算批次、结算金额、差异原因、调整记录。
出款口径：出款单号、收款人信息、出款状态、失败原因、重试记录。

3）安全与合规要点

接口安全：全链路 HTTPS、签名验签、时间戳与随机串防重放。
权限隔离：按商户、子商户与应用维度隔离密钥与权限。
日志审计：订单、回调、出款、人工操作留痕，便于排查与审计。
敏感数据：避免前端暴露关键密钥与敏感字段，必要时做脱敏与加密。

七、费率与结算

[rate-table type="all"]

八、常见问题

1）回调偶发重复怎么办

按“幂等 + 状态机”设计：同一订单号的成功入账只执行一次。重复回调直接返回成功响应，但不重复处理。

2）代付失败如何处理

建议区分“可重试失败”和“不可重试失败”。可重试类按策略自动重试或转人工处理；不可重试类返回明确原因，引导用户更换收款信息或走人工核验。

3）如何减少对账差异

统一订单号规则，完整记录渠道流水号，确保回调验签与入账口径一致，并定期拉取账单核对差异订单，形成闭环处理。

九、对接与技术支持

如需获取接入参数、API 对接说明与测试联调支持，请联系币付 Pay：

Telegram：@Bifuapp
邮箱：[email protected]