招商银行嵌入式银企直联开发指南v2.0

《招商银行嵌入式银企直联开发指南v2.0》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、招商银行嵌入式银企直联开发指南version2.0修订记录日期修订版本修订人修订内容2014-1-82.0徐蓓文档内容摘自招商银行银企直联开发指南2.0.8。目录1开发概述21.1概述21.2数据格式21.3接口返回值32多线程调用42.1概述42.2调用方法42.3调用说明42.4术语定义53编程接口53.1XML请求(XmlComm)53.2系统函数63.2.1Login63.2.2Logout73.2.3SetConfig83.2.4GetNewNotice83.2.5GetSysInfo103.2.6ListMode113.2.7SetAlive113.2.8FreeBuf

2、fer133.3账户信息143.3.1ListAccount143.3.2GetAccInfo153.3.3GetAccInfoA153.3.4GetTransInfo173.3.5GetTransInfoA183.4支付结算193.4.1Payment193.4.2GetPaymentInfo213.4.3DirectPayment233.4.4DirectGroupPayment243.5代发代扣243.5.1QueryAgentList243.5.2AgentRequest253.5.3GetAgentInfo273.5.4GetAgentDetail293.6商务支付303

3、.6.1GetOrderStatus303.6.2VerifySignature323.7其他接口331开发概述1.1概述本系统提供了两种编程接口：·C编程接口（用int__stdcall定义）·JAVA编程接口（用publicSdkResult定义）所有编程接口都由本系统的FBSDK.dll文件提供，请确保您的系统正确加载了此文件。对JAVA开发还提供了fbsdk.jar文件，编程接口封装在类FbSdkJni中，返回结果封装在类SdkResult中企业向招行提交的指令数据要求、招行向企业返回数据的定义等请参考《招商银行银企直联接口说明书》。1.2数据格式调用本系统编程接口时，传入

4、的指令和返回的结果，一般采用以下的数据格式：·以''结束；·支持多条记录，每条记录用"r"分开（"r"是指回车符和换行符）；·每条记录由多个字段组成，字段间用";"(空格加分号)分开，各个字段格式为：字段名=数值；·字段之间没有顺序关系；·如果某个字段对应的数值为空，则该字段可以省略；·字段如果对应日期，格式为：yyyymmdd；对应时间，格式为：hhmmss；对应日期+时间，格式为：yyyymmddhhmmss；·字段如果对应金额，格式为：nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分最多2位。1.1接口返回值·C编程接口采用统一的返回编码（整数）

5、： 0：成功；-1：提交主机失败；-2：执行失败；-3：数据格式错误；-4：尚未登录系统；-5：请求太频繁；-6：不是证书卡用户；-7：用户取消操作；-9：其它错误；当返回编码不是0时，函数参数中的szErrorMsg有效，表示具体错误信息（字符串szErrorMsg以''结束）。当返回编码不是0时，可通过SetAlive函数来判断和银行服务器的连接是否出现错误。·Java编程接口返回结果封装在类SdkResult中。下面是类SdkResult接口函数的说明：//判断接口调用是否有正确（true：正确；false：错误）publicbooleanisError();//获得错误

6、ID（编码和C编程接口一致）//判断错误ID是否为0，等同于调用isError();publicintgetErrorID();//获得错误信息publicStringgetErrorMessage();//获得返回结果数据publicStringgetData();1多线程调用1.1概述1.3.0.0以前的版本已经支持多线程调用，但只允许登录一个用户，所有线程都共用该用户的身份进行业务处理。为了支持多个用户登录，不同用户可以各自进行自己的业务处理，1.3.0.0及以后的版本对多线程的支持进行了改进。如果您的系统使用了多线程，请务必仔细阅读本文。1.2调用方法·单用户单线程（只登录

7、一个用户，所有接口调用都在一个线程里完成）"主登录"后，直接调用所需接口，不需要任何特别处理·单用户多线程（只登录一个用户，多个线程进行接口调用）在一个线程中进行"主登录"；如：Login("",0,szErrorMsg);登录后通过GetSysInfo取得用户登录名；如：假设这里取到的用户登录名为SH01在其它线程进行"线程登录"，实现该用户的共享连接；如Login("LGNTYP=-2;LGNNAM=SH01",0,szErrorMsg);登录后，各个线程调用各自