招商直连系统，转账接口

N31010	网银贷记（跨行）
N02031	直接支付（招商同行）

直接支付

请求报文说明

交易名称		支付经办		报文方向		请求报文
接口	字段ID	字段名称	类型	取值	可空	备注
INFO	FUNNAM	函数名	C(1, 20)	DCPAYMNT	否
	DATTYP	数据格式	N(1)	2：xml格式三	否
	LGNNAM	登陆用户名	Z(1,20)		可	前置机模式必填
SDKPAYRQX	BUSCOD	业务类别	C(6)	N02031:直接支付 N02041:直接集团支付	否	直接集团支付是指使用子公司账号付款,总公司账号联动下划资金的支付。
	BUSMOD	业务模式编号	C(5)	默认为00001	可	业务模式编号和业务模式名称同时有值时业务模式编号有效；可经办的业务模式，可通过查询可经办的业务模式信息（ListMode）获得，也可以在通过前置机程序查询获得。
	MODALS	业务模式名称			可
DCOPDPAYX	YURREF	业务参考号	C（30）		否	用于标识该笔业务的编号，企业银行编号+业务类型+业务参考号必须唯一。企业可以自定义业务参考号，也可使用银行缺省值（单笔支付），批量支付须由企业提供。直联必须用企业提供
	EPTDAT	期望日	D	默认为当前日期	可
	EPTTIM	期望时间	T	默认为‘000000’	可
	DBTACC	付方帐号	N（35）		否	企业用于付款的转出帐号，该帐号的币种类型必须与币种字段相符。
	DBTBBK	付方开户地区代码	C（2）	附录A.1	否	付方帐号的开户行所在地区，如北京、上海、深圳等。付方开户地区和付方开户地区代码不能同时为空，同时有值时DBTBBK有效。
	TRSAMT	交易金额	M		否	该笔业务的付款金额。
	CCYNBR	币种代码	C(2)	附录A.3	否	币种代码和币种名称不能同时为空同时有值时CCYNBR有效。。币种暂时只支持10(人民币)
	STLCHN	结算方式代码	C(1)	N：普通 F：快速	否	只对跨行交易有效
	NUSAGE	用途	Z（62）		否	对应对账单中的摘要NARTXT
	BUSNAR	业务摘要	Z（200）		可	用于企业付款时填写说明或者备注。
	CRTACC	收方帐号	N（35）		否	收款企业的转入帐号，该帐号的币种类型必须与币种字段相符。
	CRTNAM	收方帐户名	Z（62）		可	收款方企业的转入帐号的帐户名称。收方帐户名与收方长户名不能同时为空
	LRVEAN	收方长户名	Z(200)		可	收款方企业的转入帐号的帐户名称。收方帐户名与收方长户名不能同时为空
	BRDNBR	收方行号	C(30)		可	人行自动支付收方联行号
	BNKFLG	系统内外标志		Y：招行；N：非招行；	否
	CRTBNK	收方开户行	Z（62）	跨行支付（BNKFLG=N）必填	可
	CTYCOD	城市代码	C(4)	附录A.18 CRTFLG不为Y时行内支付必填。	可	行内支付填写，为空则不支持收方识别功能。
	CRTADR	收方行地址	Z(62)	跨行支付（BNKFLG=N）必填；CRTFLG不为Y时行内支付必填。	可	例如：广东省深圳市南山区
	CRTFLG	收方信息不检查标志	C(1)	Y: 行内支付不检查城市代码和收方行地址默认为Y。	可
	NTFCH1	收方电子邮件	C（36）		可	收款方的电子邮件地址，用于交易成功后邮件通知。
	NTFCH2	收方移动电话	C（16）		可	收款方的移动电话，用于交易成功后短信通知。
	CRTSQN	收方编号	C（20）		可	用于标识收款方的编号。非受限收方模式下可重复。
	TRSTYP	业务种类	C(6)	100001=普通汇兑 101001=慈善捐款 101002 =其他默认100001	可
	RCVCHK	行内收方账号户名校验	C(1)	1：校验空或者其他值：不校验	可	如果为1，行内收方账号与户名不相符则支付经办失败。
	RSV28Z	保留字段	C(27)		可	虚拟户支付时，前10位填虚拟户编号；集团支付不支持虚拟户支付。

响应报文说明

交易名称		支付经办		报文类型		响应报文
接口	字段ID	字段名称	类型	取值	可空	备注
INFO	FUNNAM	函数名	C(1, 20)	DCPAYMNT	否
	DATTYP	数据格式	N(1)	2：xml格式三	否
	RETCOD	返回代码	N	附录A.2	否
	ERRMSG	错误信息	Z(1,256)		可
4NTQPAYRQZ	SQRNBR	流水号	C(10)		可	批量经办时，用来表示第几笔记录。
	YURREF	业务参考号	C(30)		可
	REQNBR	流程实例号	C(10)		可
	REQSTS	业务请求状态	C(3)	附录A.5	否
	RTNFLG	业务处理结果	C(1)	附录A.6	可	REQSTS=FIN时，RTNFLG才有意义
	OPRSQN	待处理操作序列	C(3)		可
	OPRALS	操作别名	C(32)		可
	ERRCOD	错误码	C(7)		可
	ERRTXT	错误文本	Z(256)		可

