Bifu 支付平台：菲律宾原生 GCash 接入与代收代付接口对接指南

币付 Bifu 面向菲律宾本地与跨境商户，提供原生 GCash 收款接入与代收代付能力，帮助商户快速搭建支付链路、打通对账结算，并将风控与合规要求落到可执行的工程细节。本文从能力范围、接入流程、接口设计与稳定性治理出发，给出可直接落地的对接说明。

一、能力概览：原生 GCash 与代收代付一体化

在菲律宾市场，GCash 是高频支付方式之一。币付 Bifu 通过原生链路与统一账务体系，让商户同时具备收款、资金归集、资金分发、对账结算与交易治理能力。

• 原生 GCash 收款：覆盖 H5、App、PC 等多终端支付场景，可用于线上下单、充值、订金等收款链路。
• QRPH 相关能力：支持以二维码标准化方式提升线下或混合场景的支付体验与核验效率。
• 代收代付：支持向用户、供应商、代理等进行资金分发，也支持渠道化资金归集与账务追踪。
• 统一订单体系：收款与代付在同一平台订单与流水体系内流转，便于审计、追踪与售后处理。
• 对账与结算：支持交易查询、账单下载、差错处理、结算明细与余额管理。
• 风控能力：支持黑白名单、频控、异常识别、风控策略扩展与合规流程协同。

二、适用商户与典型业务场景

• 电商与数字商品：订单支付、退款、活动收款、供应链打款、平台分发。
• 本地生活与服务：预约订金、到店核销、服务结算、佣金代付。
• 跨境业务：面向菲律宾本地用户收款，资金归集后再进行分发与结算管理。
• 平台与分销体系：多层级账户、代理佣金发放、渠道结算与对账闭环。

三、接入准备：资料、账户与稳定性前置

为确保资金安全与交易稳定，建议在对接前完成以下准备：

• 主体与业务信息：公司或个人资质、联系人信息、业务说明、网站或应用信息。
• 结算信息：结算账户资料、结算周期诉求、对账方式与账单字段需求。
• 合规与风控策略：按业务类型配置 KYC 与 AML 相关要求，明确退款、争议与异常交易处置口径。
• 技术准备：回调地址可公网访问，签名验签组件可用，订单号规则清晰，幂等策略与重试策略已定稿。

四、整体对接流程：从联调到上线的建议路径

1. 开通与配置：开通商户后台，获取 API Key 与 Secret，完成回调地址与白名单等基础配置。
2. 核心链路联调：完成下单、支付、回调验签、订单查询、退款或撤销等必要能力验证。
3. 对账闭环建设：打通账单下载或查询接口，建立日对账、差错处理、补单与冲正机制。
4. 风控策略上线：启用频控、黑白名单、风险分层与人工复核，完善告警与工单流程。
5. 生产发布：切换生产密钥与正式回调地址，进行灰度与容量评估后全量上线。

五、接口设计要点：稳定、可扩展、可追溯

1. 核心对象与字段建议

• merchant_order_no：商户侧订单号，必须全局唯一，建议具备可追溯编码规则。
• platform_order_no：平台订单号，用于对账、售后与审计追踪。
• amount 与 currency：金额与币种必须严格校验，统一格式化与精度规则。
• notify_url：回调地址需高可用，支持超时重试与快速响应。
• metadata：扩展字段承载业务信息，注意脱敏与合规范围控制。

2. 收款链路建议

• 创建订单：返回支付参数或跳转链接，按终端选择 H5、App 拉起或二维码展示。
• 支付完成回调：以平台回调为准更新订单状态，商户必须验签并做幂等处理。
• 主动查询兜底：用于回调异常、用户中断、网络抖动等场景下的最终状态确认。

3. 代付与资金分发建议

• 代付申请：发起转账或打款请求，返回受理结果与平台流水号。
• 结果异步通知：建议区分受理成功与最终成功，避免将处理中误判为到账成功。
• 资金路由与审核：可按限额、频次、风险等级启用分层审核，降低大额与高频风险。

六、安全与风控：必须落到工程细节

• 签名与验签：请求与回调统一签名机制，按固定字段顺序与编码规范验签。
• 幂等：支付回调、代付回调、退款回调都可能重复投递，必须以订单号或流水号做幂等。
• 回调安全：建议配置来源限制与频控策略，降低被刷回调与重放攻击风险。
• 敏感信息保护：日志严禁明文记录密钥与敏感账户信息，存储与展示做脱敏。
• 异常处置：建立黑名单、限额、频控与人工复核流程，配合告警与工单闭环。

七、对账与结算：上线后稳定性的关键

建议建立交易、账单、结算三段式闭环：

• 交易明细：以平台订单为准获取状态、手续费、渠道信息与时间戳，用于审计与追踪。
• 账单对账：按日拉取账单并与商户订单表核对，发现差错及时补单或冲正。
• 结算管理：跟踪结算批次、到账状态与失败原因，沉淀财务凭证与结算报表。

八、费率说明

下方展示币付 Bifu 已配置的费率信息，覆盖 GCash 与 QRPH。具体以商户后台配置与实际签约为准。

[rate-table type="all"]

九、常见问题

1. 回调收不到怎么办

优先用订单查询接口确认最终状态，同时检查回调地址可达性、验签逻辑、响应超时与网络防火墙策略。

2. 订单状态不一致如何处理

以平台最终状态为准，配合对账闭环执行补单、重试或冲正，确保资金与账务一致。

3. 如何降低支付失败率

优化前端唤起流程，减少跳转链路，设置合理超时与重试策略，并为异常场景提供清晰的用户引导。

4. 为什么代付建议做分层审核

对大额或高频分发场景，分层审核能显著降低误付与欺诈风险，减少异常损失。

十、获取接口文档与技术支持

如需获取币付 Bifu 的接口文档、对接示例、联调环境参数与上线支持，请联系：

• Telegram：@Bifuapp
• 邮箱：[email protected]
• 品牌：币付