接入指引
中文文档
请求 HOST
https://api.simplypay.vip我方出口 IP
15.207.74.156请求结构
通信协议
仅支持 TLS 1.2 or TLS 1.1，SSLv3 and TLS 1.0 不被支持
商户系统与 SimplyPay 系统通信，使用签名验证来确保通信信息完整及通信安全，见 (签名机制)。
字符编码
参数格式
Content-Type: application/json;charset=utf-8
返回参数
| 字段 | 名称 | 说明 |
|---|---|---|
| code | 状态码 | http 状态码，此字段值只表明接口请求情况，不能说明业务参数无异常 |
| msg | 状态描述 | 接口调用结果描述 |
| error | 错误信息 | 异常信息 |
| data | 业务返回值 | 描述业务调用情况的返回值，具体请参照业务接口中每个接口的 data 值 |
通知机制
同步回调
同步回调采用 get 方式跳转，相应的拼接参数，会对每个参数的值进行编码为 UTF-8 的 URLencode 处理，随后进行跳转。
异步回调
商户服务器接到请求后必须 http 响应 200，并且打印输出 success 或者 ok。如果商户反馈给 SimplyPay 的字符不是 success 这 7 个字符或者 ok 这 2 个字符，SimplyPay 服务器会不断重发通知，直到超过 24 小时 47 分钟。一般情 况下，25 小时以内完成 9 次重发通知（通知 的间隔频率一般是：30s,2m,4m,10m,30m,1h,2h,6h,15h）。
某些情况下，商户的一笔订单可能会收到 SimplyPay 的多次通知，商户需对自己的逻辑进行检查，对于可能收到重复的成功或失败状态的订单通知能够进行唯一的业务处理。
签名机制
在拼接字符串时，会过滤掉 key 或 value 为空的字符串的参数，此类参数不参与签名前的字符串拼接。
在请求参数与返回参数的签名中，出现 extra 字段时，签名时需要将 extra 的值转换为 Map 集合，按照 key 的 Unicode 进行排序。然后将 Map 中参数以key1=value1&key2=value2&key3=value3的形式拼接为新的字符串作为 extra 的值。
若其它参数值为对象，会将其转换为 JSON 字符串后再参与加密。
注意：业务字段并非固定不变，所有业务字段均参与签名，建议动态处理，以应对可能的字段增减。
修改于 2025-04-25 10:31:50