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

招商银行嵌入式银企直联开发指南 version 2.0 修订记录 日期 修订版本 修订人 修订内容 2014-1-8 2.0 徐蓓 文档内容摘自招商银行银企直联开发指南2.0.8。 目录 1 开发概述 2 1.1 概述 2 1.2 数据格式 2 1.3 接口返回值 3 2 多线程调用 4 2.1 概述 4 2.2 调用方法 4 2.3 调用说明 4 2.4 术语定义 5 3 编程接口 5 3.1 XML请求(XmlComm) 5 3.2 系统函数 6 3.2.1 Login 6 3.2.2 Logout 7 3.2.3 SetConfig 8 3.2.4 GetNewNotice 8 3.2.5 GetSysInfo 10 3.2.6 ListMode 11 3.2.7 SetAlive 11 3.2.8 FreeBuffer 13 3.3 账户信息 14 3.3.1 ListAccount 14 3.3.2 GetAccInfo 15 3.3.3 GetAccInfoA 15 3.3.4 GetTransInfo 17 3.3.5 GetTransInfoA 18 3.4 支付结算 19 3.4.1 Payment 19 3.4.2 GetPaymentInfo 21 3.4.3 DirectPayment 23 3.4.4 DirectGroupPayment 24 3.5 代发代扣 24 3.5.1 QueryAgentList 24 3.5.2 AgentRequest 25 3.5.3 GetAgentInfo 27 3.5.4 GetAgentDetail 29 3.6 商务支付 30 3.6.1 GetOrderStatus 30 3.6.2 VerifySignature 32 3.7 其他接口 33 开发概述 概述 本系统提供了两种编程接口： C编程接口（用int __stdcall定义） JAVA编程接口（用public SdkResult定义） 所有编程接口都由本系统的FBSDK.dll文件提供，请确保您的系统正确加载了此文件。 对JAVA开发还提供了fbsdk.jar文件，编程接口封装在类FbSdkJni中，返回结果封装在类SdkResult中 企业向招行提交的指令数据要求、招行向企业返回数据的定义等请参考《》。 数据格式 调用本系统编程接口时，传入的指令和返回的结果，一般采用以下的数据格式： 以\0结束； 支持多条记录，每条记录用\r\n分开（\r\n是指回车符和换行符）； 每条记录由多个字段组成，字段间用 ;(空格加分号)分开，各个字段格式为：字段名=数值； 字段之间没有顺序关系； 如果某个字段对应的数值为空，则该字段可以省略； 字段如果对应日期，格式为：yyyymmdd；对应时间，格式为：hhmmss；对应日期+时间，格式为：yyyymmddhhmmss； 字段如果对应金额，格式为：nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分最多2位。 接口返回值 C编程接口采用统一的返回编码（整数）：?0：成功；-1：提交主机失败；-2：执行失败；-3：数据格式错误；-4：尚未登录系统；-5：请求太频繁；-6：不是证书卡用户；-7：用户取消操作；-9：其它错误；当返回编码不是0时，函数参数中的szErrorMsg有效，表示具体错误信息（字符串szErrorMsg以\0结束）。当返回编码不是0时，可通过SetAlive函数来判断和银行服务器的连接是否出现错误。 Java编程接口返回结果封装在类SdkResult中。下面是类SdkResult接口函数的说明： // 判断接口调用是否有正确（true：正确；false：错误） public boolean isError(); // 获得错误ID（编码和C编程接口一致） // 判断错误ID是否为0，等同于调用isError(); public int getErrorID(); // 获得错误信息 public String getErrorMessage(); // 获得返回结果数据 public String getData(); 多线程调用概述 1.3.0.0以前的版本已经支持多线程调用，但只允许登录一个用户，所有线程都共用该用户的身份进行业务处理。为了支持多个用户登录，不同用户可以各自进行自己的业务处理，1.3.0.0及以后的版本对多线程的支持进行了改进。 如果您的系统使用了多线程，请务必仔细阅读本文。调用方法 单用户单线程（只登录一个用户，所有接口调用都在一个线程里完成） 主登录后，直接调用所需接口，不需要任何特别处理 单用户多线程（只登录一个用户，多个线程进行接口调