菲律宾 GCash 原生支付接入与四方代收代付对接说明：币付 Bifu 标准化方案

本文面向需要在菲律宾开展收款与付款业务的商户与平台方，说明如何接入 GCash 原生支付，并通过币付 Bifu 实现代收代付的标准化对接与运营落地。内容覆盖业务结构、对接流程、回调与对账、风控合规与上线清单，帮助你以更低的开发与运维成本稳定跑通收款、退款与代付闭环。

实时费率（GCash & QRPH）

[rate-table type="all"]

一、适用对象与典型场景

在菲律宾做收款与出款业务，难点往往不在“有没有支付方式”，而在于能不能稳定收、能不能清晰对账、能不能合规出款、异常能不能兜底。币付 Bifu 提供 GCash 原生支付能力，并可扩展 QRPH 等本地支付方式，帮助商户一次接入即可跑通收款、退款、代付与对账结算闭环。

当你在菲律宾提供商品或服务，例如电商、数字内容、订阅、平台撮合、线下扫码、线上收银台等，通常会遇到这些需求：

代收：用户使用 GCash 完成支付，你方获得入账结果与明细
代付：向用户、商户或代理发起付款，例如佣金、返现、提现、退款补偿等
资金流清晰可追溯：每笔订单与代付都能对上账，便于财务核算与风控审计
高并发与稳定性：支付状态变更能及时通知，异常可自动补偿与重试

如需覆盖更广的菲律宾本地支付组合，常见还包括 Maya（原 PayMaya）、GrabPay、Coins.ph、银行转账与 QRPH 扫码等。币付 Bifu 支持按你的业务形态进行组合接入与路由策略配置。

二、什么是“四方代收代付”

“四方”用于描述资金与信息链路的四类角色，便于明确责任边界与对接范围：

付款方：用户，在 GCash 侧完成授权与支付
收款方：商户或平台，发起收款订单并接收结果通知
服务方：币付 Bifu，提供聚合对接、订单路由、回调通知、对账结算、风控与运营支撑
通道方：GCash，执行钱包扣款并回传支付结果

对接的核心目标是用标准化接口把收款、退款、代付、对账串成闭环，让商户只需对接一次，即可稳定运行。

三、接入前准备：资料与边界

1）商户基础信息

商户主体信息：公司或个人主体、联系人、业务介绍
业务入口：网站或 App 入口、支付页截图或流程说明
商品或服务类型、定价方式、退款规则与用户协议
预估交易规模：用于设定限额与风控策略

2）技术对接信息

回调地址：接收支付、退款、代付结果通知
同步跳转地址：支付完成后的页面跳转（如需要）
服务器出口 IP：用于白名单配置（如需要）
签名密钥与接口密钥：仅服务端存储，并准备轮换方案

四、对接方式概览

收银台或跳转式：商户创建订单后跳转到支付页，用户在 GCash 完成支付，适合快速上线
API 直连式：服务端创建订单、查询状态、处理回调与对账，适合平台型业务、高并发与强运营场景

五、代收：GCash 收款对接流程

1）创建支付订单

建议下单字段做到可追溯、可对账、可幂等，常用要素包括：

商户订单号：商户侧唯一
订单金额与币种：建议以 PHP 为统一口径，避免多币种混算
商品或服务描述：用于用户识别与风控辅助
回调地址与可选跳转地址
附加参数：用于回传用户 ID、活动 ID、渠道 ID 等，避免放敏感信息

2）用户完成支付

交易状态通常会经历创建、处理中、成功、失败、关闭等变化。业务侧必须以异步回调为准，不要只靠前端跳转判断成功。

3）接收支付结果回调

回调处理必须做到三件事：

验签：校验签名与报文完整性，拒绝伪造通知
幂等：同一订单重复通知只能结算一次，避免重复发货与重复记账
可追踪：记录回调原文、处理耗时与最终结果，便于排障与对账

处理完成后返回明确成功响应，减少重复通知与延迟。

4）主动查询订单状态（兜底）

以下场景建议做主动查询兜底：

回调超时或未到达
用户端显示已支付，但商户端未更新
需要做支付超时关闭、库存回滚、订单补偿等逻辑

六、退款对接要点

退款建议采用服务端发起 + 异步通知 + 可查询兜底的闭环：

退款单号独立：与原订单关联，但在商户侧必须唯一
支持部分或全额：按业务规则限制次数与金额，防止滥用
退款结果异步：避免前端阻塞等待
退款可对账：退款也必须能在账单与对账单中闭环匹配

七、代付对接说明

代付用于向用户钱包发放款项，例如提现、佣金、赔付、活动奖励等。为确保合规与成功率，建议在业务侧做到身份一致、用途清晰、流程可追溯。

1）发起代付订单

代付订单号：商户侧唯一
收款人要素：按通道要求提供，例如手机号或钱包标识
代付金额与用途说明：避免敏感词与含糊描述
回调地址：接收成功或失败结果
可选风控字段：用户 ID、历史行为标识、业务类型等，用于降低拒付与命中风险

2）代付结果通知与重试策略

同样需要验签与幂等
失败原因必须落库，便于客服处理与用户解释
可重试失败：例如临时网络、通道繁忙，走业务补偿机制
不可重试失败：例如要素错误、风控拒绝，引导用户修正或转人工处理

八、签名与安全建议

全链路 HTTPS：回调与接口通信必须使用 HTTPS
签名校验：请求与回调均应验签，签名字段参与排序并固定编码
密钥隔离：密钥仅存服务端，不在前端或 App 中明文下发
回调来源控制：可结合 IP 白名单与验签双重校验
日志脱敏：手机号、用户标识、密钥等敏感信息需脱敏存储
限频与防刷：下单、查询、退款、代付接口做频控，避免恶意拖垮系统

九、对账与结算

对账目标是订单流、资金流、账单流三者一致，建议建立以下机制：

订单维度对账：以商户订单号为主键核对支付成功、退款成功、代付成功金额
差异处理：优先以通道回调与查询结果复核，再走人工复核
账单留存：保存原始账单明细与处理记录，便于审计与复盘
异常预警：成功率波动、回调延迟、退款或代付失败率上升触发告警

十、风控与合规要点

菲律宾本地支付对业务真实性、资金用途、异常交易较敏感。为提升通过率与稳定性，建议：

支付页面信息清晰：展示商品或服务信息、价格、退款规则与联系方式
交易限额分层：先小额跑通，再逐步放开额度与频次
提现与代付审核：对高风险用户或异常频次增加二次校验或人工审核
黑灰产防护：对批量注册、频繁失败支付、异常设备与 IP 行为建立拦截策略
争议处理路径：客服可追溯订单、支付结果、退款与代付记录，避免纠纷升级

十一、上线前检查清单

订单号、退款号、代付号：唯一且可追溯
回调：验签、幂等、超时与重试处理完善
状态机：支付成功才发货或开通服务，失败与关闭能回滚
对账：账单拉取、差异处理与留存机制已建立
风控：限额、限频、异常检测与人工处理通道齐备
客服：能快速定位订单并给出明确处理结论与建议

十二、币付 Bifu 支持与对接咨询

如你需要 GCash 原生支付接入、代收代付方案评估、技术联调与上线支持，可联系币付 Bifu：

Telegram：@Bifuapp
邮箱：[email protected]