菲律宾 GCash 支付接口接入指南：商户收款、对账与结算一体化
GCash 作为菲律宾主流电子钱包之一，已成为本地电商、线上娱乐、跨境服务与线下门店的重要收款方式。通过标准化支付接口，商户可在不改变现有业务系统结构的前提下，快速实现 收款、退款、对账、结算 的闭环，提高支付成功率与资金周转效率。
一、适用商户与典型场景
电商与订阅：订单支付、会员订阅、自动续费（按业务规则配置）。
数字内容/线上娱乐：充值、道具购买、即时到账与订单状态回查。
本地生活与线下门店：扫码收款、收银台聚合、门店多终端收款。
跨境业务：面向菲律宾用户收款，统一在商户后台完成对账与结算管理。
二、接入模式与系统架构建议
根据商户技术能力与业务形态，常见接入模式如下：
API 直连模式：商户服务器对接下单、签名、回调验签、订单查询等接口；适合有研发团队、需深度自定义支付流程的商户。
收银台/托管支付页：由支付侧提供标准收银台，商户只需传入订单信息并处理回调；适合快速上线与多端统一体验。
二维码/扫码支付：生成动态码或固定码，结合门店/柜台业务；适合线下与 O2O 场景。
三、核心能力清单（面向生产环境）
订单创建与支付：支持多币种/多渠道扩展，订单状态可追踪。
异步回调通知：交易结果以回调为准，支持重试机制与幂等处理。
订单查询/补单：防止网络波动导致状态不一致，确保资金与订单一致。
退款能力：支持原路退款或按规则退款（以实际可用能力为准）。
对账与报表：日账单、流水明细、手续费明细、差错处理。
结算与出款：按结算策略汇总结算，提供结算单与资金流向记录。
四、标准交易流程（推荐实现）
商户侧创建订单：生成商户订单号（建议全局唯一），校验金额、币种与商品信息。
请求支付接口下单：传入订单号、金额、回调地址、用户标识（如适用）等关键参数。
引导用户完成支付：跳转收银台/唤起支付/展示二维码。
接收支付结果回调：验签 + 幂等处理 + 更新订单状态（回调为准）。
主动查询兜底：对未收到回调或状态不明确的订单进行轮询查询与补单。
对账与结算：按结算单核对交易明细，完成资金入账与财务归集。
五、接口对接要点（稳定性与风控）
签名机制：建议使用 HMAC 或 RSA 签名；所有回调必须验签，防止伪造通知。
幂等控制：以“商户订单号 + 业务动作”作为幂等键，避免重复扣款/重复记账。
回调重试：商户回调接口需返回明确成功响应；失败时允许重试并可配置重试策略。
超时与降级：下单、查询、退款接口要有超时与重试；建议引入消息队列处理高并发回调。
风险拦截：对异常频次、异常金额、异常设备/地区进行风控校验，保留可追溯日志。
审计与追踪：建议记录 request_id、订单号、回调流水号、签名串、状态变更链路。
六、费率与结算说明
费率通常与行业属性、交易规模、结算方式与风控等级相关。
[rate-table type="all"]
结算相关建议：
结算单优先：以结算单为财务入账依据，结合流水明细完成核对。
差错处理机制：建立“回调未达、重复通知、用户支付成功但订单失败”等异常处理流程。
退款与拒付：为售后与合规预留处理窗口，避免资金与订单口径不一致。
七、上线前检查清单（建议逐项验收）
回调域名可公网访问，HTTPS 证书有效，接口返回稳定。
验签通过率验证完成，回调幂等逻辑生效。
订单状态机完善：待支付/支付中/成功/失败/关闭/退款中/已退款。
对账文件与报表链路可用，差错可定位、可追溯、可修复。
日志与告警：回调失败、查询异常、退款异常、成功率波动具备告警能力。
八、商户常见问题
未收到回调怎么办？：以订单查询作为兜底，建议对超时订单设置自动查询与补单任务。
回调重复触发是否正常？：正常。商户必须做幂等，重复回调不应导致重复记账。
订单金额与实际入账不一致？：以手续费、退款、差错调整为主要核查方向，结合结算单与明细定位。
接入与技术支持
币付（Bifu）提供菲律宾本地支付通道能力，支持 GCash 等支付方式的商户接入、对账与结算管理。
Telegram：@Bifuapp
需要帮助？
联系我们的客服获取更多信息