SMARTPAY

GCash 收款 API 对接教程 | 菲律宾 GCash 代收代付完整接入指南 2026

一、为什么菲律宾商户都要对接 GCash 收款

GCash 是菲律宾用户量最大的电子钱包,月活跃用户已突破数千万,几乎是菲律宾本地线上交易的"默认收款方式"。对任何想在菲律宾做生意的电商、游戏、直播、跨境平台来说,能不能顺畅收 GCash,直接决定了成交率。但商户想自己直连 GCash 官方接口,门槛并不低——这正是 GCash 收款 API 对接的核心问题。

本文从商户视角,完整讲清 GCash API 对接 的两种路径、接入前准备、标准流程、回调对账,以及如何通过 SMARTPAY 的 GCash 原生通道 用一个接口快速上线。

二、GCash 对接的两种方式

1. 直连 GCash 官方

适合有菲律宾本地实体、能满足官方 KYC/合规、且技术团队充足的大商户。优点是费率谈判空间大;缺点是申请周期长、门槛高、对接维护成本大,单一通道被风控时收款会直接中断。

2. 通过聚合支付网关对接(推荐多数商户)

像 SMARTPAY 这样的持牌网关已完成与 GCash 等通道的底层对接,商户只需对接一套统一 API,即可同时获得 GCash、QRPH、Maya 等收款能力,上线快、多通道冗余、对账结算统一。

说明:SMARTPAY 是独立第三方支付网关(持有 BSP 颁发的 OPS/EMI 牌照),提供 GCash 等通道的对接与结算服务,并非 GCash 官方;GCash 为其商标持有方所有。

三、对接前准备

  • 商户资质:营业主体信息、结算账户、必要 KYC。
  • 商户号与密钥:merchant_id 与 API Key/Secret,用于签名。
  • 回调地址:一个可接收结果通知的 HTTPS 接口。
  • IP 白名单:服务器出口 IP 加白。

四、标准对接流程

  1. 创建支付订单:提交金额、商户订单号、回调地址,网关返回支付链接。
  2. 拉起 GCash 支付:展示链接/二维码,用户在 GCash 内确认(原生通道无跳转、体验最顺)。
  3. 接收异步回调:成功后网关推送结果,务必验签+校验金额再发货。
  4. 主动查询兜底:未收到回调的订单按商户订单号主动核对。
  5. 对账结算:按日对账,资金按约定周期(如 D0 当日)结算。

创建订单示例

POST /api/v1/gcash/order/create
{ "merchant_id":"商户号", "out_trade_no":"ORDER001", "amount":"500.00", "currency":"PHP", "notify_url":"https://yourshop.com/cb", "sign":"签名" }

五、费率与结算

评估方案别只看费率,要综合费率、结算周期(T+1 还是 D0)、成功率、稳定性、备用通道、对账工具。现金流敏感的业务,D0 当日结算往往比单纯低费率更重要。

六、常见问题

对接 GCash 需要本地公司吗?

直连官方通常需要;通过 SMARTPAY 这类持牌网关对接,门槛和流程会大幅简化,具体以商户审核为准。

多久能上线?

走聚合网关、资料齐全,通常数个工作日内完成联调上线。

支持代付出款吗?

支持。SMARTPAY 提供 GCash 代收与代付,可用于平台批量出款。

七、快速接入

想用一套 API 同时拿下 GCash、QRPH、Maya 收付能力,欢迎联系 SMARTPAY 获取对接文档与商户号。📩 [email protected] | Telegram @LouisSMARTPAY

相关推荐