Smilepayz API 文档

多地区收付 API — 沙盒/生产环境、请求签名与回调通知。

开始集成 API 参考签名指南官网

安全签名

每笔 API 请求均采用 RSA 签名，回调支持验签。

多地区

覆盖亚洲、美洲、非洲等地区法币通道，以及 USDT 稳定币收款。

Multi-Env

在沙盒环境完成联调后，再切换网关地址与生产凭据。

实时回调

HTTPS 回调通知收款、付款及订单状态变更。

快速导航

快速开始登录商户后台，了解 Dashboard 与常用功能。账号 · 控制台 · 2FA 集成流程沙盒凭据、回调配置、RSA 密钥与首次 API 调用。沙盒 → 生产产品参考签名规则、数据模型、错误码与 API 概览。签名 · 模型 · 错误码常见问题接入疑问、排错思路与最佳实践。搜索 · 解答

三步完成接入

获取沙盒凭据

登录商户后台open in new window，切换到 Sandbox 标签页，复制 Merchant ID、Merchant Secret 与 Platform Public Key。详见集成指南第一步。

对请求进行签名

每笔收款、付款与查询请求均需携带 X-TIMESTAMP、X-SIGNATURE、X-PARTNER-ID 请求头。按签名指南压缩 JSON 请求体，并使用 RSA 私钥签名。

发起首笔 API 调用

将请求指向 https://sandbox-gateway.smilepayz.com，按所在地区创建收款订单，例如印度 Pay-in。响应 code 为 00 表示下单成功。

按地区浏览 API

以下为常用入口。完整列表（14 个地区 + USDT）请通过顶部导航 API 参考 查看。

印度INR — UPI、银行转账，支持收款与付款。收款 · 查询 · 支付方式印度尼西亚IDR — QRIS、虚拟账户等本地通道。收款 · 查询 · 支付方式泰国THB — QRPAY、银行转账及结算文档。收款 · 查询 · 支付方式巴西BRL — PIX 与银行转账，支持收付。收款 · 查询 · 支付方式墨西哥MXN — SPEI 与银行转账 API。收款 · 查询 · 支付方式 USDTTRC20 稳定币收款 — 余额与状态查询。收款 · 查询 · 支付方式

支持与资源

加入商户社群，获取接入技巧与公告。

Telegram Bot 指南 →

商户账号

暂不支持自助注册，请联系 商务拓展（BD） 获取接入凭据。

快速开始 →

沙盒网关

联调环境基础 URL（HTTPS，JSON，API v2.0）：

https://sandbox-gateway.smilepayz.com