网银贷记 (跨行) |
|
N02031 |
直接支付 (招商同行) |
直接支付
请求报文说明
交易名称 |
支付经办 |
报文方向 |
请求报文 |
|||
接口 |
字段ID |
字段名称
扫描二维码关注公众号,回复:
3965036 查看本文章
|
类型 |
取值 |
可空 |
备注 |
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) |
否 |
付方帐号的开户行所在地区,如北京、上海、深圳等。 付方开户地区和付方开户地区代码不能同时为空,同时有值时DBTBBK有效。 |
||
TRSAMT |
交易金额 |
M |
|
否 |
该笔业务的付款金额。 |
|
CCYNBR |
币种代码 |
C(2) |
否 |
币种代码和币种名称不能同时为空同时有值时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) |
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=慈善捐款 默认100001 |
可 |
|
|
RCVCHK |
行内收方账号户名校验 |
C(1) |
1:校验 空或者其他值:不校验 |
可 |
如果为1,行内收方账号与户名不相符则支付经办失败。 |
|
RSV28Z |
保留字段 |
C(27) |
|
可 |
虚拟户支付时,前10位填虚拟户编号;集团支付不支持虚拟户支付。 |
响应报文说明
交易名称 |
支付经办 |
报文类型 |
响应报文 |
|||
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
FUNNAM |
函数名 |
C(1, 20) |
DCPAYMNT |
否 |
|
DATTYP |
数据格式 |
N(1) |
2:xml格式三 |
否 |
|
|
RETCOD |
N |
否 |
|
|||
ERRMSG |
错误信息 |
Z(1,256) |
|
可 |
|
|
4NTQPAYRQZ |
SQRNBR |
流水号 |
C(10) |
|
可 |
批量经办时,用来表示第几笔记录。 |
YURREF |
业务参考号 |
C(30) |
|
可 |
|
|
REQNBR |
流程实例号 |
C(10) |
|
可 |
|
|
REQSTS |
业务请求状态 |
C(3) |
否 |
|
||
RTNFLG |
业务处理结果 |
C(1) |
可 |
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"?>
<CMBSDKPGK>
<INFO>
<FUNNAM>DCPAYMNT</FUNNAM>
<DATTYP>2</DATTYP>
<LGNNAM>ZL01</LGNNAM>
</INFO>
<SDKPAYRQX>
<BUSCOD>N02031</BUSCOD>
</SDKPAYRQX>
<DCOPDPAYX>
<YURREF>APP060928001255</YURREF>
<DBTACC>1280022310002</DBTACC>
<DBTBBK>75</DBTBBK>
<TRSAMT>1.01</TRSAMT>
<CCYNBR>10</CCYNBR>
<STLCHN>N</STLCHN>
<NUSAGE>测试</NUSAGE>
<BNKFLG>Y</BNKFLG>
<CRTACC>1280022310601</CRTACC>
<CRTNAM>反洗钱测试二</CRTNAM>
<CRTBNK>招商银行</CRTBNK>
</DCOPDPAYX>
</CMBSDKPGK>
响应报文范例
<?xml version="1.0" encoding = "GBK"?>
<CMBSDKPGK>
<INFO>
<FUNNAM>Payment</FUNNAM>
<DATTYP>2</DATTYP>
<RETCOD>0</RETCOD>
<ERRMSG></ERRMSG>
</INFO>
<NTQPAYRQZ>
<ERRCOD>SUC0000</ERRCOD>
<REQNBR>0012341664</REQNBR>
<REQSTS>NTE</REQSTS>
<SQRNBR>0000000002</SQRNBR>
<YURREF>APP060928000251</YURREF>
</NTQPAYRQZ>
<CMBSDKPGK>
- 网银贷记
-
-
- 请求报文说明
-
-
交易名称 |
网银贷记 |
报文方向 |
请求报文 |
|||
接口 |
字段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) |
否 |
|
||
TRSAMT |
金额 |
M |
|
否 |
|
|
CRTSQN |
收方编号 |
C(20) |
|
可 |
|
|
NTFCH1 |
通知方式一 |
C(40) |
|
是 |
|
|
NTFCH2 |
通知方式二 |
C(40) |
|
是 |
|
|
CDTNAM |
收款人户名 |
Z(100) |
|
否 |
|
|
CDTEAC |
收款人账号 |
C(35) |
|
否 |
|
|
CDTBRD |
收款行行号 |
C(12) |
|
否 |
|
|
TRSTYP |
业务类型编码 |
C(4) |
否 |
|
||
TRSCAT |
业务种类编码 |
C(5) |
否 |
|
||
RMKTXT |
附言 |
Z(235) |
|
是 |
|
|
RSV30Z |
保留字 30 |
|
|
|
|
-
-
-
- 应答报文说明
-
-
交易名称 |
网银贷记 |
报文类型 |
响应报文 |
|||
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
FUNNAM |
函数名 |
C(1, 20) |
NTIBCOPR |
否 |
|
DATTYP |
数据格式 |
N(1) |
2:xml格式三 |
否 |
|
|
RETCOD |
返回代码 |
N |
否 |
|
||
ERRMSG |
错误信息 |
Z(1,256) |
|
可 |
|
|
NTOPRRTNZ |
SQRNBR |
流水号 |
C(10) |
|
|
|
REQNBR |
流程实例号 |
C(10) |
|
|
|
|
REQSTS |
请求状态 |
C(3) |
|
|
||
OPRSQN |
待处理操作序列 |
C(3) |
|
|
|
|
OPRALS |
操作别名 |
Z(32) |
|
|
|
|
RTNFLG |
业务处理结果 |
C(1) |
|
|
||
ERRCOD |
错误代码 |
C(7) |
|
|
系统返回的错误代码 |
|
ERRTXT |
错误文本 |
Z(92) |
|
|
|
|
NTOPRDRTZ |
RTNTIM |
等待时间 |
N(3) |
|
|
单位:秒 |
RSV50Z |
保留字段 50 |
C(50) |
|
|
|
-
-
-
- 接口说明
-
-
接口ID |
接口名称 |
重复次数 |
备注 |
NTOPRMODX |
输入接口 |
1 |
|
NTIBCOPRX |
输入接口(单记录) |
1..30 |
|
NTOPRDRTZ |
输出接口(单记录) |
0..1 |
|
NTOPRRTNZ |
输出接口(单记录) |
1..30 |
|
-
-
-
- 请求报文范例
-
-
<?xml version="1.0" encoding="GBK"?>
<CMBSDKPGK>
<INFO>
<FUNNAM>NTIBCOPR</FUNNAM>
<DATTYP>2</DATTYP>
<LGNNAM>OL03</LGNNAM>
</INFO>
<NTOPRMODX>
<BUSMOD>00001</BUSMOD>
</NTOPRMODX>
<NTIBCOPRX>
<BBKNBR>CB</BBKNBR>
<ACCNBR>755903332110404</ACCNBR>
<CNVNBR>0000001060</CNVNBR>
<SQRNBR>0000000001</SQRNBR>
<YURREF>20140722100113</YURREF>
<CCYNBR>10</CCYNBR>
<TRSAMT>10</TRSAMT>
<CRTSQN>RCV0000002</CRTSQN>
<NTFCH1>[email protected]</NTFCH1>
<NTFCH2>18388889999</NTFCH2>
<CDTNAM>林志玲</CDTNAM>
<CDTEAC>6226000011118888123</CDTEAC>
<CDTBRD>102100000128</CDTBRD>
<TRSTYP>C208</TRSTYP>
<TRSCAT>02019</TRSCAT>
<RMKTXT></RMKTXT>
<RSV30Z></RSV30Z>
</NTIBCOPRX>
</CMBSDKPGK>
-
-
-
- 应答报文范例
-
-
<?xml version="1.0" encoding="GBK"?>
<CMBSDKPGK>
<INFO>
<DATTYP>2</DATTYP>
<ERRMSG></ERRMSG>
<FUNNAM>NTIBCOPR</FUNNAM>
<LGNNAM>OL03</LGNNAM>
<RETCOD>0</RETCOD>
</INFO>
<NTOPRRTNZ>
<ERRCOD>SUC0000</ERRCOD>
<REQNBR>0000946921</REQNBR>
<REQSTS>BNK</REQSTS>
<SQRNBR>0000000001</SQRNBR>
</NTOPRRTNZ>
</CMBSDKPGK>