电子协议联调说明#
一、商户接入流程#
2.接入活动图如下

二、接口约定#
3.
接口地址:https://【IP】:【Port】/EasypayMPSystem/ContractServet
IP:电子协议系统地址
Port:电子协议系统端口
请求参数
字段 | 说明 |
---|
channelId | 电子协议系统分配的机构号 |
merId | 电子协议系统分配的商户号 |
termId | 电子协议系统分配的终端号 |
tradeTrace | 请求流水,唯一,不包括特殊字符 |
version | “1.0” |
txCode | 请求类型 |
contractBody | 请求的报文 |
sign | 请求的签名,是对 POST 请求参数的签名 |
contractBody(请求的报文)详细
字段 | 约束 | 说明 |
---|
head | NOT NULL | 头信息 |
data | NOT NULL | 业务信息 具体由各个接口自定义详细字段 |
head(头信息)详细
字段 | 约束 | 长度 | 说明 |
---|
txTime | NOT NULL | 14 | 交易时间:yyyyMMddHHmmss |
locale | | 5 | 语言,默认按照中文处理:zh_CN。 |
remark | | 100 CHAR | 备注,预留字段,不做处理 |
返回参数
字段 | 说明 |
---|
resultCode | 应答码 |
resultMsg | 应答描述 |
contractBody | 应答的报文 |
sign | 请求的签名,是对 POST 应答参数的签名 |
成功时-contractBody(应答的报文)详细
字段 | 约束 | 说明 |
---|
head | NOT NULL | 头信息 |
data | NOT NULL | 业务信息 具体由各个接口自定义详细字段 |
>> head(头信息)详细
字段 | 约束 | 长度 | 说明 |
---|
txTime | NOT NULL | 14 | 交易时间:yyyyMMddHHmmss |
retCode | NOT NULL | 20 | 返回代码 |
retMessage | NOT NULL | 100 CHAR | 返回信息 |
失败时-contractBody(应答的报文)详细
字段 | 约束 | 长度 | 说明 |
---|
errorCode | NOT NULL | 20 | 返回代码(错误码) |
errorMessage | NOT NULL | 100 CHAR | 返回信息(错误信息) |
以 POST 请求的方式进行相互之间通信,作为参数使用的数据包均以 JSON 格式进行内容的定义,使用 UTF-8 的编码方式。为了避免类型错误带来的异常影响,所有数值都是字符型。