wcb-blog-3

Get start your first credit transfer transaction

如果你还不太了解 Participant Account、Settlement Account、Connection、Transceiver 这四个概念,强烈建议你先看一下上一篇文章 —— Key components of WalletsNet

如果你还没有 WalletsNet 的账号?没关系,点击这里注册:https://portal.walletsclub.com/portal-users/register

如果你已经有账号并且了解了上面的“四件套”了,那就太棒了,我们今天就介绍一下如何在 WalletsNet 上跑出第一笔 Credit Transfer 交易。

现在,相信你已经有了以下几个参数:

Credit Transfer 是什么?

什么是 Credit transfer 呢?Credit transfer: A credit transfer is an electronic payment from one account to another。简单说就是将资金从一个账户中转移到另一个账户中,ISO20022 为 Credit transfer 定义了一整套完整的流程,我们先看一下 Credit transfer 的 happy flow(也就是正常流程:

 

 

左边的图用自然语言描述了参与者和 WalletsNet 之间的通讯报文的含义,右边的图就是报文的具体名称和编号,Credit transfer 的交易流程还是非常容易理解的,对吧?

图中,我们用绿色圆圈标注了作为付款方机构需要收&发的报文,用红色圆圈标注了作为收款方机构需要收&发的报文,所以,如果:

所以,Credit transfer 流程主要就是要熟悉 pacs.008 和 pacs.002 这两个报文。

与 WalletsNet 通讯的所有的报文(即 HTTP POST 的)都遵循这样的一个基本结构:

想要了解报文的具体详情,请参考 WalletsNet 的文档:点击查看文档

接下来,我们就按照报文的流程,一步一步的看报文是如何流转的

第一步,付款方发起付款指令

付款方首先需要向 WalletsNet发送一个 pacs.008 指令报文,来触发 Credit transfer的流程,即上图中「绿色1」,以下为一个简化版的示例:

这就是一个简化版的 pacs.008 报文消息,打包组装好这个消息之后,付款方机构就可以按照 WalletsNet 文档中描述的方法,用自己的私钥对数据进行加密,然后 POST 至 WalletsNet 平台上来。

第二步,WalletsNet 转发指令

WalletsNet 收到付款机构发来的报文后,会进行一系列的检查(如付款方机构的头寸是否足够),如果检查通过了,那么WalletsNet 会将报文转发给收款方机构,报文报文头会变成:

 

第三步,收款方机构处理报文

收到来自 WalletsNet 转发的 pacs.008 报文后,收款方机构对报文做一些列业务逻辑处理,如:

如果收款机构决定接受该笔交易,则需要向WalletsNet 返回 Positive 的 pacs.002 消息,下面是一个样例:

 

第四步,WalletsNet 处理交易

WalletsNet 处理收款机构发来的反馈报文(即pacs.002),如果:

第五步,双边机构处理交易

当双边机构收到最终的pacs.002报文后,付款方机构应立即 debit 付款人的账户,收款方机构应立即 credit 收款人的账户,此时从收款人&付款人的视角看来,一笔付款交易就已经完成了,付款人账户被扣款了,收款人账户被入款了。待结算窗口期时,WalletsNet 会为双边机构进行实际的资金交收(轧差),资金就会在结算行为双方机构开设的结算账户中划转,每次结算完成,收付双方机构都会收到标准且详细的结算报告(结算了多少钱、在哪里结算的、是因为哪些交易而发生的结算等等)。

完结

以上便是 credit transfer 的基本流程,当然了,有 happy flow,就一定会有 unhappy flow,异常的流程有很多种,这里就不一一介绍了,具体请看文档吧。

为了把 credit transfer 交易真实的跑通,开发者还是要写一些代码的,这个集成的过程相信很多开发者都经历过,说难不难,说容易也不容易,如何才能更快速的把交易流程跑通是所有开发者最关心的问题,因此,WalletsNet 为开发者准备了一个 CLI 工具,只需要从 WalletsNet 的 Dashboard 上面下载一个配置文件,无需写一行代码,就能把交易流程跑通,消息是如何生成的、如何加密的、如何流出的、如何流入的、如何解密的、如何反馈的,统统一网打尽。

下一节,我们将介绍本地集成开发的利器 —— WalletsNet CLI。