概覽
推送通知或 Webhook 允許您設定與 Currencycloud 的「通知」相對應的集成。
在下面的通知部分描述了一系列可在 Currencycloud 平台上觸發推送通知的事件。當其中一個事件被觸發時，我們會向 Webhook 的 URL 發送 HTTP POST 命令。這讓您能夠以更有效率的方式追蹤交易和狀態變更，並自動進行內部溝通或與客戶溝通。
安全性
我們希望您能確信通知來自 Currencycloud 且未被篡改。因此，我們在通知中附加了雜湊訊息鑑別碼 (HMAC)，讓您能夠驗證訊息的完整性。請參閱我們的訊息驗證常見問題以了解如何操作。
版本控制
2021 年 7 月，我們推出了版本控制 - 這讓我們能夠更快地向您提供變更，而不會出現破壞您的集成的風險。預設情況下，您會收到通知類型的最新版本。如果我們決定棄用某個版本，我們將通知您，並為您提供如何升級集成的指引。如果您對此有任何疑問，請聯絡您的解決方案經理。
自動重新發送功能
2021 年 7 月，我們還推出了自動重新發送功能。如果第一次傳送失敗，我們會自動嘗試再發送 5 次，嘗試之間的超時時間會呈指數增長，如下表所示：
1 秒
2 秒
4 秒
8 秒
16 秒
嘗試 5 次後，傳送將被標記為失敗。此時，在要求解決方案經理手動重新發送通知之前，不妨先檢查您的配置。
訊息標頭
請注意，我們有時可能會在通知中發送額外的標頭。
入門
當您準備好設置推送通知時，請聯絡您的解決方案經理。您需要為他們提供一個可以針對我們的演示和生產環境進行配置的端點。
通知和事件
以下實體和事件在 Currencycloud 平台上生成推送通知。這些事件可以單獨設定，以生成推送通知。
支付
下圖展示了支付在平台上的生命週期中所經歷的不同狀態。其中還突出顯示了哪些狀態會觸發推送通知。
兌換
下圖展示了兌換在平台上的生命週期中所經歷的不同狀態。圖中還描述了哪些狀態會觸發推送通知所涵蓋的事件。
轉賬
下圖展示了轉賬在平台上的生命週期中所經歷的不同狀態。圖中還描述了哪些狀態會觸發推送通知所涵蓋的事件。
注資交易
下圖展示了注資交易詳情。
註冊
下圖顯示了註冊表單的可能狀態，以及推送通知所涵蓋的狀態觸發事件。
銀行賬戶驗證
銀行賬戶驗證是 Currencycloud BV 客戶註冊過程中的額外步驟。完成驗證過程會觸發推送通知。
版本
版本 2021 02 01
在此版本中，我們已將標頭內容類型更新為 JSON。所有其他細節保持不變。
通知類型：準備發送通知
訊息標頭
Content-Length:681 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_ready_to_send_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "ready_to_send",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason": "",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
}
通知類型：支付釋放通知
訊息標頭
Content-Length:734 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_released_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "completed",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason": "",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
}
通知類型：支付失敗通知
訊息標頭
Content-Length:757 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_failed_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "failed",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason":"Test Fail",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
}
通知類型：支付合規性未通過
訊息標頭
Content-Length:743 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_compliance_failed_notification"
},
"body": {
"id": "ff13cd8a-d0b3-473c-a6e8-f68bc079aff8",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id":null,
"currency":"GBP",
"reference": "rrr",
"reason": "test",
"status": "failed",
"payment_type": "priority",
"payment_date":"2018-07-27T00:00:00+00:00",
"transferred_at": null,
"authorisation_steps_required":0,
"creator_contact_id": "eb5ecd81-f800-0132-a9c5-10b11cb33cfb",
"last_updater_contact_id": "eb5ecd81-f800-0132-a9c5-10b11cb33cfb",
"short_reference":"180727-GYJLVG001",
"failure_reason":"Compliance failed 1",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
}
通知類型：現金管理器交易通知
訊息標頭
Content-Length:932 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"cash_manager_trade_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"awaiting_funds",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"1.4078",
"core_rate":"1.4077",
"partner_rate":"",
"client_rate":"1.3795",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：資金到賬通知
訊息標頭
Content-Length:927 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"funds_arrived_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"funds_arrived",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":null,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：交易結算通知
訊息標頭
Content-Length:922 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"trade_settled_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"trade_settled",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：交易關閉通知
訊息標頭
Content-Length:924 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"trade_closed_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"closed",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：押金到賬通知
訊息標頭
Content-Length:955 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":
{
"message_type":"conversion",
"notification_type":"deposit_arrived_notification"
},
"body":
{
"id":"991e203b-5001-4cca-83f4-606e6543f6cd",
"account_id":"9658df0c-a7cd-d9c9-274a-4e81bdf5f64a",
"creator_contact_id":"a3180fae-4c77-6dfb-74b3-4f16d55d6d1d",
"short_reference":"20180514-TCNZVW",
"created_at":"2018-05-14T07:24:06+00:00",
"settlement_date":"2018-05-17T13:00:00+00:00",
"conversion_date":"2018-05-17T00:00:00+00:00",
"status":"awaiting_funds",
"currency_pair":"GBPUSD",
"buy_currency":"GBP",
"sell_currency":"USD",
"fixed_side":"buy",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"1500.00",
"client_sell_amount":"2115.90",
"mid_market_rate":"0.7092",
"core_rate":"0.7092",
"partner_rate":"",
"client_rate":"0.7089",
"deposit_required":true,
"deposit_amount":"63.48",
"deposit_currency":"USD",
"deposit_status":"deposit_received",
"deposit_required_at":"2018-05-16T13:00:00+00:00",
"payment_ids":[]
}
}
通知類型：轉賬創建通知
訊息標頭
Content-Length:612 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"transfer",
"notification_type":"transfer_created_notification"
},
"body":{
"id":"c30f5835-2544-41d8-bf0c-4868669b637d",
"short_reference":"BT-20180511-KZTTYX",
"source_account_id":"e0bf0629-56e7-42f2-84a4-3528168ee21c",
"destination_account_id":"10a1ba3d-10f8-400e-89fa-8fafa323cc96",
"currency":"USD",
"amount":"300.00",
"status":"pending",
"created_at":"2018-05-11T13:21:43+00:00",
"updated_at":"2018-05-11T13:21:43+00:00",
"completed_at":null,
"creator_account_id":"2090939e-b2f7-3f2b-1363-4d235b3f58af",
"creator_contact_id":"8a98ebac-6f88-e205-a685-4d235b1b088b",
"reason":"moving funds 2 - 3"
}
}
通知類型 : 轉賬完成通知
訊息標頭
Content-Length: 639 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"transfer",
"notification_type":"transfer_completed_notification"
},
"body":{
"id":"c30f5835-2544-41d8-bf0c-4868669b637d",
"short_reference":"BT-20180511-KZTTYX",
"source_account_id":"e0bf0629-56e7-42f2-84a4-3528168ee21c",
"destination_account_id":"10a1ba3d-10f8-400e-89fa-8fafa323cc96",
"currency":"USD",
"amount":"300.00",
"status":"completed",
"created_at":"2018-05-11T13:21:43+00:00",
"updated_at":"2018-05-11T13:21:44+00:00",
"completed_at":"2018-05-11T13:21:44+00:00",
"creator_account_id":"2090939e-b2f7-3f2b-1363-4d235b3f58af",
"creator_contact_id":"8a98ebac-6f88-e205-a685-4d235b1b088b",
"reason":"moving funds 2 - 3"
}
}
通知類型 : 現金管理器交易待處理通知
訊息標頭
Content-Length:723 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "cash_manager_transaction",
"notification_type": "pending_cash_manager_transaction_notification"
},
"body": {
"id":"0c54e5d6-afd8-4eab-b82f-f2371467d79f",
"balance_id": "b7a0b206-4dfd-48e6-aa7b-1b6514b76148",
"account_id":"8427390b-21cc-41f5-b3b4-8ce20d770053",
"currency":"EUR",
"amount":"1000.00",
"balance_amount":"1000.00",
"type": "credit",
"related_entity_type": "inbound_funds",
"related_entity_id":"46d8d68f-9fb1-41ba-9d67-708dc36d0cf1",
"related_entity_short_reference":"IF-20200616-MMZ57O",
"status": "pending",
"reason": "",
"settles_at": null,
"created_at":"2020-06-16T12:13:47+00:00",
"updated_at":"2020-06-16T12:13:47+00:00",
"completed_at": null,
"action": "funding"
}
}
通知類型 : 現金管理器交易待處理通知
訊息標頭
Content-Length:742 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "cash_manager_transaction",
"notification_type": "reject_cash_manager_transaction_notification"
},
"body": {
"id":"0c54e5d6-afd8-4eab-b82f-f2371467d79f",
"balance_id": "b7a0b206-4dfd-48e6-aa7b-1b6514b76148",
"account_id":"8427390b-21cc-41f5-b3b4-8ce20d770053",
"currency":"EUR",
"amount":"1000.00",
"balance_amount":"1000.00",
"type": "credit",
"related_entity_type": "inbound_funds",
"related_entity_id":"46d8d68f-9fb1-41ba-9d67-708dc36d0cf1",
"related_entity_short_reference":"IF-20200616-MMZ57O",
"status": "deleted",
"reason": "",
"settles_at": null,
"created_at":"2020-06-16T12:13:47+00:00",
"updated_at":"2020-06-16T12:13:47+00:00",
"completed_at": null,
"action": "funding"
}
}
通知類型 : 現金管理器交易通知
訊息標頭
Content-Length:711 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"cash_manager_transaction",
"notification_type":"cash_manager_transaction_notification"
},
"body":{
"id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"balance_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"account_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"currency":"EUR",
"amount":"100000.00",
"balance_amount":"100000.00",
"type":"credit",
"related_entity_type":"inbound_funds",
"related_entity_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"related_entity_short_reference":"",
"status":"completed",
"reason":"",
"settles_at":"2018-01-05T14:39:41+00:00",
"created_at":"2018-01-05T14:39:41+00:00",
"updated_at":"2018-01-05T14:39:41+00:00",
"completed_at":"2018-01-05T14:39:41+00:00",
"action":"funding"
}
}
通知類型：收到終端客戶應用程式通知
訊息標頭
Content-Length:280 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"onboarding",
"notification_type":"end_client_application_received"
},
"body":{
"submitted_at":"2022_04_12T10:15:48 00:00",
"individual_applicant_name":"John Smith",
"company_name":"ABC Ltd",
"email":"john.smith@google.com",
"form_id":"xyz123",
"sub_account_id":"xyz123"
}
}
通知類型：確定終端客戶應用程式通知
訊息標頭
Content-Length:369 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header":{
"message_type":"onboarding",
"notification_type":"end_client_decisioned_webhook"
},
"body":{
"entity_type":"Corporate",
"individual_applicant_name":"John Smith",
"company_name":"ABC Ltd",
"trading_name":"ABC Ltd",
"applicant_jurisdiction":"US",
"contact_email":"john.smith@google.com",
"contact_telephone":"07777777777",
"Decision":"Approved",
"sub_account_id":"xyz123",
"sub_account_UUID":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
通知類型：銀行賬戶驗證通知
訊息標頭
Content-Length:270 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: application/json
推送通知
{
"header": {
"message_type": "bank_account_verified",
"notification_type": "bank_account_verified_notification"
},
"body": {
"account_id": "aae40a9f-6c91-3f2a-7678-4e92b3f83a6c",
"account_name":"A New Account",
"short_reference":"210401-48650",
"bank_account_verified":"yes"
}
版本 2021 01 01
通知類型：準備發送通知
訊息標頭
Content-Length:681 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_ready_to_send_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "ready_to_send",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason": "",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
通知類型：支付釋放通知
訊息標頭
Content-Length:734 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_released_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "completed",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason": "",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
通知類型：支付失敗通知
訊息標頭
Content-Length:757 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_failed_notification"
},
"body": {
"id": "a634d8c2-f520-4cba-985c-77dc1e0cc9af",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id": "e5e8c287-73c3-4998-a368-47937301e471",
"currency":"GBP",
"reference": "cc",
"reason": "test",
"status": "failed",
"payment_type": "priority",
"payment_date":"2018-04-30 00:00:00 +0000",
"transferred_at":"2018-04-30 08:39:25 +0000",
"authorisation_steps_required":"0",
"creator_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"last_updater_contact_id":"202b6291-99b4-0132-60c0-10b11cb33cfb",
"short_reference":"180430-TSLCQJ001",
"failure_reason":"Test Fail",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
通知類型：支付合规性未通過
訊息標頭
Content-Length:743 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "payment",
"notification_type": "payment_compliance_failed_notification"
},
"body": {
"id": "ff13cd8a-d0b3-473c-a6e8-f68bc079aff8",
"amount":"2000.00",
"failure_returned_amount":"2000.00",
"beneficiary_id":"509c6dd0-6b26-4fec-930f-937ddc428bba",
"conversion_id":null,
"currency":"GBP",
"reference": "rrr",
"reason": "test",
"status": "failed",
"payment_type": "priority",
"payment_date":"2018-07-27T00:00:00+00:00",
"transferred_at": null,
"authorisation_steps_required":0,
"creator_contact_id": "eb5ecd81-f800-0132-a9c5-10b11cb33cfb",
"last_updater_contact_id": "eb5ecd81-f800-0132-a9c5-10b11cb33cfb",
"short_reference":"180727-GYJLVG001",
"failure_reason":"Compliance failed 1",
"payment_group_id":null,
"unique_request_id":"Ciu4eNcYnq582hwK_8Cu47sk",
"fee_amount": null,
"fee_currency": null
}
通知類型：現金管理器交易通知
訊息標頭
Content-Length:932 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"cash_manager_trade_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"awaiting_funds",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"1.4078",
"core_rate":"1.4077",
"partner_rate":"",
"client_rate":"1.3795",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：資金到賬通知
訊息標頭
Content-Length:927 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"funds_arrived_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"funds_arrived",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":null,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：交易結算通知
訊息標頭
Content-Length:922 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"trade_settled_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"trade_settled",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：交易關閉通知
訊息標頭
Content-Length:924 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"conversion",
"notification_type":"trade_closed_notification"
},
"body":{
"id":"a0d9034e-bc9f-45e7-a1e4-6485735794c0",
"account_id":"d2b04c30-9585-4ba6-acea-bf9add10444d",
"creator_contact_id":"669b4860-4bb3-4636-8ee4-9e672810d350",
"short_reference":"20180430-GBMHXC",
"created_at":"2018-04-30T12:49:06+00:00",
"settlement_date":"2018-04-30T15:30:00+00:00",
"conversion_date":"2018-04-30T00:00:00+00:00",
"status":"closed",
"currency_pair":"GBPUSD",
"buy_currency":"USD",
"sell_currency":"GBP",
"fixed_side":"sell",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"96565.00",
"client_sell_amount":"70000.00",
"mid_market_rate":"0.7103",
"core_rate":"0.7104",
"partner_rate":"",
"client_rate":"0.7249",
"deposit_required":false,
"deposit_amount":"0.00",
"deposit_currency":"",
"deposit_status":"not_required",
"deposit_required_at":"",
"payment_ids":[]
}
}
通知類型：押金到賬通知
訊息標頭
Content-Length:955 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":
{
"message_type":"conversion",
"notification_type":"deposit_arrived_notification"
},
"body":
{
"id":"991e203b-5001-4cca-83f4-606e6543f6cd",
"account_id":"9658df0c-a7cd-d9c9-274a-4e81bdf5f64a",
"creator_contact_id":"a3180fae-4c77-6dfb-74b3-4f16d55d6d1d",
"short_reference":"20180514-TCNZVW",
"created_at":"2018-05-14T07:24:06+00:00",
"settlement_date":"2018-05-17T13:00:00+00:00",
"conversion_date":"2018-05-17T00:00:00+00:00",
"status":"awaiting_funds",
"currency_pair":"GBPUSD",
"buy_currency":"GBP",
"sell_currency":"USD",
"fixed_side":"buy",
"partner_buy_amount":"0.00",
"partner_sell_amount":"0.00",
"client_buy_amount":"1500.00",
"client_sell_amount":"2115.90",
"mid_market_rate":"0.7092",
"core_rate":"0.7092",
"partner_rate":"",
"client_rate":"0.7089",
"deposit_required":true,
"deposit_amount":"63.48",
"deposit_currency":"USD",
"deposit_status":"deposit_received",
"deposit_required_at":"2018-05-16T13:00:00+00:00",
"payment_ids":[]
}
}
通知類型：轉賬創建通知
訊息標頭
Content-Length:612 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"transfer",
"notification_type":"transfer_created_notification"
},
"body":{
"id":"c30f5835-2544-41d8-bf0c-4868669b637d",
"short_reference":"BT-20180511-KZTTYX",
"source_account_id":"e0bf0629-56e7-42f2-84a4-3528168ee21c",
"destination_account_id":"10a1ba3d-10f8-400e-89fa-8fafa323cc96",
"currency":"USD",
"amount":"300.00",
"status":"pending",
"created_at":"2018-05-11T13:21:43+00:00",
"updated_at":"2018-05-11T13:21:43+00:00",
"completed_at":null,
"creator_account_id":"2090939e-b2f7-3f2b-1363-4d235b3f58af",
"creator_contact_id":"8a98ebac-6f88-e205-a685-4d235b1b088b",
"reason":"moving funds 2 - 3"
}
}
通知類型：轉賬完成通知
訊息標頭
Content-Length:639 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"transfer",
"notification_type":"transfer_completed_notification"
},
"body":{
"id":"c30f5835-2544-41d8-bf0c-4868669b637d",
"short_reference":"BT-20180511-KZTTYX",
"source_account_id":"e0bf0629-56e7-42f2-84a4-3528168ee21c",
"destination_account_id":"10a1ba3d-10f8-400e-89fa-8fafa323cc96",
"currency":"USD",
"amount":"300.00",
"status":"completed",
"created_at":"2018-05-11T13:21:43+00:00",
"updated_at":"2018-05-11T13:21:44+00:00",
"completed_at":"2018-05-11T13:21:44+00:00",
"creator_account_id":"2090939e-b2f7-3f2b-1363-4d235b3f58af",
"creator_contact_id":"8a98ebac-6f88-e205-a685-4d235b1b088b",
"reason":"moving funds 2 - 3"
}
}
通知類型：現金管理器交易待處理通知
訊息標頭
Content-Length:723 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "cash_manager_transaction",
"notification_type": "pending_cash_manager_transaction_notification"
},
"body": {
"id":"0c54e5d6-afd8-4eab-b82f-f2371467d79f",
"balance_id": "b7a0b206-4dfd-48e6-aa7b-1b6514b76148",
"account_id":"8427390b-21cc-41f5-b3b4-8ce20d770053",
"currency":"EUR",
"amount":"1000.00",
"balance_amount":"1000.00",
"type": "credit",
"related_entity_type": "inbound_funds",
"related_entity_id":"46d8d68f-9fb1-41ba-9d67-708dc36d0cf1",
"related_entity_short_reference":"IF-20200616-MMZ57O",
"status": "pending",
"reason": "",
"settles_at": null,
"created_at":"2020-06-16T12:13:47+00:00",
"updated_at":"2020-06-16T12:13:47+00:00",
"completed_at": null,
"action": "funding"
}
}
通知類型：現金管理器交易已拒絕通知
訊息標頭
Content-Length:742 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "cash_manager_transaction",
"notification_type": "reject_cash_manager_transaction_notification"
},
"body": {
"id":"0c54e5d6-afd8-4eab-b82f-f2371467d79f",
"balance_id": "b7a0b206-4dfd-48e6-aa7b-1b6514b76148",
"account_id":"8427390b-21cc-41f5-b3b4-8ce20d770053",
"currency":"EUR",
"amount":"1000.00",
"balance_amount":"1000.00",
"type": "credit",
"related_entity_type": "inbound_funds",
"related_entity_id":"46d8d68f-9fb1-41ba-9d67-708dc36d0cf1",
"related_entity_short_reference":"IF-20200616-MMZ57O",
"status": "deleted",
"reason": "",
"settles_at": null,
"created_at":"2020-06-16T12:13:47+00:00",
"updated_at":"2020-06-16T12:13:47+00:00",
"completed_at": null,
"action": "funding"
}
}
通知類型：現金管理器交易通知
訊息標頭
Content-Length:711 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"cash_manager_transaction",
"notification_type":"cash_manager_transaction_notification"
},
"body":{
"id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"balance_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"account_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"currency":"EUR",
"amount":"100000.00",
"balance_amount":"100000.00",
"type":"credit",
"related_entity_type":"inbound_funds",
"related_entity_id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"related_entity_short_reference":"",
"status":"completed",
"reason":"",
"settles_at":"2018-01-05T14:39:41+00:00",
"created_at":"2018-01-05T14:39:41+00:00",
"updated_at":"2018-01-05T14:39:41+00:00",
"completed_at":"2018-01-05T14:39:41+00:00",
"action":"funding"
}
}
通知類型：收到終端客戶應用程式通知
訊息標頭
Content-Length:280 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"onboarding",
"notification_type":"end_client_application_received"
},
"body":{
"submitted_at":"2022_04_12T10:15:48 00:00",
"individual_applicant_name":"John Smith",
"company_name":"ABC Ltd",
"email":"john.smith@google.com",
"form_id":"xyz123",
"sub_account_id":"xyz123"
}
}
通知類型：確定終端客戶應用程式通知
訊息標頭
Content-Length:369 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header":{
"message_type":"onboarding",
"notification_type":"end_client_decisioned_webhook"
},
"body":{
"entity_type":"Corporate",
"individual_applicant_name":"John Smith",
"company_name":"ABC Ltd",
"trading_name":"ABC Ltd",
"applicant_jurisdiction":"US",
"contact_email":"john.smith@google.com",
"contact_telephone":"07777777777",
"Decision":"Approved",
"sub_account_id":"xyz123",
"sub_account_UUID":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
通知類型：銀行賬戶驗證通知
訊息標頭
Content-Length:270 Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3 Accept: */* User-Agent:Ruby Host:WS00CC014:8000 Content-Type: text/plain
推送通知
{
"header": {
"message_type": "bank_account_verified",
"notification_type": "bank_account_verified_notification"
},
"body": {
"account_id": "aae40a9f-6c91-3f2a-7678-4e92b3f83a6c",
"account_name":"A New Account",
"short_reference":"210401-48650",
"bank_account_verified":"yes"
}