2.2 接口规范
2.2.1 接口格式定义
2.2.1.1 公共请求报文格式
参数名称 | 含义 | 格式(Json) | 必填项 | 备注 |
---|---|---|---|---|
请求参数 | 请求头 | Y | 请求头必填 | |
reqHeader | 请求体 | Y | ||
reqBody | 请求体 | |||
reqSign | 签名 | Y | 参照3.签名验签 | |
signType | 签名方式 | N | RSA2,SM2,SM3 |
参数名称 | 含义 | 格式(Json) | 必填项 | 备注 |
---|---|---|---|---|
transTime | 请求时间 | N14 | Y | YYYYMMDDhhmmss |
transCode | 交易代码 | N6 | N | 业务交易码,应答原样返回 |
transSequence | 交易流水 | ANS6…40 | N | 请求流水号,应答原样返回 |
reqId | 请求Id | ANS32 | Y | 机构号 |
certificateId | 证书id | ANS6…40 | N | 证书Id,多证书情况下需要 |
easyPayCertificateId | 易生证书id | ANS6…40 | N | 易生证书Id,多证书情况下需要,为空时使用默认证书 |
2.2.1.2 公共应答报文格式
参数名称 | 含义 | 格式(Json) | 必填项 | 备注 |
---|---|---|---|---|
reqHeader | 请求体 | Y | 必填 | |
reqBody | 请求体 | C | 条件域 | |
reqSign | 签名 | C | 参照3.签名验签 | |
signType | 签名方式 | N | RSA2,SM2,SM3 | |
time | 返回时间 | N | yyyyMMdd HH:mm:ss | |
应答头格式 rspHeader | ||||
参数名称 | 含义 | 格式(Json) | 必填项 | 备注 |
--- | --- | --- | --- | --- |
rspCode | 应答码 | ANS5 | Y | 00000-成功,其他失败 |
rspInfo | 应答消息 | ANS128 | Y | 错误信息 |
transCode | 交易代码 | N6 | N | 同请求 |
transSequence | 交易流水 | ANS6…40 | N | 同请求 |
easyPayCertificateId | 易生证书id | ANS6…40 | N | 易生证书Id,多证书情况下需要,为空时使用默认证书 |
2.2.1.3 请求报文
{
"reqBody": 请求JSON,
"reqHeader": {
"transTime": "请求时间",
"transCode": "交易代码",
"transSequence": "交易流水",
"reqId": "商户号、合作方机构号等",
"certificateId": "证书id",
"transTime": "20221108121212"
},
"reqSign": ""
}
2.2.1.4 应答报文
{
"rspHeader": {
"rspCode": "00000",
"rspInfo": "成功",
"transCode": "交易代码",
"transSequence": "交易流水",
"easyPayCertificateId": "证书id"
},
"rspBody": 应答JSON,
"rspSign": ""
}
修改于 2024-09-04 03:10:37