概览
推送通知，或称 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
在此版本中，我们已将标头的 content-type 更新为 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"
}