接口描述
查询签约协议号状态
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试调用地址
https://gateway.test.95516.com/gateway/api/backTransReq.do
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5.1.0 | M-必填 | 固定填写5.1.0
|
||
| 编码方式 | encoding | string | UTF-8 | M-必填 | 默认取值:UTF-8
|
||
| 证书ID | certId | string | M-必填 |
|
|||
| 签名 | signature | string | M-必填 | 填写对报文摘要的签名
|
|||
| 签名方法 | signMethod | string | M-必填 | 非对称签名:
01:签名采用RSA算法,使用SHA-256散列算法配合;敏感信息加解密采用RSA算法
21:签名采用SM2算法,使用SM3散列算法配合;敏感信息加解密采用SM2算法
散列验证算法:
11:支持散列方式验证SHA-256
12:支持散列方式验证SM3
|
|||
| 交易类型 | txnType | int | 78 | M-必填 | 取值:78
|
||
| 交易子类 | txnSubType | int | 20 | M-必填 | 默认:20
|
||
| 产品类型 | bizType | int | 000000 | M-必填 | 000000
|
||
| 渠道类型 | channelType | int | 07 | M-必填 | 07
|
||
| 接入类型 | accessType | int | M-必填 | 0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
|
|||
| 收单机构代码 | acqInsCode | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户类别 | merCatCode | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户代码 | merId | string | M-必填 |
|
|||
| 商户名称 | merName | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户简称 | merAbbr | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 二级商户代码 | subMerId | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户名称 | subMerName | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户简称 | subMerAbbr | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 商户订单号 | orderId | string | M-必填 | 交易的订单号,由商户生成
|
|||
| 订单发送时间 | txnTime | string | M-必填 |
|
|||
| 签约协议号 | contractId | string | M-必填 |
|
|||
| 签约模板ID | planId | string | M-必填 | 签约模板ID,与接入产品对应。
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | R-需要返回 |
|
|||
| 编码方式 | encoding | string | R-需要返回 |
|
|||
| 签名 | signature | string | M-必填 |
|
|||
| 签名方法 | signMethod | string | M-必填 |
|
|||
| 交易类型 | txnType | int | 78 | R-需要返回 | 取值:78
|
||
| 交易子类 | txnSubType | int | 20 | R-需要返回 | 默认:20
|
||
| 产品类型 | bizType | int | 000000 | R-需要返回 | 000000
|
||
| 接入类型 | accessType | string | R-需要返回 |
|
|||
| 收单机构代码 | acqInsCode | string | R-需要返回 |
|
|||
| 商户代码 | merId | string | R-需要返回 |
|
|||
| 商户订单号 | orderId | string | R-需要返回 |
|
|||
| 订单发送时间 | txnTime | string | R-需要返回 |
|
|||
| Token状态 | tokenStatus | int | C-按条件必填 | 0:初始化(未激活)
1:激活
2:挂失
3:注销(解绑)
|
|||
| Token有效期 | tokenEndExpr | string | C-按条件必填 | 应答码为00时返回
|
|||
| 响应码 | respCode | string | M-必填 |
|
|||
| 应答信息 | respMsg | string | M-必填 |
|
示例代码