环境说明
下文路径均相对于 API 根地址 {API_BASE} 拼接。
生产环境
| 用途 | Base URL（示例，以运维下发为准） |
|---|---|
| 商户 API | https://api.soranopro.com |
示例：POST https://api.soranopro.com/api/v1/merchant/payin/create
沙盒（测试）
| 用途 | Base URL（示例，以运维下发为准） |
|---|---|
| 商户 API | https://sandbox-api.soranopro.com |
本地联调网关示例：http://localhost:8080（开发环境 Go API 默认端口）。
沙盒与生产 商户号、密钥、钱包资金 相互独立。
TLS 与网络
- 生产环境仅允许 HTTPS，建议 TLS 1.2+
- 若开启 IP 白名单（
enableIpWhitelist），请将调用方公网 IP 提交运营配置 - 异步回调：请将 SoPay 回调出口 IP 加入您防火墙白名单（向运营索取）
请求头（商户 API）
| Header | 必填 | 说明 |
|---|---|---|
Content-Type | POST 必填 | application/json |
X-Merchant-No | 是 | 商户号 |
X-Timestamp | 是 | Unix 秒级时间戳 |
X-Nonce | 是 | 唯一随机串 |
X-Sign | 是 | RSA2 Base64 签名 |
完整签名规则见 签名与商户 API 规范。
中国开户参数
创建订单时固定：
json
{
"countryCode": "CN",
"currency": "CNY"
}须与商户开户国家配置一致。