接口说明

接口ID	接口名称	可空	重复次数	备注
SDKPAYRQX	支付输入概要接口	否	1
DCOPDPAYX	支付输入明细接口	否	1..30或者 30..1500	支付条数不超过30条，支付输出有NTQPAYRQZ数据；超过30条，则无。
NTQPAYRQZ	支付输出接口	可	1．.30

【注意事项】

(1)首先根据返回报文INFO接口的RETCOD进行判断：0表示本次交易通讯成功。需要接下来进行(2)的判断。

-9和-1时，表示交易可疑，请查询支付结果。

其他数值，表示交易失败。

(2)如果交易通讯成功则判断返回信息中REQSTS=’FIN’ 并且 RTNFLG=’F’，表示支付失败；否则表示支付已被银行受理（注意：支付请求的返回并非表示支付成功，支付是否成功一定要查询支付结果后才能取得）。

(3)请求报文字段YURREF(业务参考号)说明：主要是用于标识该笔业务的编号，企业自己定义，相同业务的业务参考号要始终保持唯一；如果某笔业务的处理结果是失败，则该业务参考号可以继续使用，否则，该业务参考号不能再用。

(4)如果批量支付的笔数超过30笔，系统将不会当时返回支付结果，用户需要调用1.4取新的通知获取直接支付结果通知（NCDRTPAY）。

请求报文范例

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

<INFO>

<FUNNAM>DCPAYMNT</FUNNAM>

</INFO>

</SDKPAYRQX>

<CRTNAM>反洗钱测试二</CRTNAM>

</DCOPDPAYX>

</CMBSDKPGK>

响应报文范例

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

<INFO>

<FUNNAM>Payment</FUNNAM>

</INFO>

</NTQPAYRQZ>

网银贷记
1. 1. 1. 请求报文说明

交易名称		网银贷记		报文方向		请求报文
接口	字段ID	字段名称	类型	取值	可空	备注
INFO	FUNNAM	函数名	C(1, 20)	NTIBCOPR	否
	DATTYP	数据格式	N(1)	2：xml格式三	否
	LGNNAM	登陆用户名	Z(1,20)		可	前置机模式必填
NTOPRMODX	BUSMOD	业务模式	C(5)		否
NTIBCOPRX	SQRNBR	流水号	C(10)		否	批次内唯一，批量经办时用作响应结果与请求的对应字段。
	BBKNBR	付款账号银行号	C(2)		否
	ACCNBR	付款账号	C(35)		否	我行账号
	CNVNBR	协议号	C(10)		否	贷记内部协议号
	YURREF	业务参考号	C(30)		否	成功和在途的业务唯一
	CCYNBR	币种	C(2)	附录 A.3	否
	TRSAMT	金额	M		否
	CRTSQN	收方编号	C(20)		可
	NTFCH1	通知方式一	C(40)		是
	NTFCH2	通知方式二	C(40)		是
	CDTNAM	收款人户名	Z(100)		否
	CDTEAC	收款人账号	C(35)		否
	CDTBRD	收款行行号	C(12)		否
	TRSTYP	业务类型编码	C(4)	附录A.49	否
	TRSCAT	业务种类编码	C(5)	附录A.49	否
	RMKTXT	附言	Z(235)		是
	RSV30Z	保留字 30

1. 1. 1. 应答报文说明

交易名称		网银贷记		报文类型		响应报文
接口	字段ID	字段名称	类型	取值	可空	备注
INFO	FUNNAM	函数名	C(1, 20)	NTIBCOPR	否
	DATTYP	数据格式	N(1)	2：xml格式三	否
	RETCOD	返回代码	N	附录A.2	否
	ERRMSG	错误信息	Z(1,256)		可
NTOPRRTNZ	SQRNBR	流水号	C(10)
	REQNBR	流程实例号	C(10)
	REQSTS	请求状态	C(3)	附录A.5
	OPRSQN	待处理操作序列	C(3)
	OPRALS	操作别名	Z(32)
	RTNFLG	业务处理结果	C(1)	附录 A.6
	ERRCOD	错误代码	C(7)			系统返回的错误代码
	ERRTXT	错误文本	Z(92)
NTOPRDRTZ	RTNTIM	等待时间	N(3)			单位：秒
NTOPRDRTZ	RSV50Z	保留字段 50	C(50)

1. 1. 1. 接口说明

接口ID	接口名称	重复次数	备注
NTOPRMODX	输入接口	1
NTIBCOPRX	输入接口(单记录)	1..30
NTOPRDRTZ	输出接口(单记录)	0..1
NTOPRRTNZ	输出接口(单记录)	1..30

1. 1. 1. 请求报文范例

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

<INFO>

<FUNNAM>NTIBCOPR</FUNNAM>

</INFO>

</NTOPRMODX>

<NTFCH1>[email protected]</NTFCH1>

</NTIBCOPRX>

</CMBSDKPGK>

1. 1. 1. 应答报文范例

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

<INFO>

<FUNNAM>NTIBCOPR</FUNNAM>

</INFO>

</NTOPRRTNZ>

</CMBSDKPGK>