GCash作为菲律宾最主流的数字钱包之一,为开发者与商户提供了原生API接口能力,实现自动化收款、退款与订单状态同步。本文将详细拆解GCash原生支付API的接入流程、参数设置、返回结果、异常排查机制,帮助您快速部署并稳定运行GCash原生收款系统。
一、接入准备:API环境与测试配置
✅ 开通 GCash 商户账号(或接入币付的聚合通道)
✅ 获取测试凭证(client_id / client_secret)
✅ 设置 Notify 回调地址、Webhook接收路径
✅ 准备HTTPS服务环境,确保接口安全
如无GCash官方权限,可通过币付代申请商户账户并提供聚合通道调用权限。
二、GCash原生支付流程概览
用户在平台提交支付请求
商户生成订单并调用 GCASH 原生API
系统返回二维码或 deeplink 跳转地址
用户完成支付,GCash 异步推送通知
商户后台处理回调并更新状态
三、核心参数与API字段说明
参数 | 示例值 | 说明 |
---|---|---|
amount | 99.00 | PHP币种,最多两位小数 |
currency | PHP | 币种代码,固定为PHP |
callback_url | https://your.com/notify | 支付完成后异步通知地址 |
client_reference_id | ORDER_20250703001 | 商户自定义订单号 |
redirect_url | https://your.com/return | 用户支付完毕跳转地址 |
Payment_method | GCASH | 支付方式代码 |
四、二维码生成与跳转示例
POST /v1/payments HTTP/1.1 Host: api.gcash.com Authorization: Bearer YOUR_TOKEN Content-Type: application/json { "amount": { "currency": "PHP", "value": "199.00" }, "redirectUrl": "https://your.com/success", "callbackUrl": "https://your.com/notify", "referenceId": "ORD20250703001", "paymentMethod": "GCASH" }
返回结果中将包含 deeplink 地址(移动端直接跳转)和二维码图片链接。
五、异步回调结构
{ "referenceId": "ORD20250703001", "status": "SUCCESS", "transaction_id": "TXN87283923", "paid_amount": "199.00", "pay_time": "2025-07-03T13:22:45+08:00", "signature": "xxxxx" }
收到成功状态后,系统应立即更新订单并记录交易ID,防止重复支付。
六、常见异常与排查建议
异常 | 排查建议 |
---|---|
403 forbidden | 检查Token是否过期或IP白名单未配置 |
支付成功但未回调 | 检查Notify接口是否HTTPS+公网可访问 |
二维码扫码失败 | 检查是否走了 QRPH 聚合码,部分钱包不兼容 |
高峰期掉单 | 建议启用币付聚合通道进行通道兜底 |
七、币付平台GCash原生通道优势
☑ 原生跳转 + 原生二维码稳定接入
☑ 异常流量动态切换 QRPH 或 Maya 通道
☑ 免费技术协助部署接口
☑ 接入后支持代付与返佣一体化管理
商务接入 & 支持
客服邮箱: img1231@163.com
TG客服:
@Bifuapp
GCash原生支付不是高门槛技术壁垒,
选择币付,即可轻松一键接入,快速上线跑量。
发表评论
发表评论: