菲律宾支付接入方案：支持 GCash 直连与间连的通道选型与对接落地指南

面向在菲律宾开展收款业务的商户与技术团队，本文从直连与间连的通道差异、业务场景匹配、系统架构、API 对接要点、风控与对账结算流程等维度，给出一套可直接落地的 GCash 接入方案与上线清单，帮助商户以更低的集成成本获得更稳定的收款体验。

一、为什么需要同时支持 GCash 直连与间连

菲律宾本地电子钱包渗透率高，GCash 是高频支付方式之一。对商户而言，单一通道往往难以覆盖所有场景与风险边界：有的业务追求更高稳定性与更强可控性，适合直连；有的业务需要快速接入、快速开通、多支付方式聚合，间连更具效率。

币付 Bifu 同时支持直连与间连接入，便于商户根据业务阶段、合规要求与风控策略进行组合部署，在成功率、成本与上线速度之间做到可控平衡。

二、直连与间连的差异与适用场景

接入速度：直连流程更严格，资料与联调更完整；间连更标准化，上线更快。
通道可控性：直连更强，可对回调、重试、风控策略做精细化配置；间连依赖聚合侧的标准策略。
稳定性与容灾：直连可构建更强链路监控与容灾策略；间连更依赖聚合平台整体能力。
适用业务：直连适合高并发、高交易量、对成功率与可控性要求高的业务；间连适合快速试跑、MVP、需要多支付方式统一接入的业务。
合规与风控配合：直连可支持更细粒度 KYB 与交易监测策略；间连可更快落地基础合规与风控要求。

选型建议

优先直连：交易量大、成功率波动敏感、需要更强的回调控制与对账审计、风控策略需要可解释与可追溯。
优先间连：业务刚进入菲律宾、产品需要快速上线验证、希望一次接入覆盖多种支付方式。
组合部署：核心主链路走直连，间连作为备用或补充覆盖长尾场景，提升整体可用性与抗波动能力。

三、币付接入架构建议

为降低支付链路风险并提升可运维性，建议将支付能力拆分为四层，做到可扩展、可审计、可对账：

业务层：订单、用户、商品、营销与退款策略。
支付编排层：统一下单、通道路由、幂等、重试与降级。
风控与合规模块：KYB、限额、黑白名单、设备与行为识别、异常交易拦截。
清结算与对账层：交易流水、手续费、结算批次、差错处理、自动对账与报表。

建议采用服务端下单与异步回调确认的标准流程，避免仅依赖前端跳转结果，从而提升最终一致性与抗网络抖动能力。

四、核心支付流程

1. 统一下单与幂等

商户系统生成 merchant_order_no 作为全局唯一订单号，用作幂等键。
调用币付下单接口，获取支付凭证，如跳转链接、二维码或指令参数。
用户完成支付后，以回调与查询确认最终结果，确保结果一致。

2. 回调验签与状态落库

对回调请求进行签名校验，并按需启用 IP 白名单策略。
回调处理必须幂等，同一笔交易多次回调只落一次账。
对未收到回调的订单，使用定时补单查询机制兜底。

3. 退款与冲正规则

退款需绑定原交易号，按配置支持全额或部分退款。
高风险品类建议启用退款审核或延迟退款策略，降低欺诈与纠纷风险。

五、技术对接要点

1. 签名与密钥管理

使用服务端签名机制，严禁将密钥下发到前端。
密钥分环境管理，测试与生产隔离，并支持轮换与失效控制。

2. 超时、重试与幂等

下单接口客户端超时不等于失败，必须以订单查询结果为准。
回调接口只有在返回成功应答后才视为已接收，否则将触发重试。
所有写操作接口建议携带幂等键，避免重复扣款或重复入账。

3. 状态机设计

PENDING：已下单未确认
SUCCESS：支付成功
FAILED：支付失败或关闭
REFUNDED：已退款，可扩展部分退款状态

4. 对账字段一致性

为减少差错处理成本，建议商户系统至少保留下列字段：

merchant_order_no
bifu_trade_no
amount 与 currency
channel，标识 GCash 直连或间连
status 与 status_time
fee 与 settlement_batch

六、费率与结算

[rate-table type="all"]

结算与资金管理建议

结算周期：按协议配置 T+N 或更灵活周期，并提供结算批次号便于追踪。
对账策略：日对账为基础，高交易量建议引入小时级增量对账。
差错处理：建立长账、短账、重复账三类问题的自动化工单与复核流程。

七、合规与风控

在菲律宾开展支付业务，建议以可审计、可追溯、可解释为目标，重点关注：

商户准入：主体信息、行业属性、经营范围、结算账户一致性与风险分级。
交易监测：频次、金额、地域、设备指纹、异常行为模型与黑名单策略。
限额与频控：按商户等级、用户等级、场景类型配置单笔与单日累计规则。
数据安全：传输加密、最小权限、日志脱敏、敏感数据分级与访问审计。

八、上线前检查清单

测试环境联调完成：下单、回调、查询、退款全链路通过
回调验签与幂等已实现，回调接口具备高可用与限流保护
订单状态机与补单任务已上线，可覆盖回调丢失与延迟场景
对账字段齐全，已跑通对账单解析与差错处理流程
风控规则已启用：限额、频控、黑白名单与高风险拦截策略
监控告警已配置：成功率、耗时、回调堆积、异常比例与通道降级

九、币付接入与技术支持

币付 Bifu 支持菲律宾本地收款场景的通道接入与系统化落地，覆盖 GCash 直连与间连、回调对账、风控策略与清结算能力，适用于电商、数字服务、线下门店、订阅与充值等多类业务。

客服 Telegram：@Bifuapp
客服邮箱：[email protected]