银行接口协议

1、/银行接口协议采用 socket 的方式来进行数据交换。1、签到交易名称调用说明输入参数交易编号交易输入xml输出参数交易输出 xml签到交易长城终端发起签到交易，获取银行工作密钥1001<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Da

2、te ></ Date >< Time ></ Time ></HEAD><DATA>< PosId ></ PosId >< Demo ></ Demo > <MerchNo></ MerchNo></DATA><UTILITYPAYMENT><UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode >

3、</ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< WorkKey></ WorkKey >/< Demo ></ Demo > </DATA ><UTILITYPAYMENT>参数详细说明 :交易头

4、：代码名称约束类型说明TransCode交易编号NOT NULLVARCHAR(4)1001ResponseCod响应码NOT NULLVARCHAR(4)成功： 0000e失败： 0001ResponseMsg响应信息NOT NULL变长错误描叙Date日期NOT NULLVARCHAR(8)Time时间NOT NULLVARCHAR(6)Tranlist流水号NOT NULL变长无交易输入：代码名称约束类型说明PosId终端号810_001Demo备注变长MerchNo商户号变长交易输出：代码名称约束类型说明WorkKey工作密钥NOT NULL变长Demo备注2、绑定交易名称绑定交易银行

5、发送诊疗卡号或诊疗卡账户到医院，医院返还身份证、姓名，诊疗卡号，诊疗卡账户，银行进行身份证、姓名核对后，把诊疗卡号、诊疗卡账户、借记卡号发送医院进行绑定，医院返还响应码。调用说明（诊疗卡账户与诊疗卡号一一对应，更换诊疗卡号不会变更诊疗卡账户）绑定关系为：诊疗卡账户借记卡账户。输入参数交易编号1002<UTILITYPAYMENT>交易输入xml< HEAD>/< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg >&l

6、t;/ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA >< Name ></ Name > <IDType></ IDType >< IDNo ></ IDNo >< TrmtNo ></ TrmtNo > <BankNumber></BankNumber&

7、gt;< PosId ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3><Demo></Demo></DATA ><UTILITYPAYMENT>输出参数<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode &

8、gt;< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >交易输出xml< Date ></ Date >< Time ></ Time > </HEAD><DA TA > <Demo></Demo></DATA ><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束类型说明TransCode交易编号NOT NULLVARCHAR(4)1002Resp

9、onseCode响应码NOT NULLVARCHAR(4)成功： 0000失败： 0001ResponseMsg响应信息Date日期Time时间Tranlist流水号交易输入：代码名称IDType证件类型Name姓名IDNo证件号 -身份证TrmtNo诊疗卡卡号BankNumber借记卡卡号PosId终端号PassWd密码密文Magc2二磁道Magc3三磁道Demo备注交易输出：代码名称Demo备注/NOT NULLVARCHAR(4) 错误描叙NOT NULLVARCHAR(8)格式 -YYYMMDDNOT NULLVARCHAR(6)格式 - HHMISSNOT NULL变长格式 -交易唯

10、一 ID约束类型说明NOT NULL变长01 身份证NOT NULL变长NOT NULL变长NOT NULL变长NOT NULL变长约束类型说明3、解除绑定交易名称解除绑定银行输入诊疗卡号或诊疗卡账户去医院端进行查询，返回后上送诊疗卡调用说明号、诊疗卡账户、 验借记卡密码， 判断诊疗卡账户、 借记卡是否已绑定，再发送诊疗卡账户、借记卡号到医院，等待医院返还解除绑定信息。输入参数交易编号1003<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></

11、ResponseCode >< ResponseMsg ></ ResponseMsg >交易输入xml< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time > </HEAD><DA TA >< Name ></ Name >/<IDType></ IDType >< IDNo ></ IDNo > <BankNumber>&

12、lt;/BankNumber>< TrmtNo ></ TrmtNo >< PosId ></ PosId> <PassWd></ PassWd> <Magc2></ Magc2> <Magc3></ Magc3> <Demo></Demo></DATA ><UTILITYPAYMENT>输出参数<UTILITYPAYMENT>< HEAD>< TransCode ></ Tran

13、sCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >交易输出xml< Date ></ Date >< Time ></ Time > </HEAD><DA TA > <Demo></Demo></DATA ><UTILITYPAYMENT>参数详细说明 :交易

14、头 ：代码名称约束类型TransCode交易编号NOT NULLVARCHAR(4)ResponseCode响应码NOT NULLVARCHAR(4)ResponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)Time时间NOT NULLVARCHAR(6)Tranlist流水号NOT NULL变长交易输入：代码名称约束类型IDType证件类型NOT NULL变长说明1003成功： 0000失败： 0001错误描叙格式 -YYYMMDD格式 - HHMISS格式 -交易唯一ID说明1 身份证/Name姓名NOT NULL变长IDNo证件号

15、-身份证NOT NULL变长TrmtNo诊疗卡卡号NOT NULL变长BankNumber借记卡卡号NOT NULL变长PosId终端号PassWd密码密文Magc2二磁道Magc3三磁道Demo备注交易输出：代码名称约束类型说明Demo备注变长4、充值交易名称充值将交行银行卡资金转入医院诊疗卡中调用说明输入参数交易编号1004<UTILITYPAYMENT>交易输入xml< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< Resp

16、onseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA >< Name ></ Name > <IDType></ IDType >< IDNo ></ IDNo ><BankNumber></BankNumber><TrmtNo><

17、;/TrmtNo>< PosId ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3><Amt></Amt>/<Demo></Demo></DATA ><UTILITYPAYMENT>输出参数<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< Resp

