支付接口公共报文
支付接口公共报文头
1、公共报文
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
业务报文 |
context |
是 |
String |
|
订单签名加密后的内容 |
业务报文头businessHead说明
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
字符集 |
charset |
是 |
String(2) |
00 |
00表示UTF-8，暂时只支持UTF-8 |
|
版本号 |
version |
是 |
String(10) |
V1.0.0 |
默认为V1.0.0，采用向下兼容原则 |
|
商户号 |
merchantNumber |
是 |
String(32) |
API0100001102000001 |
接入商户在速汇宝注册与使用的编号 |
|
请求接口名称 |
method |
是 |
String(20) |
unifiedPayment |
详见各接口定义的请求接口名称 |
|
请求时间 |
requestTime |
是 |
String(14) |
20170808161616 |
请求时间：yyyyMMddHHmmss |
|
签名类型 |
signType |
是 |
String(10) |
RSA |
暂时只支持RSA，必须大写的RSA |
|
签名信息 |
sign |
是 |
String |
NclW+YPk6IiTdCihhTP... |
使用商户证书对报文签名后值 |
请求报文头示例：
{
"businessHead": {
"charset": "00",
"version": "V1.0.0",
"method": "payment",
"merchantNumber": "API0100002802000031",
"requestTime": "20180116143106",
"signType": "",
"sign": ""
}
}
2、公共响应报文
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
业务报文 |
context |
是 |
String |
|
订单签名加密后的内容 |
|
请求结果 |
success |
是 |
boolean |
true |
true：成功, false:失败 |
|
响应结果信息 |
message |
是 |
String |
请求成功 |
|
业务报文businessHead说明
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
字符集 |
charset |
是 |
String(2) |
00 |
00表示UTF-8，暂时只支持UTF-8 |
|
版本号 |
version |
是 |
String(10) |
V1.0.0 |
默认为V1.0.0，采用向下兼容原则 |
|
商户号 |
merchantNumber |
是 |
String(32) |
API0100001102000001 |
接入商户在速汇宝注册与使用的编号 |
|
请求接口名称 |
method |
是 |
String(20) |
unifiedPayment |
详见各接口定义的请求接口名称 |
|
返回时间 |
responseTime |
是 |
String(14) |
20170808161616 |
返回时间：yyyyMMddHHmmss |
|
签名类型 |
signType |
是 |
String(10) |
RSA |
暂时只支持RSA，必须大写的RSA |
|
签名信息 |
sign |
是 |
String |
NclW+YPk6IiTdCihhTP... |
使用商户证书对报文签名后值 |
公共响应报文message说明
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
响应码 |
code |
是 |
int |
200 |
请求成功 |
|
响应信息 |
content |
是 |
String |
请求成功 |
请求成功 |
返回报文头示例：
{
"message" : {
"code" : 200,
"content" : "成功"
},
"context" : "",
"success" : true
}
{
"message" : {
"code" : 3003,
"content" : "签名异常"
},
"context" : null,
"success" : false
}
