菲律宾支付 API 怎么对接?开发者接入指南 2026
一、对接前你需要什么
对接菲律宾本地支付 API,先拿到三样:商户号(merchant id)、密钥(API key/secret)、接口文档。通过 持牌网关 申请商户资料审核通过后即可获得。
二、标准对接流程
- 创建订单(下单接口):把订单号、金额、通道(GCash/QRPH/Maya)、回调地址传给网关,拿到支付链接或二维码。
- 用户支付:跳转/唤起钱包完成付款。
- 接收回调(异步通知):网关把支付结果 POST 到你的回调地址。务必验签 + 校验金额,再更新订单、发货。
- 主动查询(兜底):没收到回调的订单,用订单查询接口按商户订单号主动核对,避免漏单。
- 代付接口(如需):出款则调代付接口,把钱打到收款方钱包/银行。
三、必做的几个工程细节
- 验签:回调一定验签,防伪造。
- 幂等:回调可能重复,用订单号做幂等,防重复发货。
- 对账:每日用明细接口 自动对账,金额三方核对。
- 沙盒先行:先在沙盒环境联调通了再上生产。
四、提升线上表现
用 原生通道 + 多通道冗余,有助于提升支付成功率、降低掉单。
五、常见问题
对接要多久?
资料齐、文档清晰,快的话数日可上线。
没收到回调怎么办?
用订单查询接口主动核对,别只依赖回调。
六、获取文档与沙盒
需要 API 文档和沙盒,联系 SMARTPAY:📩 [email protected] | Telegram @LouisSMARTPAY