币付 Bifu 原生接入方案：GCash 收款与代收代付的合规架构、对接流程与风控要点

本文面向需要在菲律宾落地本地收款与代收代付的商户与技术团队，梳理通过币付 Bifu 接入 GCash 的典型交易链路、系统对接要点、回调幂等与对账结算流程，并结合风控与合规落地给出上线清单，帮助项目在可控风险下快速上线与稳定运营。若你正在对比支付FM等方案，也可以用本文的架构与清单直接做评估与落地。

适用对象

电商、数字内容、游戏、订阅、线下门店、平台型业务与多商户场景
需要形成收款 + 代付、分账、提现等资金闭环的产品与工程团队

一、业务边界与目标定义

启动对接前，先把目标拆清楚：你需要的是单纯收款，还是收款 + 退款，还是收款 + 代付 + 资金归集与分发。币付 Bifu 的价值通常体现在两点：

本地支付覆盖：一套接入方式覆盖 GCash、QRPH 以及 Maya、GrabPay、Coins.ph 等本地主流能力，降低多方对接与维护成本。
资金流闭环：在合规框架下同时具备代收与代付能力，让业务具备完整的资金进出通道与可审计链路。

建议按可上线的最小闭环推进第一阶段：GCash 收款 + 订单状态回传 + 基础对账。第二阶段再引入代付、分账、退款、风控策略与自动化对账。

二、交易链路与参与方

典型链路包含四类参与方：商户系统、币付 Bifu、GCash 以及清算结算环节。设计时需要把责任边界写清，避免上线后口径不一致：

订单号体系：商户系统生成商户订单号，支付侧生成支付交易号。两者必须可双向关联，全链路可追溯。
支付展示承载：收银台可由商户承载或由支付侧托管，但用户识别信息与金额必须一致，且可审计。
结果判定原则：交易结果以异步通知为准。前端跳转返回与轮询只做体验优化，不作为最终凭证。

三、GCash 收款：原生支付的标准流程

GCash 收款建议统一按订单状态机落地，避免依赖前端跳转判断成败导致错账：

创建订单：商户系统发起创建支付订单请求，写入金额、币种、业务字段与回跳地址等信息。
拉起支付：按场景选择 H5 收银台、App 内支付、二维码扫码等方式发起支付。
用户完成支付：用户在 GCash 侧完成授权与支付。
异步通知确认：币付 Bifu 向商户系统发送支付结果通知，包含成功、失败、关闭、超时、待确认等状态。
商户确认入账：商户系统验签、幂等处理、更新订单状态并返回确认响应。

关键原则：你系统里的已支付只能由异步通知或主动查询确认产生，不建议仅凭用户跳转回来就发货或开通服务。

四、代收代付：把代付当成高风险能力设计

代付本质是资金出账，风险显著高于收款。落地时至少要做到：

强审核与强鉴权：代付请求必须来自可信服务端，不允许客户端直连触发。
额度与频控：对单笔、单日、账户、设备、IP 等维度设置限额与频率控制。
分层风控：新用户与高风险行为走人工复核或延迟出账，成熟账户逐步放开自动化。
资金来源可解释：每笔代付都要能追溯到对应收入、余额与业务凭证，满足审计与纠纷举证。

平台型业务还需要补齐：商户入驻与资质管理、交易归属与分配规则、争议处理机制与证据留存。

五、技术对接要点：验签、幂等、重试与回调安全

支付系统的工程质量体现在极端情况下不出错账，以下要点必须落实：

签名与验签：所有请求与回调都需要签名机制，回调侧验签通过才允许入账。
幂等性：创建订单、支付通知、代付结果可能重复发送。商户侧用订单号与交易号配合状态机做幂等处理，重复通知不得重复发货或重复记账。
超时与重试：回调响应要快速返回，业务处理建议异步化，重试采用退避策略，日志与链路 ID 可追踪。
回调安全：按协议支持情况设置 IP 白名单，做请求频控，增加时间戳与随机串防重放，并对金额、币种、商户号等关键字段做强校验。
主动查询兜底：回调延迟或丢失时，商户系统应支持按订单号查询交易状态，避免长期未知。

六、对账与结算：用可核对替代凭感觉

上线后最常见的问题是对账口径不统一。建议在设计期明确字段口径与流程：

字段映射统一：商户订单号、支付交易号、通道流水号、用户标识与脱敏策略、金额币种、手续费口径。
对账周期：以协议约定为准，系统层面支持按账期与批次归档、查询与导出。
差错处理 SOP：定义差错类型与处理流程，例如重复通知、状态不一致、金额不一致、退款失败等，做到可追溯可复盘。

七、合规与风控：越早做越省成本

菲律宾本地支付通常会涉及身份核验、反洗钱与数据合规要求。建议从第一天就把合规当成产品能力：

KYC 与 AML 框架：对涉及余额、提现、资金进出的业务建立身份采集、风险分层与异常监测策略。
数据最小化：只采集完成支付所需数据，敏感字段加密存储，权限最小化，全链路审计留痕。
安全基线：接口鉴权、密钥轮换、风控配置权限隔离、生产变更审计、异常告警与应急预案。

八、上线清单：以稳定性作为验收标准

联调验证：覆盖成功、失败、取消、超时、重复回调、回调延迟、网络抖动等场景。
核心监控：成功率、回调延迟分布、未知状态占比、代付失败率、退款失败率、错误码分布。
告警机制：成功率异常、回调堆积、订单长期未决、代付突增、同账号高频失败等。
运营工具：按订单、用户、商户快速查询，补单，重发通知，导出对账数据并做权限控制。

九、币付 Bifu 实时费率表

[rate-table type="all"]

十、币付 Bifu 服务支持

如果你希望更快落地 GCash 原生收款与代收代付能力，减少试错成本，币付 Bifu 可提供从方案设计到上线运维的一体化协助，包括接入评估、对接规范梳理、回调与对账设计建议、风控策略落地、上线前压测与稳定性检查等。

联系方式

Telegram：@Bifuapp
邮箱：[email protected]