文档之家本文档是《境外里币付出编制与结算银行账户收拾编制接口典型》和《境外里币付出编制与贸易银行行内编制接口典型》的附件,首要刻画了直联接口API的运用伎俩。目标是引导结算银行和贸易银行的拓荒职员依照此手册实行接入境外里币付出编制行内一面的编制改制就业。
本接口典型的渴望读者包含:结算银行和贸易银行的技巧拓荒职员及其他联系职员。
本接口API只实用于扫数Q-Q直联形式接入境外里币付出编制的直接(特许)出席者运用。3增援平台及中心件
为了利便Q-Q直联形式接入的直接(特许)出席者倡始和汲取外币付出编制营业报文,并为了提升编制安适性,特供给直联接口API函数实行报文的发送和汲取功用。该API实行了对操作动静中心件的封装,并对报文举行了发端的合法性反省,且增长了报文的身份验证码,由境外里币付出编制营业收拾核心(FXCC)验证身份码的合法性,对非通过接口API发送的往帐报文予以拒绝。
直联行通过动静中心件接入外币付出编制的FXCC,直联行通过挪用API倡始和汲取外币营业报文。
倘使直联行A向直联行B倡始一笔境内跨行贷记营业(FMT100)报文。如下图所示:
1、A行倡始:A行机合好营业报文,先挪用加签字函数天生签字串附加正在报文中的第
六块,再挪用接口API发送报文函数对报文举行合法性反省、加身份验证码并放入
2、FXCC验证:FXCC从队伍中获得A行倡始的报文FMT100,举行身份验证(校验
第7块:身份验证码),验证曲折,直接抛弃报文,验证通过举行后续营业收拾并转
3、B行汲取:B行挪用API汲取函数,从汲取队伍获得报文串,并举行身份验证(校
验第7块:身份验证码),并返回行内编制使用验证结果,验证曲折则抛弃报文,验
1、倡始方(倡始行行内编制)按照条件机合相应报文串并加数字签字后获得待发送的报文串(报
报文举行合法性反省、加身份验证码(增添身份验证码后的报文串包含:{1:根本头}{2:使用头}{3:用户头}{4:正文}{5:附加正文}{6:签字}{7:身份验证串})和放入发送队伍,按照返回码做相应收拾:发送报文曲折转4,并挪用5获取过失码,得胜则转3一直收拾。
送正直在发送报文返回值不等于0(即发送曲折),挪用该函数获取过失码及过失刻画,以便说明曲折的出处。
1、汲取方(汲取行行内编制)需求汲取及时来帐报文时挪用[API:汲取报文函数] long
CFXPS_RECVMSG(int nMsgType, char **ppRecvMsg)从中心件秩序得到一笔待汲取的及时来账报文(入参nMsgType=‘0’时透露汲取及时来账),取报文得胜并对报文举行合法性反省和身份验证通过,则返回汲取报文实践长度(返回值)和汲取报文串的地点(ppRecvMsg)(返回报文机合为{1:根本头}{2:使用头}{3:用户头}{4:正文}{5:附加正文}{6:签字})并转4,不然一直。
2、汲取方(汲取行行内编制)需求汲取普及来帐报文时挪用[API:汲取报文函数] long
账报文(入参nMsgType=‘1’时透露汲取普及来账),取报文得胜并对报文举行合法性反省和身份验证通过,则返回汲取报文实践长度和汲取报文串(ppRecvMsg)({1:根本头}{2:使用头}{3:用户头}{4:正文}{5:附加正文}{6:签字})并转4,不然一直。
3、倘若汲取报文曲折(返回值小于0),则转5,并挪用6获取过失码,依照过失码刻画说明出处。
1、本API仍然封装了中心件产物MQ和TLQ的操作函数,无需贸易银行直接操作MQ和
2、发送或汲取API报文巨细有条款拘束,报文的巨细最大不行赶上50M。对1M以下的报
文编制直接收拾,看待1M以上,50M以下的报文,采用了MQ/TLQ的编制分片功用主动分片,默认装备的分片巨细为1M。能够挪用API直接举行发送,由MQ/TLQ编制本身判定超长并主动分片;汲取方能够直接挪用API举行大报文的汲取,API会返回拼装好的大报文给行内编制使用。汲取API函数内部申请存储区获取到报文后,将存储区的地点(char **ppRecvMsg)返回给贸易银行,贸易银行使用能够直接读取该存储区的报文讯息,但注视不行粉碎此存储区实质。
4、本API增援众过程挪用,暂不增援众线直联接口API函数分析(C讲话版本)
无,周密过失码和过失刻画请顷刻挪用CFXPS_GETERRDESC()函数获取。
贸易银行使用需求发送往帐报文时运用,对需求加数字签字的报文应当加好数字签字后才挪用此函数举行发送。
[参数2]:ppRecvMsg(输出)--输出报文存放的存储区的地点,界说为指针的指针。
无,周密过失码和过失刻画请顷刻挪用CFXPS_GETERRDESC()函数获取。
3、此函数内部申请存储区并将获取到的报文存入此存储区,并将存储区的地点(char
**ppRecvMsg)返回给贸易银行,贸易银行使用序次能够直接读取该存储区的报文讯息,但注视不行粉碎此存储区实质。
平常景况下应返回得胜,倘若返回曲折,则是队伍照料器涌现卓殊,请反省MQ6.0/TLQ6.3运转景况。
平常景况下应返回得胜,倘若返回曲折,则是队伍照料器涌现卓殊,请反省MQ6.0/TLQ运转景况。
此函数实行发送报文函数和汲取报文函数的返回值小于0时,挪用该函数获取过失代码及刻画,按照过失码及刻画说明出处。
此函数用于获取周密的操作过失码和过失刻画,应当正在挪用以上四个函数的任何一个后,如涌现过失,应顷刻挪用此函数获取周密过失码和过失刻画。
1.正在运用静态或动态库时,正在用户的工程中包罗cfxpsapi.hpp的头文献。