银行接口协议

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

2、 Date >< Time ></ Time ></HEAD><DATA>< PosId ></ PosId >< Demo ></ Demo > <MerchNo></ MerchNo> </DATA><UTILITYPAYMENT>输出参数交易输出 xml<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 e响应码NOT NULLVARCHAR(4)成功： 0000失败： 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交易输入 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg &

6、gt;</ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< Name ></ Name ><IDType></ IDType >< IDNo ></ IDNo >< TrmtNo ></ TrmtNo > <BankNumber></BankNumb

7、er>< PosId ></ PosId> <PassWd></ PassWd> <Magc2></ Magc2> <Magc3></ Magc3> <Demo></Demo></DATA ><UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></

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

9、1002ResponseCode响应码NOT NULLVARCHAR(4)成功： 0000失败： 0001ResponseMsg响应信息NOT NULLVARCHAR(4)错误描叙Date日期NOT NULLVARCHAR(8)格式 -YYYMMDDTime时间NOT NULLVARCHAR(6)格式 - HHMISSTranlist流水号NOT NULL变长格式 - 交易唯一 ID交易输入：代码名称约束类型说明IDType证件类型NOT NULL变长01 身份证Name姓名NOT NULL变长IDNo证件号 - 身份证NOT NULL变长TrmtNo诊疗卡卡号NOT NULL变长BankNu

10、mber借记卡卡号NOT NULL变长PosId终端号PassWd密码密文Magc2二磁道Magc3三磁道Demo备注交易输出：代码名称约束类型说明Demo备注3、解除绑定交易名称解除绑定调用说明银行输入诊疗卡号或诊疗卡账户去医院端进行查询， 返回后上送诊疗卡 号、诊疗卡账户、 验借记卡密码， 判断诊疗卡账户、 借记卡是否已绑定， 再发送诊疗卡账户、借记卡号到医院，等待医院返还解除绑定信息。输入参数交易编号1003交易输入 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< Resp

11、onseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< Name ></ Name ><IDType></ IDType >< IDNo ></ IDNo ><BankNum

12、ber></BankNumber>< TrmtNo ></ TrmtNo > < PosId ></ PosId> <PassWd></ PassWd> <Magc2></ Magc2> <Magc3></ Magc3> <Demo></Demo> </DATA > <UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< Trans

13、Code ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA ><Demo></Demo></DATA ><UTILITYPAYMENT>参

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

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

16、>< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< Name ></ Name ><IDType></ IDType >< IDNo ></ IDNo > <BankNumber></BankNumber> <

17、TrmtNo></TrmtNo>< PosId ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3><Amt></Amt> <Demo></Demo></DATA ><UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ Tr

18、ansCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA> <Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束

19、类型说明TransCode交易编号NOT NULLVARCHAR(4)1004ResponseCod e响应码NOT NULLVARCHAR(4)成功： 0000余额不足： 0001其他错误： 0003ResponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)格式 -YYYMMDDTime时间NOT NULLVARCHAR(6)格式 - HHMISSTranlist银行流水号（对账）NOT NULL变长格式 - 交易唯一 ID交易输入：代码名称约束类型说明Name姓名必填变长IDType证件类型必填变长IDNo身份证必填变长BankNum

20、ber借记卡卡号必填变长TrmtNo诊疗卡卡号必填变长PosId终端号必填PassWd密码密文必填Magc2二磁道Magc3三磁道Amt金额必填变长Demo备注变长交易输出：代码名称约束类型说明Demo备注5、退款交易名称退卡调用说明将医院诊疗卡中资金返回交行银行卡中。输入参数交易编号1005交易输入 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></

21、 ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< Name ></ Name ><IDType></ IDType >< IDNo ></ IDNo > <BankNumber></BankNumber> <TrmtNo></TrmtNo><

22、PosId ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3><Amt></Amt> <Demo></Demo></DATA ><UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode

23、></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time > </HEAD> <DATA><Demo></Demo> </DATA><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束类型说明TransCode交易编号NOT NULLVAR

