2. 接口概述

2.报文概述

2.1 报文清单

报文分类	报文组	交易类型	报文名称	报文方向	是否对账
基础交易	批量收款付报文组	100001	批量收款	商户→通联	√
	批量收款付报文组	100002	批量付款	商户→通联	√
	单笔实时收款付报文组	100011	单笔实时收款	商户→通联	√
	单笔实时收款付报文组	100014	单笔实时付款	商户→通联	√
	通用报文组	REFUND	退款	商户→通联	√
		200004	交易结果查询	商户→通联	×
		200002	对账文件下载	商户→通联	×
	异步通知接口		收款付交易完成通知	通联→商户	×
	异步通知接口		汇入金到账通知	通联→商户	×
统一签约		310001	签约申请	商户→通联	×
		310002	签约验证	商户→通联	×
		340009	签约查询	商户→通联	×
			签约结果通知	通联→商户	×
资金管理		300007	账户余额查询	商户→通联	×
资金管理		300008	账户明细查询	商户→通联	×

2.2 联机报文通讯

2.2.1 公网通讯方式

HTTPS的POST方式，支持TLS1.0，TLS1.1，TLS1.2，建议用TLS1.2方式。

2.2.2 专线通讯方式

HTTP的POST方式。

2.2.3 生产环境接口地址

目标环境	接口地址	说明
接口生产环境URL	https://jfb.allinpay.com/merapi/prcsvc?MERCHANT_ID=?&REQ_SN=?	默认GBK编码
接口生产环境URL	https://jfb.allinpay.com/merapi/prcsvc?MERCHANT_ID=?&REQ_SN=?&ENCODING=UTF-8	如是UTF-8编码使用该格式

2.3 字段类型

本技术规则在报文的“类型”列中使用的字段类型按如下的说明：

属性	说明
C(n)	业务要素的值可使用字母、中文等，长度固定为n
C(n,m)	业务要素的值可使用字母、中文等，最小长度为n、最大长度为m
N(n)	业务要素的值只能使用数字，长度固定为n

2.4 字段限制

本技术规则在报文的“限制”列中使用M、C的形式描述业务要素的传递条件：

属性	说明
M	必填
C	选填

2.5 编码要求

本系统报文接口数据使用的是GBK编码。

<?xml version="1.0" encoding="GBK"?>

2.6 报文格式组成

2.7 报文头

2.7.1 请求报文头

请求报文头格式为：“<HEAD>报文头内容</HEAD>”，内容如下所示。

接口	字段	字段解释	必填	类型	取值	备注
HEAD	TRX_CODE	交易代码	是	C(6,10)		详见报文头说明
	VERSION	版本号	是	C(2)	01
	LEVEL	处理级别	是	N(1)	5
	MERCHANT_ID	商户号	是	C(10,20)
	SUBMIT_TIME	提交时间	是	C(14)
	USER_NAME	用户名	是	C(1,20)
	REQ_SN	请求流水号	是	C(36,60)

2.7.2 响应报文头

响应报文头格式为：“<HEAD>报文头内容</HEAD>”，内容如下所示。

接口	字段	字段解释	必填	类型	取值	备注
HEAD	TRX_CODE	交易代码	是	C(6,10)		详见报文头说明
	VERSION	版本号	是	C(2)
	REQ_SN	请求流水号	是	C(36,60)
	RET_CODE	返回码	是	C(4)
	RET_MSG	返回信息	是	C(1,128)

2.8 签名过程

签名算法为：SHA256WithRSA。

商户用私密钥对请求报文进行签名，用公钥对响应报文进行验签。

对整个报文签名，将签名信息置于<SIGNED_MSG>节点中，最后将该节点附在报文之后。

2.9 报文主要字段概念说明

2.9.1 商户号

通联报文中的商户号为15位的数字编码，商户入网时由通联分配。

2.9.2 交易代码

交易代码区分了对应的报文功能。

2.9.3 业务代码

业务代码在商户入网时由通联分配，商户报文只能上送指定的业务代码。

2.9.4 银行代码

报文中的银行代码一般为可选字段，通联的处理逻辑为：通联会优先卡BIN匹配，若对应的卡号不存在通联的卡BIN中，取商户上送的银行代码。存折必须上送银行代码。