币付接入方案：GCash原生收款与代收代付一体化支付接入指南

面向在菲律宾开展业务的商户与平台型企业，币付（Bifu）提供以 GCash 原生支付为核心的收款能力，并支持代收代付相关流程，覆盖资金归集、资金分发与批量付款等需求，帮助业务在支付接入、交易通知、对账与风控等环节实现标准化与可运营化落地。

本文聚焦“怎么接、接什么、接入后如何稳定运营”，内容按真实对接流程展开，便于技术、产品、运营与财务团队协作推进。

适用对象与典型场景

电商与内容订阅：商品或服务购买、会员订阅、数字内容付费等。
平台型业务：多商户入驻、订单拆分、统一收款与商户结算。
线下与 O2O：门店收银、配送到家、预约服务等。
企业资金流：对外付款、供应商结算、员工报销发放等代付需求。

如果业务属于高合规敏感行业，建议在接入前先完成业务模式与风控策略评估，确保账户侧与交易侧策略一致，避免上线后被动整改。

能力范围：GCash 原生收款 + 代收代付 + QRPH 扩展

1）GCash 原生支付（收款）

币付可提供基于 GCash 的原生收款链路，常见形态包括收银台支付、扫码支付、App 内支付引导等。对商户而言，关键目标是提升支付完成率、降低对接成本、让支付状态可追踪可核对。

2）代收代付（资金归集与资金发放）

在平台型业务或企业资金流场景中，单纯“能收款”不够。币付可将代收代付能力纳入统一资金链路，支持：

代收：多渠道入账后统一归集，按规则沉淀可结算余额。
代付：向个人或企业进行付款发放，支持批量任务、状态跟踪与回执管理。
资金数据闭环：交易流水、余额变动、结算记录、对账文件等，满足运营与财务落账需要。

3）二维码与本地化收款补充

在需要更广覆盖与更顺滑支付体验的场景下，可扩展支持 QRPH 等本地化能力，用于提升支付选择与成功率，减少用户流失。

费率说明

[rate-table type="all"]

收款接入流程（建议按闭环落地）

订单创建：商户系统生成唯一订单号，固化金额、币种、业务类型、商品或服务信息等关键字段；同时记录订单状态机，例如待支付、支付中、已支付、失败、关闭等。
发起支付：向币付发起支付请求，获取支付引导信息，例如收银台链接、支付指令、二维码内容等，并展示给用户完成支付。
支付完成与通知：用户完成支付后，币付通过异步通知推送结果。商户系统需校验通知合法性并更新订单状态。
主动查询兜底：回调未达、网络抖动或状态不一致时，商户系统应支持按订单号主动查询支付状态，作为最终一致性的保障机制。
对账与结算：按约定的对账维度拉取交易清单，核对订单金额、手续费、退款与冲正、结算入账情况，形成财务可落账的数据链路。

代收代付接入流程

1）代收：入账与归集

入账识别：将入账与业务订单、商户、用户进行关联，避免“钱到了但不知道对应谁”。
余额体系：明确可用余额、冻结余额、待结算余额等口径，确保运营与风控有抓手。
结算规则：按业务约定配置结算逻辑，例如按商户、按门店、按项目、按周期，并保留可审计记录。

2）代付：付款发放与回执闭环

付款单创建：付款对象、金额、用途、业务单号、备注等信息结构化入库。
审核与风控：高风险付款建议引入人工或自动审核策略，包括限额、频次、黑名单、异常行为规则等。
发起代付：提交代付请求并获取受理结果；付款状态需可查询、可追踪、可重试。
回执管理：对成功与失败回执进行标准化存档，便于财务核对与售后处理。

技术对接要点（决定稳定性的关键）

签名与验签：所有关键请求与回调必须具备可校验的签名机制；不要只靠来源 IP 判断安全。
幂等处理：支付回调与代付回执可能重复推送，订单更新必须可幂等，避免重复入账或重复发货。
状态机设计：订单状态必须可回溯、可审计，避免“写死结果”导致后续对账与追责困难。
回调容错：回调接口需重试友好，快速响应、可追踪日志、失败告警，并配合主动查询兜底。
金额精度：金额字段统一使用整数最小货币单位或严格的小数精度策略，避免浮点误差造成对账差异。
日志与追踪：为每笔交易建立 traceId 或请求号，串联创建订单、发起支付、回调、查询、对账的全链路。

合规与风控建议

客户身份与业务真实性：明确商户主体信息、经营范围与交易用途，保持资料一致性。
交易监控：建立异常交易识别策略，例如频次异常、金额异常、设备与账号异常、退款异常等。
风控处置：对可疑交易设置冻结、延迟结算、人工复核等处置机制，降低资金与合规风险。
隐私与安全：敏感信息最小化存储、加密传输、分级授权访问，防止数据泄露与越权操作。

交付与验收清单

对接资料：商户信息、业务说明、回调地址、服务器出网 IP、技术联系人等。
技术文档：API 说明、签名规则、回调字段说明、错误码与重试策略。
测试与验收：覆盖支付成功、失败、超时、回调重复、订单关闭、退款与冲正、对账一致性等用例。
上线保障：监控告警，例如回调失败率、支付成功率、接口超时率；灰度策略；应急预案与回滚路径。

结语：支付不仅要“点通”，更要“可运营、可对账、可风控”

支付接入的难点不在于把按钮点通，而在于上线后的稳定性、对账闭环与风险控制。币付以 GCash 原生收款为核心，配合代收代付能力与运营级数据链路，目标是让商户从接入到长期运营都具备可控的交易体系。

联系币付

Telegram：@Bifuapp
邮箱：[email protected]

如需对接评估与技术联调支持，请提交业务场景、收款形态、是否需要代付、预计交易规模与系统对接方式（如 App、网站、线下），以便快速给出匹配的接入路径与验收清单。