18、onseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >交易输出xml< Date ></ Date >< Time ></ Time > </HEAD><DA TA> <Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束类型TransCode交

19、易编号NOT NULLVARCHAR(4)ResponseCode响应码NOT NULLVARCHAR(4)ResponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)Time时间NOT NULLVARCHAR(6)Tranlist银行流水号（对账）NOT NULL变长交易输入：代码名称约束类型Name姓名必填变长IDType证件类型必填变长IDNo身份证必填变长BankNumber借记卡卡号必填变长TrmtNo诊疗卡卡号必填变长PosId终端号必填PassWd密码密文必填Magc2二磁道说明1004成功： 0000余额不足： 0001其他

20、错误： 0003格式 -YYYMMDD格式 - HHMISS格式 -交易唯一ID说明/Magc3三磁道Amt金额必填变长Demo备注变长交易输出：代码名称约束类型说明Demo备注5、退款交易名称调用说明输入参数交易编号交易输入xml输出参数交易输出xml退卡将医院诊疗卡中资金返回交行银行卡中。1005<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ Res

21、ponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA >< Name ></ Name > <IDType></ IDType >< IDNo ></ IDNo ><BankNumber></BankNumber><TrmtNo></TrmtNo>< PosI

22、d ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3><Amt></Amt><Demo></Demo></DATA ><UTILITYPAYMENT><UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >/< ResponseCode ></ Respon

23、seCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA><Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明:交易头 ：代码名称TransCode交易编号ResponseCode响应码ResponseMsg响应信息Date日期

24、Time时间TranlistHIS 流水号交易输入：代码名称TrmtNo诊疗卡卡号BankNumber借记卡卡号CardType联名卡标志PosId终端号Amt金额Demo备注交易输出：约束类型NOT NULLVARCHAR(4)NOT NULLVARCHAR(4)NOT NULLVARCHAR(4)NOT NULLVARCHAR(8)NOT NULLVARCHAR(6)NOT NULL变长约束类型必填变长必填变长必填必填必填变长变长说明1005成功： 0000失败： 0001格式 -YYYMMDD格式 - HHMISS格式 -交易唯一ID输入：医院端生成流水号银行必须保存流水号用于与医院 H

25、IS 对账输出：银行交易流水号。说明退卡时，请告知诊疗卡是否为交行联名卡，联名卡无需邦定即可退款。（ 0- 否， 1- 是）帐务交易统一添加/代码名称约束类型说明Demo备注6、验密交易名称调用说明输入参数交易编号交易输入xml输出参数交易输出xml退卡校验银行卡密码、账户状态1006<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg

26、 >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA >< Name ></ Name > <IDType></ IDType >< IDNo ></ IDNo > <BankNumber></BankNumber> <TrmtNo></TrmtNo>< PosId >

27、</ PosId> <PassWd></ PassWd> <Magc2></ Magc2> <Magc3></ Magc3> <Demo></Demo></DATA ><UTILITYPAYMENT><UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMs

28、g ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >/< Time ></ Time > </HEAD><DA TA> <Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束类型TransCode交易编号NOT NULLVARCHAR(4)ResponseCode响应码NOT NULLVARCHAR(4)Res

29、ponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)Time时间NOT NULLVARCHAR(6)Tranlist流水号交易输入：代码名称约束类型TrmtNo诊疗卡卡号必填变长BankNumber借记卡卡号必填变长PassWd密码密文必填Demo备注变长交易输出：代码名称约束类型Demo备注说明1006成功： 0000密码错误： 0001卡状态异常：0002格式 -YYYMMDD格式 - HHMISS说明说明7、激活联名卡交易名称退卡银行柜台激活联名卡调用说明第一次建卡时调用该接口，挂失卡补卡时再次调用该接口身份证为诊疗卡号银行卡号为校

30、验码，挂失时更新校验码输入参数交易编号1007/交易输入xml输出参数交易输出xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time >&

31、lt;/HEAD><DA TA ><TrmtNo></TrmtNo><SecrityNo></SecrityNo>< Name ></ Name > <Sex></Sex><Birthday></Birthday><Age></Age><BankNumber></BankNumber><Address></Address><Tel></Tel><IDType

32、></ IDType >< IDNo ></ IDNo >< PosId ></ PosId> <Demo></Demo></DATA ><UTILITYPAYMENT><UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg

33、>< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DA TA><Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明:交易头 ：代码名称约束类型说明/TransCode交易编号ResponseCode响应码ResponseMsg响应信息Date日期Time时间Tranlist流水号交易输入：代码名称TrmtNo诊疗卡号Secrity

34、No卡片唯一序列号Name姓名Sex性别Birthday出生日期Age年龄Address家庭地址Tel电话IDType证件类型NOTVARCHAR(4)NULLNOTVARCHAR(4)NULLNOTVARCHAR(4)NULLNOTVARCHAR(8)NULLNOTVARCHAR(6)NULL约束类型必填必填必填必填必填必填1006成功： 0000失败： 0001格式YYY-MM-DD格式-HH：MI：SS说明建卡成功后重新返回诊疗卡号，需重新更新该卡的诊疗卡号用做检验证处理，补卡时更新该号YYY-MM-DD01 身份证 02 其他IDNo证件号PosId设备号 -窗口号BankNumber银行卡号Demo备注交易输出：代码名称Demo备注变长约束类型说明/8、银行交易冲正交易名称退卡银行转医交易时HIS 端充值失败系统自动往银行冲正该笔交易调用说明输入参数交易编号1008交易输入xml输出参数交易输出xml参数详细说明:<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< Respon