集成流程
大约 3 分钟
集成概述
本综合集成指南提供了与Smilepayz支付平台集成的分步说明。集成过程设计简单且安全，支持多个地区和支付方式。
前提条件和账户设置
地区API文档
选择您的目标地区以访问特定的API文档：
| 地区 | 文档链接 | 货币 | 支付方式 |
|---|---|---|---|
| 巴西 | 巴西API文档 | BRL | PIX、银行转账 |
| 智利 | 智利API文档 | CLP | CASHIER_CL、银行转账 |
| 哥伦比亚 | 哥伦比亚API文档 | COP | CASHIER_CO、银行转账 |
| 印度 | 印度API文档 | INR | UPI、银行转账 |
| 印度尼西亚 | 印度尼西亚API文档 | IDR | QRIS、虚拟账户 |
| 墨西哥 | 墨西哥API文档 | MXN | SPEI、银行转账 |
| 秘鲁 | 秘鲁API文档 | PEN | CASHIER_PE、银行转账 |
| 菲律宾 | 菲律宾API文档 | PHP | GCASH、银行转账 |
| 泰国 | 泰国API文档 | THB | QRPAY、银行转账 |
账户获取
- 联系Smilepayz员工: 请联系我们的业务发展团队获取您的集成账户
- 账户验证: 完成商户验证流程
- 文档访问: 获得地区API文档和凭据的访问权限
沙盒环境集成
沙盒环境提供安全的测试环境，使用模拟数据进行开发和集成测试。
步骤1: 获取集成信息
访问商户后台
- 登录: 访问商户后台门户
- 环境切换: 切换到沙盒选项卡
- 凭据获取: 获取您的沙盒凭据
沙盒凭据
- 商户ID: 在沙盒环境中以
sandbox前缀开头 - 商户密钥: 用于签名生成（请勿修改）
- 平台公钥: 用于签名验证
重要说明
沙盒凭据仅用于测试目的，不能在生产环境中使用。
步骤2: 配置IP白名单和回调URL
IP白名单配置
- 自主配置: 在沙盒中独立配置IP白名单
- 参考指南: 查看沙盒IP配置
- 开发IP: 添加您的开发服务器IP地址
回调URL设置
- 后台配置: 在商户后台配置回调URL
- 请求参数: 或者，在API请求参数中包含
callbackUrl - HTTPS要求: 确保回调URL使用HTTPS协议
步骤3: 生成RSA密钥对
密钥生成过程
- 生成密钥: 点击生成RSA密钥按钮
- 密钥对创建: 系统生成RSA私钥和公钥
- 公钥保存: 确保公钥成功保存
- 验证: 刷新页面确认公钥已保存
密钥对验证
- 配对匹配: 验证保存的公钥与您的私钥对应
- 签名错误: 不匹配的密钥对将导致签名验证失败
- 密钥安全: 安全存储您的私钥，切勿分享
安全警告
确保保存的公钥与用于签名的私钥属于同一对。不匹配的密钥将导致签名错误。
步骤4: API集成实现
基础URL配置
- 沙盒基础URL:
https://sandbox-gateway.smilepayz.com - API版本: 使用v2.0 API接口
- 仅HTTPS: 所有API通信都使用HTTPS
SDK集成
我们提供多种编程语言的综合SDK：
| 语言 | 仓库 | 文档 |
|---|---|---|
| Java | Java演示 | 完整Java实现 |
| C# | C#演示 | .NET集成示例 |
| PHP | PHP SDK | PHP SDK和示例 |
| Python | Python演示 | Python集成指南 |
| Node.js | Node.js演示 | JavaScript/Node.js示例 |
| Golang | Golang演示 | Go语言集成 |