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