币付（Bifu）菲律宾支付平台解决方案：代收代付能力与原生 GCash 接入架构

币付（Bifu）面向在菲律宾开展业务的商户与技术团队，提供代收与代付的一体化支付能力，并支持以原生方式对接 GCash、QRPH 等本地渠道，覆盖电商收款、线下扫码、平台分账、供应商结算、用户提现等高频场景。

本文从业务形态、资金流与技术集成角度出发，给出可落地的接入设计思路与关键工程要点。具体开通能力、参数字段与校验规则以币付对接文档与商户权限为准。

1. 适用对象与典型场景

1.1 适用对象

• 跨境电商、菲律宾本地电商：自建站、平台招商

• 线上娱乐、数字内容订阅、会员付费类业务

• 线下门店与连锁商户：收银台、二维码收款

• 平台型业务：撮合交易、佣金结算、分账

• 需要批量付款的企业：供应商、骑手、代理、员工等

1.2 典型支付动作

• 代收：用户使用 GCash、QRPH 等方式完成付款，商户获取支付结果与可对账数据

• 代付：商户向个人或合作方发起打款，例如退款、佣金、提现、结算

• 交易查询与对账：按订单号或支付单号查询状态，按账期或周期进行对账核验

2. 为什么要强调“原生接入”

所谓原生接入，核心目标是让支付链路更贴近渠道的真实能力边界：支付方式展示、跳转或唤起逻辑、支付结果回传与风险校验尽可能标准化，从而降低二次改造成本并提高交易一致性。

对商户而言，原生接入通常关注三点：

• 一致的支付体验：支付方式呈现与确认流程清晰，减少用户中途流失

• 可追踪的支付状态：支付成功、失败、处理中有明确状态与回调机制

• 可对账可审计：单号体系稳定，对账字段完整，便于财务闭环

3. 资金流与订单体系：先把“账”设计清楚

3.1 建议的单号体系

• merchant_order_no：商户侧订单号，业务订单，强幂等

• payment_no：支付单号，由币付生成，用于支付链路跟踪

• payout_no：代付单号，由币付生成，用于出款链路跟踪

• channel_trade_no：渠道侧流水号，优先用于审计与对账

必须强制幂等：同一个 merchant_order_no 不应产生多笔成功交易；针对重复回调、重复下单、网络重试必须可控。

3.2 建议的状态机

• INIT：已创建但未发起渠道动作

• PENDING：渠道处理中，等待用户支付或等待渠道确认

• SUCCESS：支付成功或代付成功

• FAILED：失败，需有可读失败原因，便于前端提示与运营处理

• CLOSED：超时关闭或商户主动关闭

状态的最终一致性通常依赖两条路径：异步回调与主动查询。任何单一路径都不应成为唯一真相来源。

4. 技术接入架构：推荐的工程落地方式

4.1 代收链路

1. 商户服务端创建支付单：传入订单号、金额、币种、用户信息、回调地址等

2. 币付返回支付参数：可能包含跳转链接、二维码数据、支付令牌等

3. 前端完成支付动作：H5、APP、收银台按返回参数跳转或展示二维码

4. 服务端接收回调：验签、校验金额与订单号、更新订单状态

5. 对账与补单：定时任务拉取账单或查询单笔状态，修正异常状态

4.2 代付链路

1. 商户服务端发起代付：收款方信息、金额、用途标识、商户代付单号等

2. 币付返回受理结果：受理成功进入处理中，或因参数、风控、余额等原因直接失败

3. 回调通知最终结果：同样需要验签与幂等处理

4. 失败重试策略：仅对可重试错误进行有限次重试，避免重复出款风险

4.3 回调设计要点

• 验签：基于密钥机制，拒绝未签名或签名不匹配请求

• 重放防护：加入时间戳与随机串，配合过期窗口

• 幂等处理：同一笔回调重复到达只更新一次，不重复记账、不重复发货、不重复出款

• 明确ACK：回调处理成功后返回明确响应，降低重复通知概率

5. 安全与风控：商户侧必须做到的底线

5.1 请求安全

• 全链路使用 HTTPS

• 生产与测试隔离，密钥最小权限、定期轮换

• 敏感字段按业务最小化留存并脱敏存储

5.2 交易风控实践

• 同设备或同账户短时间高频下单的限流与拦截

• 金额异常、地址异常、代理异常的二次校验

• 代付场景严格白名单：收款方绑定，变更需冷静期或二次验证

支付平台的风控是重要防线，但商户侧风控是第一道门，能显著降低纠纷与损失。

6. 对账与财务闭环：不要把问题留到月底

建议从接入第一天就把对账做成系统能力，而不是依赖人工导表：

• 日常对账：按支付单号或商户订单号核对成功金额与手续费

• 差错处理：针对已扣款未回调、回调成功但业务未入账等情况建立补单任务

• 退款与冲正：将退款视为独立交易流转，保留可追踪的退款单号与原因字段

• 审计留痕：保留关键请求与回调摘要信息，不保存密钥与敏感原文

7. 接入落地清单：技术团队可直接照此推进

• 准备：商户号、接口密钥、回调域名、服务器出口 IP

• 完成：支付下单、支付查询、回调验签、订单状态机

• 完成：代付下单、代付查询、代付回调验签、出款幂等

• 补齐：对账任务、失败重试策略、异常报警

• 上线前：灰度与压测，重点模拟回调重复、网络超时、前端取消、订单超时关闭

8. 费率表

以下为币付已配置的费率展示模块，包含 GCash 与 QRPH：

[rate-table type="all"]

9. 结语

菲律宾本地支付的挑战往往不在能不能付，而在能不能长期稳定对账、可追踪、可审计。币付（Bifu）的代收代付与原生 GCash 接入方案，适合希望建立标准支付底座的商户：前端体验清晰、后端状态可控、财务闭环可落地。

联系币付（Bifu）

• Telegram：@Bifuapp

• 邮箱：[email protected]