城市商业银行资金清算中心电子银行接口标准.docx

内部资料注意保密城市商业银行资金清算中心网银互联系统网银服务平台接口标准（Ver2.0）城市商业银行资金清算中心二一年七月编号：TJJR_CCFCCB_XQS 受控号：001城市商业银行资金清算中心网银互联系统网银服务平台接口标准拟制： 审核： 批准： 城市商业银行资金清算中心太极计算机股份有限公司目录第一章网银互联业务要素一览表11.1网银互联业务要素一览表1第二章网银互联报文网银服务平台接口标准11第三章网银互联柜面接口123.1第三方贷记业务URL请求2040611123.2第三方贷记业务URL应答2040611133.3预授权URL请求2040613143.4预授权URL应答2040613153.5授权支付协议签约URL请求2040615153.6授权支付协议签约URL应答2040615174.1授权支付协议解除URL请求2040621174.2授权支付协议解除URL应答2040621193.7账户信息查询协议签约URL请求2040617203.8账户信息查询协议签约URL应答2040617214.3账户信息查询协议解除URL请求2040623214.4账户信息查询协议解除URL应答204062323第四章网银互联网银端接口234.5授权支付协议管理通知请求2040603234.6授权支付协议管理通知应答2040603264.7账户信息查询协议管理通知请求2040604264.8账户信息查询协议管理通知应答2040604274.9借记账户余额查询请求2040605284.10借记账户余额查询应答2040605294.11贷记账户余额查询请求2040606304.12贷记账户余额查询应答2040606314.13借记账户明细查询请求2040607324.14借记账户明细查询应答2040607334.15贷记账户明细查询请求2040608344.16贷记账户明细查询应答2040608354.17授权支付协议查询请求2040609364.18授权支付协议查询应答2040609374.19账户查询协议查询请求2040610394.20账户查询协议查询应答2040610404.21第三方贷记业务在线认证请求2040612414.22第三方贷记业务在线认证应答2040612434.23预授权在线认证请求2040614434.24预授权在线认证应答2040614444.25授权支付协议签约在线认证请求2040616444.26授权支付协议签约在线认证应答2040616464.27账户信息查询协议签约在线认证请求2040618474.28账户信息查询协议签约在线认证应答2040618484.29协议账户关联协议查询请求2040620484.30协议账户关联协议查询应答2040620494.31授权支付协议解除在线认证请求2040622504.32授权支付协议解除在线认证应答2040622514.33账户信息查询协议解除在线认证请求2040624524.34账户信息查询协议解约在线认证应答2040624534.35信用卡自动扣款协议账户关联请求2040625534.36信用卡自动扣款协议账户关联应答2040625544.37授权支付协议签约申请请求2040627554.38授权支付协议签约申请应答2040627564.39账户信息查询协议签约申请请求2040628574.40账户信息查询协议签约申请应答2040628584.41网银贷记业务往账请求2040629584.42网银贷记业务往账应答2040629624.43网银借记业务往账请求2040630634.44网银借记业务往账应答2040630654.45网银借记业务手续费查询请求2040631654.46网银借记业务手续费查询应答2040631674.47跨行转账手续费查询请求2040632674.48跨行转账手续费查询应答204063269第一章 网银互联业务要素一览表1.1 网银互联业务要素一览表业务要素是指城商行支付清算系统各类业务的基本组成元素。其中报文头域，业务要素集域业务要素参见城市商业银行资金清算中心业务标准。以4开始的业务要素请参见城市商业银行资金清算中心网银业务标准。域名代码（4位）中文名称英文缩写（不超过12位）长度标识域属性最大域宽网银互联专用扩展域6001ibps报文头IBPSHead3122x1226002报文标识号MsgId235n356003报文发送时间CreDtTm214n146004批量报文标识BtchBookg15x56005明细业务总笔数NbOfTxs215n156006明细业务总金额CtrlSum213n.2n166007当前工作日IntrBkSttlmDt210n106008清算方法SttlmMtd14x46009端到端标识号EndToEndId235x356010交易标识号TxId235n356011机构属性InstrPrty14x46012业务类型编码CtgyPrtry14x46013金额货币符号AmtCurrency13x16014金额Amount213n.2n166015委托时间AccptncDtTm214n146016ChargeBearerChrgBr14x46017付款人户名DbtrNm3120g1206018交易时间OlnTxDtTm214n146019 付款人账号DbtrId232x326020 付款人开户行名称DbtrIssr270g706021 付款人账户类型DbtrPrtry14x46022 付款清算行行号DbtrClrMmbId212n126023 付款人开户行所属网银系统行号DbtrBrnchId212n126024 付款开户行所属城市代码DbtrCtrySubDvsn16n66025 收款清算行行号CdtrClrMmbId212n126026 收款人开户行所属网银系统行号CdtrBrnchId212n126027 收款人户名CdtrNm3120g1206028 收款人账号CdtrId232x326029 业务种类编码PurpPrtry15n56030 附言RmtInf3280g280s6031 原业务报文标识号OrgnlMsgId235n356032 原报文类型号OrgnlMsgNmId235x356033 业务回执附言AddtlInf3210g2106034 原端到端标识号OrgnlEndToEndId235x356035 原交易标识号OrgnlTxId235n356036 业务状态TxSts14x46037 业务拒绝码RsnPrtry14x46038 业务拒绝原因RsnAddtlInf3210g2106039 原货币符号OrgnlCurrency13x36040 原金额OrgnlAmount213n.2n166041 收款开户行所属城市代码CdtrCtrySubDvsn16n66042 收款人开户行名称CdtrIssr270g706043 收款人账户类型CdtrPrtry14x46044 LocalInstrument ProprietaryLclInstrmPrtry235x356045 认证方式AuthCode14x46046 认证信息AuthInf3140x1406047 网上交易单号OlnTxId335x356048 结算金额SttlmAmt213n.2n166049 手续费Fee213n.2n166050 第三方机构号TrdMmbId212n126051 收取手续费的参与机构号FeeMmbId212n126052 商户编号UltmtCdtrId235x356053 商户名称UltmtCdtrNm2120g1206054 预授权号AuthstnId260x606055 交易限定付款账户类型AcctLtdTypeCode14x46056 原网上交易单号OrgnlOlnTxId235x356057 URL信息URLInf42048x20486058 发起参与机构InstgPty212n126059 接收参与机构InstdPty212n126060 系统号SysCd14x46061 信息内容MsgCnt41000g10006062 原业务类型编码OrgnlTxTpCd14x46063 备注RmkInf3512g5126064 处理状态ProcSts14x46065 业务处理码ProcCd18x86066 拒绝信息RjctInf3210g2106067 原申请报文标识号OrgnlGrpMsgId235n356068 申请业务状态GrpProcSts14x46069 申请业务处理码GrpProcCd18x86070 申请业务拒绝信息GrpRjctInf3210g2106071 参与机构行号PtyId212n126072 业务轧差日期TxNetgDt18n86073 业务轧差场次TxNetgRnd12n26074 业务清算日期TxSttlmDt18n86075 CaseIdCaseId235x356076 协议号PtcId260x606077 查询人账号QristAcct232x326078 查询人户名或者名称QristNm3120g1206079 查询人开户行名称或查询机构名称QristPtyNm3120g1206080 查询机构所属网银系统行号QristPtyHdl212n126081 被查询人账号RplirAcct232x326082 被查询人户名RplirNm3120g1206083 被查询行名称RplirDpsNm3120g1206084 被查询人所属网银系统行号RplirDpsHdl212n126085 查询类型QryTp14x46086 开始日期StartgDt18n86087 截止日期DdlnDt18n86088 账户类型AcctTp14x46089 账号Acct232x326090 类型名称TpNm3120g1206091 日期Dt18n86092 交易说明Summry3512g5126093 余额货币符号BalCurrency13x36094 借贷标识CdtDbtInd14x46095 交易对手账号VsAcct232x326096 交易对手名称VsNm2120g1206097 信用额度CdtAmt213n.2n166098当前可用额度AvlbAmt213n.2n166099 预借现金信用额度CshCdtAmt213n.2n166100 预借现金可用额度CshAvlbAmt213n.2n166101 时间DtTm214n146102 管理类型MgmtTp14x46103 客户号CstmrNb260x606104 授权支付的业务种类AthtctnPmtCtgy15x56105 累计金额币种TtlCurrency13x36106 单笔业务金额上限SnglTxAmtLmt213n.2n166107 日累计业务笔数上限DlTtlCnt18n86108 日累计金额上限DlTtlAmtLmt213n.2n166109 月累计业务笔数上限MslTtlCnt18n86110 月累计金额上限MslTtlAmtLmt213n.2n166111 付款人联系电话DbtrPhneNb232x326112 客户服务号DbtrCstmrId260x606113 原报文发送时间OrgnlCreDtTm214n146114 清算行号ClrMmbId234n346115 Domain CodeDomnCd14x46116 Family CodeFmlyCd14x46117 SubFamilyCodeSubFmlyCd14x46118 手续费币种FeeCurrency13x36119 清算系统ClrSysRef235x356120 Statement IdentificationStmtId235x356121 Statement CreationDateTimeStmtDtTm214n146122 核算机构名称SettleName3120g1206123 Bal Type CodeBalTpCd235x356124 本场次贷方发生额TtlCdtNtries213n.2n166125 本场次借方发生额TtlDbtNtries213n.2n166126 状态Sts14x46127 计费月份ChrgMnth18n86128 分润总金额ChrgRvsdTtlAmt213n.2n16f6129 对账日期ChckDt18n86130 发送报文总数SndTtlCnt18n86131 接收报文总数RcvTtlCnt18n86132 发送接收标识SndRcvInd14x46133 原系统日期OrgnlSysDt18n86134 原系统状态OrgnlSysSts14x46135 系统当前日期CurSysDt18n86136 系统当前状态CurSysSts14x46137 系统下一日期NxtSysDt18n86138 操作类型OprTp14x46139 变更类型ChgTp14x46140 行别代码BkCtgyCd13n36141 行别名称BkCtgyNm3120g1206142 总记录数TtlNb18n86143 记录起始号StartNb18n86144 记录截止号EndNb18n86145 变更期数ChngCnt18n86146 参与机构名称PtyNm3120g1206147 参与机构别名PtyAlsNm3120g1206148 参与机构类型PtyTp14x46149 代理清算参与机构号SttlmAgtId212n126150 生效日期FctvDt28x86151 生效类型FctvTp14x46152 公共数据类型CmonDataTp14x46153 公共数据代码CmonDataCd18x86154 公共数据名称CmonDataNm3120g1206155 公共数据值CmonDataVal3512g5126156余额借贷方向BalCdtDbtInd14x46166总金额ChrgTtlAmt213n.2n166167总金额币种ChrgTtlCny13x36168分润金额币种ChrgRvsdCny13x36169类型Tp14x46170参与机构号PtyInf212n126171原发起机构号OrgnlInstgPty212n126172报文内容原文MsgContent44096g40966173阶段编号ClrSysRef11n16174标识Flag11n16175节假日标识HldayFlg44x46176收付款行接收标志CdtOrDbtBkRcvFlg44x46177信用额度CdtAmt213n.2n26178当前可用额度AvlbAmt213n.2n26179预借现金信用额度CshCdtAmt213n.2n26180预借现金可用额度CshAvlbAmt213n.2n26201报文类型号MsgNmId235x356499数字签名DgtSgntr42048x2048注：系统共用的四个域：域名域名代码数据长度数据报文MD5zzzy32x对报文头和报文体中所有域进行计算产生报文摘要MD5字符串文件MD5zzzw32x对文件内容进行计算产生文件摘要MD5字符串MACzzzz16x对MD5域zzzy计算产生的MAC字符串，即为报文的密押文件名zzzx160g- 6 -第二章 网银互联报文网银服务平台接口标准 网银互联业务的请求报文使用实时信息业务要素集（006）时，只使用其必填项（即只能填写交易代码、交易序号、发起行行号、发起清算行行号、接收行行号、接收清算行行号、委托日期这7个域）。网银互联业务的应答报文使用实时信息业务要素集（006）时，使用其必填项（即交易代码、交易序号、发起行行号、发起清算行行号、接收行行号、接收清算行行号、委托日期这7个域）外，还包括应答码和附言，其中，应答码为必填项，而附言为可选项，当应答报文是正常情况，附言不用添，当应答报文是异常情况，则附言要填写异常错误信息，并且与应答报文相对应的扩展数据不添。参考业务类型必填，为原业务类型，实时信息业务要素集中的7个必填域填写的是原交易信息。应答报文中扩展域的必填是指应答码成功时必填，应答码失败时，不需要扩展域。对于报文中的文件，每一行代表一条记录；每一条记录由一个或多个“域数据”构成，两个“域数据”之间用“|”分隔；可选的字段若是空值则用两个相邻“|”字符表示；域代码并不是域数据的一部分，因此，域代码不保存在文件。报文中的文件命名如下：“请求或应答标志+委托日期+发起行行号+业务类型+交易序号”其中：请求或应答标志：1字节 R-请求 A-应答委托日期：8字节 YYYYMMDD发起行行号：12字节业务类型：2字节 交易序号：12字节 不足左补零第三章 网银互联柜面接口3.1 第三方贷记业务URL请求2040611报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x网上交易单号6047M35x报文标识号6002M35n委托时间6015M14n表示日期和时间，格式yyyymmddHHMMSS第三方机构号6050M12n币种6013M3x交易金额6014M13n.2n手续费币种6118M3x手续费6049M13n.2n商户名称6053O120g标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0- 一代网银1- 二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行作为付款方，收到第三方贷记业务，需要在线认证时，发送此报文获得URL信息。3.2 第三方贷记业务URL应答2040611报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g功能说明：成员行收到此报文，发送待认证的第三方贷记应答至人行。3.3 预授权URL请求2040613报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x网上交易单号6047M35x报文标识号6002M35n委托时间6015M14n表示日期和时间，格式yyyymmddHHMMSS第三方机构号6050M12n对应预授权报文中的发起机构号币种6013M3x交易金额6014M13n.2n商户名称6053M120g标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0- 一代网银1- 二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行收到预授权业务，需要在线认证时，发送此报文获得预授权的URL信息。3.4 预授权URL应答2040613报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g3.5 授权支付协议签约URL请求2040615报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x报文标识号6002M35n客户号6103M60x第三方机构号6050M12n对应授权支付协议管理报文中的发起机构号收款人户名6027M120g1个0表示没有限定收款人收款人账号6028M32x同上收款人开户行名称6042M70g同上授权支付的业务种类6104M5x1个0表示没有限定业务种类；标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0- 一代网银1- 二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行收到授权支付协议管理业务，签约时需要在线认证，发送此报文获得预授权的URL信息。3.6 授权支付协议签约URL应答2040615报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g4.1 授权支付协议解除URL请求2040621报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x报文标识号6002M35n客户号6103M60x授权支付协议号6076M60x付款人名称6017M120g付款人账号6019M32x付款人开户行名称6020M70g第三方机构号6050M12n对应授权支付协议管理报文中的发起机构号收款人户名6027M120g1个0表示没有限定收款人收款人账号6028M32x同上收款人开户行名称6042M70g同上授权支付的业务种类6104M5x1个0表示没有限定业务种类；标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0-一代网银1-二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行收到授权支付协议管理业务，解除时需要在线认证，发送此报文获得预授权的URL信息。4.2 授权支付协议解除URL应答2040621报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g3.7 账户信息查询协议签约URL请求2040617报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x报文标识号6002M35n第三方机构号6050M12n对应账户信息查询协议管理报文中的发起机构号查询人账号6077 M32x查询人账号查询人户名6078 M120g查询人户名查询人开户行名称6079 M120g查询人开户行名称标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0-一代网银1-二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行收到账户查询协议管理业务，签约时需要在线认证，发送此报文获得预授权的URL信息。3.8 账户信息查询协议签约URL应答2040617报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g4.3 账户信息查询协议解除URL请求2040623报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x报文标识号6002M35n账户信息查询协议号6076M60x第三方机构号6050M12n对应账户信息查询协议管理报文中的发起机构号查询人账号6077 M32x查询人账号查询人户名6078 M120g查询人户名查询人开户行名称6079 M120g查询人开户行名称被查询人账号6081 M32x被查询人户名6082 M120g被查询行名称6083 M120g标志4070 M1x0-个人网银客户1-企业网银客户网银标志4038O1x0-一代网银1-二代网银(如果成员行二代网银不做改造，送空，网银默认把空转为0-一代网银) 备注6063O512g功能说明：成员行收到账户查询协议管理业务，签约时需要在线认证，发送此报文获得预授权的URL信息。4.4 账户信息查询协议解除URL应答2040623报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET010实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注报文标识号6002M35n原请求内容url信息6057M2048g第四章 网银互联网银端接口4.5 授权支付协议管理通知请求2040603报文包含：报文头、实时信息业务要素集（006）、扩展数据报文类代码使用SET009实时信息报文。有扩展数据。格式如下：要素名称域代码必填/可选(M/O)属性备注柜员号4102M12x接收参与机构6059M12n管理类型6102M4xMT00：签订MT02：撤销协议号6076O60x撤销时必填客户号6103M60x指第三方唯一识别客户的编号；如无此项填写为“0”付款人名称6017M120g付款人账号6019M32x付款账户交易密码4107O16x对公交易不填付款人账户类型6021M4x付款人联系电话6111M32x收款人户名6027M120g1个0表示没有限定收款人收款人账号6028M32x同上收款人开户行名称6042M70g同上收款人开户行所属网银系统行号6026M12n同上客户服务号(收款人)6112O60x指收款人唯一识别的客户的编号；当限定收款人时，必须填写此项授权支付的业务种类6104M5x1个0表示没有限定业务种类；单笔业务金额币种6013O3x单笔业务金额上限6106 O13n.2n日累计业务笔数上限6107 O8n日累计金额币种6093O3x日累计金额上限6108 O13n.2n月累计业务笔数上限6109 O8n月累计金额币种6105O3x月累计金额上限6110 O13n.2n协议生效日期6086M8n协议失效日期6087O8n如不填写则表示协议永久有效标志4070 M1x0-个人网银客户1-企业网银客户备注6063O512g功能说明：本报文用于传输授权支付协议管理通知业务。4.6 授权支付协议管理通知应答2040603报文包含：报文头、实时信息业务要素集（006）报文类代码