Overview
Push Notifications, a.k.a. webhooks, allow you to set up integrations that correspond with ‘notifications’ from Currencycloud.
There is a set of events described in the Notifications section below that can trigger push notifications on the Currencycloud Platform. When one of these events is triggered, we send an HTTP POST command to the webhook’s URL. This allows you to track transactions and state changes in a more efficient manner and automate communications internally or with your customers.
Security
We want you to be confident that the notifications come from Currencycloud and that they have not been tampered with. We therefore append a Hash-based Message Authentication Code (HMAC) to notifications to enable you to verify the integrity of the messages. Find out how in our Message Verification FAQ.
Versioning
In July 2021, we introduced versioning – this allows us to deliver changes to you quicker, without risking breaking your integration. By default, you will be delivered the most recent version of a notification type. We will notify you if and when we decide to deprecate a version and provide you with guidance on how to upgrade your integration. If you have any questions on this, please contact your Solutions Manager.
Automatic re-send functionality
In July 2021, we also introduced automatic re-send functionality. If a delivery fails the first time, we will automatically attempt to send it 5 more times, with an exponentially growing timeout between attempts, as per the list below:
1 second
2 seconds
4 seconds
8 seconds
16 seconds
After 5 attempts, the delivery will be marked as Failed. At this point, it is worth checking your configuration, before asking your Solutions Manager to manually re-send the notification.
Message headers
Please note that we may at times send additional headers in our notifications.
Getting started
When you are ready to get set up with push notifications, please contact your Solutions Manager. You will need to provide them with an endpoint which can be configured against our Demo and Production environments.
Notifications and events
The following entities and events generate push notifications on the Currencycloud platform. These events can be configured individually to generate a push notification.
Payments
The following diagram presents the different status payments go through during their lifecycle on the platform. This also highlights which statuses trigger push notifications.
Conversions
The following diagram presents the different statuses that a conversion goes through during its lifecycle on the platform. The diagram describes also which statuses trigger events that are covered by push notifications.
Transfers
The following diagram presents the different statuses that a transfer goes through during its lifecycle on the platform. The diagram describes also which statuses trigger events that are covered by push notifications.
Funding Transactions
The following diagram presents the details of a funding transaction.
Bank Account Verification
Bank Account Verification is an additional step in the onboarding process for Currencycloud BV clients. Completing the verification process triggers a push notification.
Versions
Click on a version tab to see example push notifications for that version.
Message Header |
|
Notification Type | Ready To Send Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Released Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Failed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Compliance Failed |
Push Notification |
|
Message Header |
|
Notification Type | Cash Manager Trade Notification |
Push Notification |
|
Message Header |
|
Notification Type | Funds Arrived Notification |
Push Notification |
|
Message Header |
|
Notification Type | Trade Settled Notification |
Push Notification |
|
Message Header |
|
Notification Type | Trade Closed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Deposit Arrived Notification |
Push Notification |
|
Message Header |
|
Notification Type | Transfer Created Notification |
Push Notification |
|
Message Header |
|
Notification Type | Transfer Completed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Pending Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Reject Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Bank Account Verified Notification |
Push Notification |
|
Message Header |
|
Notification Type | Ready To Send Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Released Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Failed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Payment Compliance Failed |
Push Notification |
|
Message Header |
|
Notification Type | Cash Manager Trade Notification |
Push Notification |
|
Message Header |
|
Notification Type | Funds Arrived Notification |
Push Notification |
|
Message Header |
|
Notification Type | Trade Settled Notification |
Push Notification |
|
Message Header |
|
Notification Type | Trade Closed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Deposit Arrived Notification |
Push Notification |
|
Message Header |
|
Notification Type | Transfer Created Notification |
Push Notification |
|
Message Header |
|
Notification Type | Transfer Completed Notification |
Push Notification |
|
Message Header |
|
Notification Type | Pending Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Reject Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Cash Manager Transaction Notification |
Push Notification |
|
Message Header |
|
Notification Type | Bank Account Verified Notification |
Push Notification |
|