Appearance
交易接口规范
交易报文规范
交易报文遵循JSON规范。
请求报文
示例:
java
{
"body":{
…
},
"head":{
"merchantId":"451015200007",
"tranCode":"PA0001",
"tranDate":"20240930",
"tranFlowid":"451015200007799290507578646821",
"tranTime":"101752",
"tranType":"01",
"version":"1.0.0"
}
}
- 请求报文由两部分组成:请求报文头(信息在head节点内)和请求报文体(信息在body节点内)。
- 报文头是每个交易都相同的。请求报文头信息的填写标准请参看“交易公共报文”章节。
- 根据每个交易接口定义的不同,请求报文体的定义请参看“业务交易接口”章节。需按照每个交易接口的定义组装请求报文。
- 客户端请求报文上送时,HTTP POST提交五个参数:
java
merchant_id=商户号;
msg_enc=报文密文(16进制表示);
key_enc=会话密钥密文(16进制表示);
sign=报文签名(16进制表示);
mer_order_id=商户订单号(可与请求报文头的tranflowid一致);
服务器端收到请求后按照HTTP的方式获取参数后,按如下步骤处理:
步骤1:使用解密会话密钥
步骤2:对密文报文解密,得到报文明文;
步骤3:验证签名,签名通过后在解析报文内容。
报文加密、签名方式请参看“加密及签名规范”章节
响应报文
示例:
java
{
"body":{
…
},
"head":{
"merchantId":"451015200007",
"respCode":"S0000000",
"respDesc":"交易成功",
"tranCode":"PA0001",
"tranDate":"20240930",
"tranFlowid":"451015200007799290507578646821",
"tranTime":"101752",
"tranType":"02",
"version":"1.0.0"
}
}
- 交易应答报文由两部分组成:应答报文头(信息在head节点内)和应答报文体(信息在body节点内)。
- 报文头是每个交易都相同的。应答报文头信息的填写标准请参看“交易公共报文”章节。
- 根据每个交易接口定义的不同,应答报文体的定义请参看“业务交易接口”章节。需按照每个交易接口的定义解析应答报文。
- 响应报文Http返回的字符串格式,请参看“交易公共报文/http参数格式”章节
- 服务器端响应报文返回时,处理步骤:
- 将商户号、报文密文、会话密钥和签名解析出来,分隔符“&”,
- 解密会话密钥
- 对密文报文解密,得到报文明文
- 验证签名,签名通过后在解析报文内容
- 报文解密、验签方式请参看“加密及签名规范”章节。
接口响应码说明
对于注册接口和查询接口respCode的意义是不同的,注册接口中respCode代表注册是否成功,而查询中,只代表查询的结果被正常返回。最终结果可以根据tranState判断,具体含义可以查看 数据元
账户注册结果判断
- 个人
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 04 | 个人账户注册成功 |
其他 | 任意或节点不存在 | 个人账户注册失败 |
- 企业
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 01 | 企业账户申请成功 |
其他 | 任意或节点不存在 | 企业账户申请失败 |
账户变更结果判断
- 个人
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 02 | 个人账户变更成功 |
其他 | 任意或节点不存在 | 个人账户变更失败 |
- 企业
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 01 | 企业账户变更申请成功 |
其他 | 任意或节点不存在 | 企业账户变更申请失败 |
账户交易结果判断
- 充值短信
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 00 | 短信发送成功 |
其他 | 任意或节点不存在 | 充值失败 |
- 充值确认、转账、提现
head->respCode | body->tranState | 判断结果 |
---|---|---|
S0000000 | 01 | 交易成功 |
S0000000 | 02 | 交易处理中 |
E0000000 | 任意(有可能节点不存在) | 交易处理中 |
其他 | 非01、02(或不存在) | 交易失败 |