2. 接口规范
2.1.接口格式定义
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.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.1.3 请求报文
{
"reqBody": 请求JSON,
"reqHeader": {
"transTime": "请求时间",
"transCode": "交易代码",
"transSequence": "交易流水",
"reqId": "商户号、合作方机构号等",
"certificateId": "证书id",
"transTime": "20221108121212"
},
"reqSign": ""
} 2.1.4 应答报文
{
"rspHeader": {
"rspCode": "00000",
"rspInfo": "成功",
"transCode": "交易代码",
"transSequence": "交易流水",
"easyPayCertificateId": "证书id"
},
"rspBody": 应答JSON,
"rspSign": ""
}修改于 2023-12-02 09:36:11