API 参考

接入前必读

请先在 Sandbox 环境联调，上线前切换 Production 网关与凭证。请参阅 接入指南 与 签名指南。响应 code 说明见 错误代码。

环境配置

环境	协议	媒体类型	Base URL
Sandbox	HTTPS	application/json	https://sandbox-gateway.smilepayz.com
Production	HTTPS	application/json	https://gateway.smilepayz.com

各地区 API 共用上述网关地址。请从下方选择目标市场，查看接口、请求字段与支付方式。

---

亚洲

印度INR — UPI、银行转账，支持收款与付款。收款 · 查询 · 支付方式印度尼西亚IDR — QRIS、虚拟账户等本地通道。收款 · 查询 · 支付方式菲律宾PHP — 本地收款、代付与查询 API。收款 · 查询 · 支付方式泰国THB — QRPAY、银行转账、回单上传。收款 · 查询 · 支付方式越南VND — 本地收款、代付与余额查询。收款 · 查询 · 支付方式

北美洲

墨西哥MXN — SPEI 与银行转账 API。收款 · 查询 · 支付方式

南美洲

巴西BRL — PIX 与银行转账，支持收付。收款 · 查询 · 支付方式智利CLP — 收款、代付、退款与查询。收款 · 查询 · 支付方式哥伦比亚COP — 收款、代付、退款与查询。收款 · 查询 · 支付方式秘鲁PEN — 收款、代付、退款与查询。收款 · 查询 · 支付方式

非洲

埃及EGP — 收款、代付、退款与查询。收款 · 查询 · 支付方式

数字货币

USDTTRC20 稳定币收款 — 余额与状态查询。收款 · 查询 · 支付方式

---

通用 API 分类

各地区文档在适用时均包含以下模块：

分类	典型接口
交易	收款（v2.0/transaction/pay-in）、代付（v2.0/disbursement/pay-out）
查询	订单状态（v2.0/inquiry-status）、余额查询
支付方式	该地区支持的支付通道与编码

如何选择地区？

根据商户结算币种与支付方式选择对应市场文档。签名、回调、订单号等通用规则请参阅 产品介绍 与 用户指南。