境内外币支付系统直联接口API使用手册.docVIP

附件一：境内外币支付系统直联接口API使用手册 境内外币支付系统 直联接口API使用手册 V1.4 中国人民银行科技司 二〇〇八年四月 目录 1 编写目的 4 2 适用对象 4 3 支持平台及中间件 4 4 使用说明 4 4.1 外币业务流程说明 4 4.2 直联行往帐发起流程说明 5 4.3 往账发送处理流程图 6 4.4 直联行来帐接收流程说明 6 4.5 来账接收（普通报文）流程图 7 4.6 来账接收（实时报文）流程 8 4.7 限定和约束 8 5 直联接口API函数说明（C语言版本） 8 5.1 API函数清单 8 5.2 API函数说明 9 5.2.1 发送报文函数 9 5.2.2 接收报文函数 9 5.2.3 提交事务函数 10 5.2.4 回滚事务函数 10 5.2.5 获得错误代码及描述函数 11 6 安装过程 13 6.1 安装准备 13 6.2 安装步骤 13 6.3 安装验证 14 7 开发环境说明 15 7.1 头文件 15 7.2 编译方法 15 7.3 makefile文件示例 16 7.3.1 AIX平台的makefile 16 7.3.2 SUSE Linux平台makefile 17 8 运行环境说明 19 8.1 目录结构 19 8.2 配置文件 21 8.3 环境变量 21 8.4 AIX平台动态库文件 22 8.4.1 库文件清单 22 8.4.2 操作步骤 22 8.5 SUSE Linux平台 22 8.5.1 库文件清单 22 8.5.2 操作步骤 22 8.6 签名串文件*.dat生成过程 23 版本修改记录： 版本号 完成日期 简单描述 1.0 2007-12-25 [C]正式发布版。 1.1 2008-1-9 无修改。 1.2 2008-1-29 [M]6.3节安装验证内容更新。 [M]8.1节目录结构内容更新。 [A]增加8.6节签名串文件生成过程。 1.3 2008-3-31 [M]5.2.5获取错误代码及描述函数的表格中增加错误码及描述：0243优先级子块错误 和0242打开PKIBANK文件错误 1.4 2008-4-18 未修改 说明：[C]-创建；[M]-修改；[A]-增加；[D]-删除； 编写目的 本文档是《境内外币支付系统与结算银行账户处理系统接口规范》和《境内外币支付系统与商业银行行内系统接口规范》的附件，主要描述了直联接口API的使用方法。目的是指导结算银行和商业银行的开发人员依据此手册完成接入境内外币支付系统行内部分的系统改造工作。 本接口规范的期望读者包括：结算银行和商业银行的技术开发人员及其他相关人员。本TongLink/Q6.3 说明：AIX平台的接口API 连接32 bit 中间件MQ库。 使用说明 为了方便Q-Q直联方式接入的直接（特许）参与者发起和接收外币支付系统业务报文，并为了提高系统安全性，特提供直联接口API函数完成报文的发送和接收功能。该API完成了对操作消息中间件的封装，并对报文进行了初步的合法性检查，且增加了报文的身份验证码，由境内外币支付系统业务处理中心（FXCC）验证身份码的合法性，对非通过接口API发送的往帐报文予以拒绝。 直联行通过消息中间件接入外币支付系统的FXCC，直联行通过调用API发起和接收外币业务报文。 外币业务流程说明 假如直联行A向直联行B发起一笔境内跨行贷记业务（FMT100）报文。如下图所示： A行发起：A行组织好业务报文，先调用加签名函数生成签名串附加在报文中的第六块，再调用接口API发送报文函数对报文进行合法性检查、加身份验证码并放入发送队列，更加详细的报文格式请参照《境内外币支付系统报文格式标准》。 FXCC验证：FXCC从队列中得到A行发起的报文FMT100，进行身份验证（校验第7块：身份验证码），验证失败，直接丢弃报文，验证通过进行后续业务处理并转发该报文到报文接收行B行的接收队列。 B行接收：B行调用API接收函数，从接收队列得到报文串，并进行身份验证（校验第7块：身份验证码），并返回行内系统应用验证结果，验证失败则丢弃报文，验证成功的继续调用核签函数进行核签，根据核签结果做后续处理。 说明：图中黄色标识模块为接口API需要完成的工作。 直联行往帐发起流程说明 发起方（发起行行内系统）根据要求组织相应报文串并加数字签名后得到待发送的报文串（报文串包括：{1:基本头}{2:应用头}{3:用户头}{4:正文}{5:附加正文}{6:签名}）。 发起方调用[API：发送报文函数] CFXPS_SENDMSG(const char *pSendMsg);完成将待发送的报文进行合法性检查、加身份验证码（添加身份验证码后的报文串包括：{1:基本头}{2:应用头}{3:用户头}{4:正文