Bifu 支付平台接入指南：GCash 直连与菲律宾本地支付渠道整合方案

在菲律宾市场，GCash 等本地电子钱包已成为高频支付方式。商户若希望降低支付跳转损耗、提升成功率并加快资金周转，选择稳定、可扩展、可对账的支付接入方案是关键。币付为电商、线上娱乐、数字服务、线下门店等场景提供 GCash 及多本地支付渠道的统一接入能力，并覆盖交易、风控、结算、对账全流程管理。

一、币付能解决什么问题

多渠道统一接入：同一套接口与管理后台对接 GCash 与菲律宾本地支付渠道，减少多供应商对接与维护成本。
提升支付转化：通过稳定链路、可靠回调与异常补偿策略，降低支付中断、订单悬挂、状态不一致等问题。
结算与对账清晰：提供订单、交易、结算、退款等维度的数据查询与导出，便于财务核算与运营分析。
风控与合规治理：支持基础风控策略、限额与黑白名单等能力，帮助商户降低欺诈与异常交易风险。

二、核心能力模块

1. 收款能力

支持创建支付订单、获取支付参数、引导用户完成支付与结果确认。
支持多种订单模式，例如一次性支付、分笔支付、组合支付，具体以商户配置为准。
支持异步回调 Webhook 与主动查询接口双通道，确保订单状态可追溯。

2. 代付能力

支持向用户、商户或供应商进行资金划拨与批量代付，按资质与风控策略开通。
支持代付状态查询、失败原因回传与重试机制，降低人工处理成本。

3. 退款与差错处理

支持全额与部分退款，并可追踪退款状态。
支持异常订单差错处理流程，按渠道规则执行。

4. 结算与对账

提供清晰的结算规则与结算明细，便于商户按周期对账与核算。
支持按商户订单号、平台交易号、渠道流水号等维度查询与导出。
支持定位常见对账差异：金额差、状态差、重复交易、回调缺失等。

5. 安全与风控

签名与验签：请求与回调采用签名机制，降低数据篡改风险。
回调安全：回调地址白名单、签名校验、防重放策略等。
基础风控：频次限制、金额阈值、黑白名单、异常设备与异常 IP 识别等，支持按业务定制。

三、对接方式与技术要点

1. 标准化接口对接

下单接口：创建支付订单并返回支付所需参数。
回调接口：平台异步通知订单结果，商户需返回确认响应。
查询接口：用于对账与异常兜底，适用于回调未达或网络抖动等情况。

2. 建议的订单状态机

为避免支付完成但订单未更新的运营事故，建议采用严格状态管理：

INIT：订单创建成功
PENDING：用户发起支付，等待结果
SUCCESS：支付成功，以回调验签并结合二次查询兜底为准
FAILED：支付失败或取消
CLOSED：超时关闭或人工关闭
REFUNDED：退款完成，可按需细分部分退款

3. 回调处理最佳实践

回调必须验签，并校验订单号、金额、币种、商户号等关键字段一致性。
回调处理必须幂等，同一笔交易重复通知不得导致重复发货或重复记账。
商户处理完成后再返回确认响应；若处理失败，依靠重试机制与主动查询进行补偿。

四、商户接入流程

需求确认：明确业务类型、支付方式组合、是否需要代付、退款逻辑与对账要求。
资料与资质审核：提交商户基本信息、业务说明、收款主体与结算信息等。
获取对接参数：商户号、密钥、回调地址配置与环境说明。
联调测试：完成下单、回调、查询与退款或代付等全链路测试。
灰度上线：小流量验证成功率、回调到达率、对账一致性与异常处理能力。
正式运行与优化：依据交易数据与风控命中情况持续优化策略。

五、适用场景

跨境电商与本地电商：提升本地钱包支付占比，降低收款跳失率。
数字内容与订阅：支持高频小额支付，保障回调稳定与对账清晰。
线下门店与连锁：统一管理多门店收款与结算数据。
平台型业务与聚合收款：支持多子商户管理与清分对账能力。

六、费率说明

不同支付方式与业务类型的费率与结算规则，以实际开通配置为准。币付已支持 GCash 与 QRPH 等方式的费率展示如下：

[rate-table type="all"]

七、常见问题

问：回调收不到怎么办

建议同时启用回调与主动查询双通道。确保回调地址稳定可访问，并做好验签与幂等处理；出现网络抖动时可通过查询接口兜底补偿。

问：如何保证对账一致

以平台交易流水与结算明细为基准，结合商户订单号进行日常核对。出现差异时，可通过交易号追踪到渠道流水定位原因并修正。

问：是否可以开通代付

可按业务类型与审核要求评估开通，并结合限额与风控策略保障资金安全。具体以实际审核与配置为准。

八、对接咨询与技术支持

如需获取接入资料、对接文档与联调支持，请联系币付客服：

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