统一约定

当前版本

当前版本是 1.0.0

数据响应格式

对于所有 API 的错误消息返回都是。且http状态是500

{
  "code": 506800,
  "message": "商户信息错误"
}

对于正常响应的数据。一般的如果是单条数据。格式如下

{
  data:{....}
}

如果是多条数据。为了一眼区分，对应key是"list"。一般格式如下

{
  list:[
    {...}, 
  ]
}

默认message 返回的是英文信息。如果希望得到中文信息需要设置 header

"Accept-Language": "zh-CN"

如果想信息返回时英文。请设置 header(或不设置)

"Accept-Language": "en-US"

正常情况http状态是200.

• 本系统采用md5校验签名(签名细节见文档最后)。
• 数据响应/请求类型都是 application/json。
• 所有API请求方式都使用POST
• 字段名都是小写、下划线连接
• 货币单位都使用大写。
• 国家代码使用IOS2，2位小写(为了区分货币)
• 时间格式都使用 yyyy-MM-dd HH:mm:ss (默认 时区 UTC+8)
• 金额单位保留两位小数。特别注意".00"会被省略。签名时候特被注意
• 由于系统有冷热数据区分，因此我放不会“严格限制商户单号在我方系统的唯一性”。对于重复单号，从严谨性上来说。也需要再个各自系统保证唯一

货币种类

错误代码