1. 协议规则

接入方对接API须遵循以下规则：

传输方式：HTTP 1.1-2.0 采用安全认证头的证明方式

提交方式：采用POST方式提交

数据格式：JSON

字符编码：统一采用UTF-8字符编码

签名算法：

签名要求：

证书要求：支持多证书，多证书时交易报文上送证书号

判断逻辑：先判断协议非空字段返回，再判断加密是否正确，最后判断交易状态

2. 公共参数

联调环境通用参数


reqHeader：
reqId：D01X66666667068

reqType：2

reqSign加签/rspSign验签规则；私钥和公钥信息看1.2加签验签说明

2.1 通用报文格式

【请求报文格式】

参数名称	含义	必填项	备注
请求参数
reqHeader	请求头	Y	请求头必填
reqBody	请求体	Y
reqSign	签名	Y	参照1.2

【请求头格式 reqHeader】

参数名称		含义	格式(Json)	必填项	备注
reqHeader	transTime	请求时间	N14	Y	yyyyMMddHHmmss
	transCode	交易代码	N6	N	业务交易码
	transSequence	交易流水	ANS6…40	N	请求流水号，必须是字符串类型。
	reqId	密钥Id	ANS32	Y	商户号、机构号等
	reqType	请求方类型	ANS32	Y	必须是字符串类型。 1：商户；2：拓展机构。默认是1 1商户模式下，reqId即为商户号mchtCode 2机构模式下，reqId即为拓展机构编号
	certificateId	证书Id	ANS6…40	N	证书Id，多证书情况下需要。支持同一个reqId下有多证书
	easyPayCertificateId	易生证书id	ANS6…40	N	易生证书Id，多证书情况下需要，为空时使用默认证书

【应答报文格式】

参数名称	含义	必填项	备注
应答参数
rspHeader	应答头	Y	必填
rspBody	应答体	C	条件域
rspSign	签名	C	参照2.2

【应答头格式 rspHeader】

参数名称		含义	格式(Json)	必填项	备注
rspHeader	rspCode	应答码	ANS5	Y	000000-成功，其他失败
	rspInfo	应答消息	ANS128	Y	错误信息
	transCode	交易代码	N6	N	同请求
	transSequence	交易流水	ANS6…40	N	同请求
	easyPayCertificateId	易生证书id	ANS6…40	N	易生证书Id，多证书情况下需要，为空时使用默认证书

2.2 报文示例

【请求报文】

{
   "reqBody": 请求JSON,    
   "reqHeader": {
        "transTime": "请求时间",
        "transCode": "交易代码",
        "transSequence": "交易流水",
        "reqId": "商户号、合作方机构号等",
        "certificateId": "证书id",
        "transTime": "20221108121212"
    },
    "reqSign": ""
}

【应答报文】

{
    "rspHeader": {
        "rspCode": "00000",
        "rspInfo": "成功",
        "transCode": "交易代码",
        "transSequence": "交易流水",
        "easyPayCertificateId": "证书id"
     },
    "rspBody": 应答JSON,
    "rspSign": ""
}

1.1 接口格式定义

1. 协议规则#

2. 公共参数#

联调环境通用参数#

2.1 通用报文格式#

2.2 报文示例#

1. 协议规则

2. 公共参数

联调环境通用参数

2.1 通用报文格式

2.2 报文示例