24、CHAR(4)1005ResponseCod e响应码NOT NULLVARCHAR(4)成功： 0000失败： 0001ResponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)格式 -YYYMMDDTime时间NOT NULLVARCHAR(6)格式 - HHMISSTranlistHIS 流水号NOT NULL变长格式 - 交易唯一 ID 输入：医院端生成流 水号 银行必须保存流水号 用于与医院 HIS 对账 输出：银行交易流水 号。交易输入：代码名称约束类型说明TrmtNo诊疗卡卡号必填变长BankNumber借记卡卡号必填变长C

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

26、gt;</ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA >< Name ></ Name ><IDType></ IDType >< IDNo ></ IDNo > <BankNumber></BankNumber> <TrmtNo></TrmtNo&

27、gt;< PosId ></ PosId><PassWd></ PassWd><Magc2></ Magc2><Magc3></ Magc3> <Demo></Demo></DATA ><UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ Respo

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

29、nseCod e响应码NOT NULLVARCHAR(4)成功： 0000密码错误： 0001 卡状态异常： 0002ResponseMsg响应信息NOT NULLVARCHAR(4)Date日期NOT NULLVARCHAR(8)格式 -YYYMMDDTime时间NOT NULLVARCHAR(6)格式 - HHMISSTranlist流水号交易输入：代码名称约束类型说明TrmtNo诊疗卡卡号必填变长BankNumber借记卡卡号必填变长PassWd密码密文必填Demo备注变长交易输出：代码名称约束类型说明Demo备注7、激活联名卡交易名称退卡调用说明银行柜台激活联名卡 第一次建卡时调用该接

30、口，挂失卡补卡时再次调用该接口 身份证为诊疗卡号 银行卡号为校验码，挂失时更新校验码输入参数交易编号1007交易输入 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< ResponseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time

31、></ Time ></HEAD><DATA ><TrmtNo></TrmtNo><SecrityNo></SecrityNo>< Name ></ Name ><Sex></Sex><Birthday></Birthday><Age></Age><BankNumber></BankNumber><Address></Address><Tel><

32、/Tel><IDType></ IDType >< IDNo ></ IDNo >< PosId ></ PosId><Demo></Demo></DATA ><UTILITYPAYMENT>输出参数交易输出 xml<UTILITYPAYMENT>< HEAD>< TransCode ></ TransCode >< ResponseCode ></ ResponseCode >< Respo

33、nseMsg ></ ResponseMsg >< Tranlist ></ Tranlist >< Date ></ Date >< Time ></ Time ></HEAD><DATA> <Demo></Demo></DATA><UTILITYPAYMENT>参数详细说明 :交易头 ：代码名称约束类型说明TransCode交易编号NOTVARCHAR(4)1006NULLResponseCod e响应码NOTNULLVARCHA

34、R(4)成功： 0000失败： 0001ResponseMsg响应信息NOTNULLVARCHAR(4)Date日期NOTNULLVARCHAR(8)格式 YYY-MM-DDTime时间NOTNULLVARCHAR(6)格式 - HH： MI： SSTranlist流水号交易输入：代码名称约束类型说明TrmtNo诊疗卡号必填建卡成功后重新 返回诊疗卡号， 需重新更新该卡 的诊疗卡号SecrityNo卡片唯一序列号必填用做检验证处 理，补卡时更新 该号Name姓名必填Sex性别必填Birthday出生日期必填YYY-MM-DDAge年龄必填Address家庭地址Tel电话IDType证件类型01 身份证 02 其 他IDNo证件号PosId设备号 - 窗口号BankNumber银行卡号Demo备注变长交易输出：代码名称约束类型说明Demo备注8、银行交易冲正交易名称退卡调用说明银行转医交易时 HIS 端充值失败系统自动往银行冲正该笔交易输入参数交易编号1008交易输入 xml<UTILITYPAYMENT>< HEAD>< Tra