交易接口规范

交易报文规范

交易报文遵循JSON规范。

请求报文

示例:

{
    "body":{
    …
    },
    "head":{
        "merchantId":"451015200007",
        "tranCode":"TR4003",
        "tranDate":"20240930",
        "tranFlowid":"451015200007799290507578646821",
        "tranTime":"101752",
        "tranType":"01",
        "version":"1.0.2"
    }
}

• 请求报文由两部分组成：请求报文头（信息在head节点内）和请求报文体（信息在body节点内）。
• 报文头是每个交易都相同的。请求报文头信息的填写标准请参看“交易公共报文”章节。
• 根据每个交易接口定义的不同，请求报文体的定义请参看“业务交易接口”章节。需按照每个交易接口的定义组装请求报文。
• 客户端请求报文上送时，HTTP POST提交五个参数：

merchant_id=商户号;
msg_enc=报文密文（16进制表示）;
key_enc=会话密钥密文（16进制表示）;
sign=报文签名（16进制表示）;
mer_order_id=商户订单号（可与请求报文头的tranflowid一致）;

服务器端收到请求后按照HTTP的方式获取参数后，按如下步骤处理：
步骤1：使用解密会话密钥
步骤2：对密文报文解密，得到报文明文；
步骤3：验证签名，签名通过后在解析报文内容。
报文加密、签名方式请参看“加密及签名规范”章节

响应报文

示例:

{
    "body":{
    …
    },
    "head":{
        "merchantId":"451015200007",
        "respCode":"S0000000",
        "respDesc":"认证成功",
        "tranCode":"TR4003",
        "tranDate":"20240930",
        "tranFlowid":"451015200007799290507578646821",
        "tranTime":"101752",
        "tranType":"02",
        "version":"1.0.2"
    }
}

• 交易应答报文由两部分组成：应答报文头（信息在head节点内）和应答报文体（信息在body节点内）。
• 报文头是每个交易都相同的。应答报文头信息的填写标准请参看“交易公共报文”章节。
• 根据每个交易接口定义的不同，应答报文体的定义请参看“业务交易接口”章节。需按照每个交易接口的定义解析应答报文。
• 响应报文Http返回的字符串格式，请参看“交易公共报文/http参数格式”章节
• 服务器端响应报文返回时，处理步骤：
  • 将商户号、报文密文、会话密钥和签名解析出来，分隔符“&”，
  • 解密会话密钥
  • 对密文报文解密，得到报文明文
  • 验证签名，签名通过后在解析报文内容
  • 报文解密、验签方式请参看“加密及签名规范”章节。

接口响应码说明

响应报文头的respCode为S0000000，表示认证成功