FX Rate

December 27, 2021

货币转换是跨境支付场景中常见的操作，比如在 Credit Transfer 中，付款方机构（假设为美国某钱包A）和收款方机构（假设为泰国某钱包B）约定：

支付指令的币种为 THB（泰铢），假设指令金额为100泰铢，即付款人希望收款人收到100泰铢
实际交收的币种为 USD（美元）

那么，A在发出指令前需要先和B确认下实际需要交收的USD金额，此时A就需要事先向B进行询价，经过询价，B给出的汇率是：1 USD = 33.52 THB

那么A依据此汇率报价就可以计算出，需要实际结算给B 2.98 美元，那么 credit transfer 报文内的结算金额就填写 2.98 USD，同时附上汇率报价，这样B收到付款报文后就不会有任何的surprise，按照约定给收款人入账100泰铢，随后A交收给B 2.98 美元，交易顺利进行。

除此之外还有很多场景交易双方都会事先询价，所以 WalletsNet 就提供了一种非常简单的让交易对手方之间可以询价的流程：

询价方：发出 camt.016 询价报文，按照币种对询价
应答方：发出 camt.017 报价报文，回应询价方的请求

正常流程

实际报文流转的流程见下图：

camt.016 报文样例

camt.016 报文使用场景：

编号	发出方	收到方	备注
1	询价方	WalletsNet	提交询价请求
2	WalletsNet	对手方	转发询价请求

以下 camt.016 message sample 对应的场景为「编号-1」


xxxxxxxxxx
65
1
{
2
    "AppHdr": {
3
        "Fr": {
4
            "FIId": {
5
                "FinInstnId": {
6
                    "ClrSysMmbId": {
7
                        "MmbId": "XXXXXXXXXXXX"
8
                    }
9
                }
10
            }
11
        },
12
        "To": {
13
            "FIId": {
14
                "FinInstnId": {
15
                    "ClrSysMmbId": {
16
                        "MmbId": "WCSMHKHKXXX"
17
                    }
18
                }
19
            }
20
        },
21
        "BizMsgIdr": "B20211222WCSMHKHKXXXBPSP47328764473",
22
        "MsgDefIdr": "camt.016.001.04",
23
        "CreDt": "2021-12-22"
24
    },
25
    "Document": {
26
        "GetCcyXchgRate": {
27
            "MsgHdr": {
28
                "MsgId": "B20211222WCSMHKHKXXXBPSP47328764473",
29
                "CreDtTm": "2021-12-22T15:27:07.525944+08:00"
30
            },
31
            "CcyQryDef": {
32
                "NewCrit": {
33
                    "SchCrit": {
34
                        "SrcCcy": "USD",    // 原始币种, Currency of the amount to be converted in a currency conversion.
35
                        "TrgtCcy": "THB",    // 目标币种, Currency into which an amount is to be converted in a currency conversion.
36
                    }
37
                }
38
            },
39
            "SplmtryData": {
40
                "Envlp": {
41
                    "OrgtrRef": "M20211222ZRMTSDHHXXXHNET66564696970", // 查询ID
42
                    "TradgSdId": {
43
                        "FIId": {
44
                            "FinInstnId": {
45
                                "ClrSysMmbId": {
46
                                    "MmbId": "XXXXXXXXXXXX"  // 消息发送方
47
                                }
48
                            }
49
                        }
50
                    },
51
                    "CtrPtySdId": {
52
                        "FIId": {
53
                            "FinInstnId": {
54
                                "ClrSysMmbId": {
55
                                    "MmbId": "YYYYYYYYYYY" // 消息接收方
56
                                }
57
                            }
58
                        }
59
                    }
60
                }
61
            }
62
        }
63
    }
64
}
65

camt.017 报文样例

camt.017 报文使用场景：

编号	发出方	收到方	备注
1	对手方	WalletsNet	应答询价
2	WalletsNet	询价方	转发应答询价

以下 camt.017 message sample 对应的场景为「编号-1」


xxxxxxxxxx
72
1
{
2
    "AppHdr": {
3
        "Fr": {
4
            "FIId": {
5
                "FinInstnId": {
6
                    "ClrSysMmbId": {
7
                        "MmbId": "WCSMHKHKXXX"
8
                    }
9
                }
10
            }
11
        },
12
        "To": {
13
            "FIId": {
14
                "FinInstnId": {
15
                    "ClrSysMmbId": {
16
                        "MmbId": "XXXXXXXXXXXX"
17
                    }
18
                }
19
            }
20
        },
21
        "BizMsgIdr": "B20211222WCSMHKHKXXXBPSP14563028439",
22
        "MsgDefIdr": "camt.017.001.05",
23
        "CreDt": "2021-12-22"
24
    },
25
    "Document": {
26
        "RtrCcyXchgRate": {
27
            "MsgHdr": {
28
                "MsgId": "B20211222WCSMHKHKXXXBPSP14563028439",
29
                "CreDtTm": "2021-12-22T15:27:07.618563+08:00"
30
            },
31
            "RptOrErr": {
32
                "CcyXchgRpt": {
33
                    "CcyRef": {
34
                        "SrcCcy": "USD", // 原始币种
35
                        "TrgtCcy": "THB" // 目标币种
36
                    },
37
                    "CcyXchgOrErr": {
38
                        "CcyXchg": {
39
                            "XchgRate": "33.5346", // 汇率, 代表 1 USD = 33.5346 THB
40
                            "QtdCcy": "THB",   // 目标币种
41
                            "QtnDt": "2021-12-22 " // 汇率日期， 不代表这个汇率当日都有效，当日的汇率也有可能变动
42
                        }
43
                    }
44
                }
45
            },
46
            "SplmtryData": {
47
                "Envlp": {
48
                    "OrgtrRef": "M20211222ZRMTSDHHXXXHNET66564696970", // 查询ID, 需要与所回复camt.016消息内的OrgtrRef相同 
49
                    "TradgSdId": {
50
                        "FIId": {
51
                            "FinInstnId": {
52
                                "ClrSysMmbId": {
53
                                    "MmbId": "YYYYYYYYYYY" // 消息发送方
54
                                }
55
                            }
56
                        }
57
                    },
58
                    "CtrPtySdId": {
59
                        "FIId": {
60
                            "FinInstnId": {
61
                                "ClrSysMmbId": {
62
                                    "MmbId": "XXXXXXXXXXXX" // 消息接收方
63
                                }
64
                            }
65
                        }
66
                    }
67
                }
68
            }
69
        }
70
    }
71
}
72