We refreshed our doc site!
Bookmarked links may have changed
Read release notesAll current and future implementations of notification messages have the following attributes:
Name | Type | Description | Sample |
---|---|---|---|
subscriptionId | String | Id of the webhook subscription. | 80b9b08f-fd12-4f40-a3a6-51bad45cec51 |
notificationId | String | Id for each even notification. This value is the same for retries. | b3f2761f-6ae8-49f8-a730-6216aea08900 |
notificationType | String | The type of notification | transactions.inbound |
notification.version | int | 2 |
This section lists models currently used by existing flows.
This section introduces the events that may occur with a transaction.
Confirmed transactions have been broadcast on the blockchain but have not yet reached the number of confirmations needed to be considered complete.
Confirmed Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.inbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
Completed transactions are settled transactions in which the needed number of blockchain confirmations has been met. Therefore the funds should be available in the destination account.
Completed Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.inbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
Queued transactions have been successfully initiated but have not yet been processed.
Queued Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
Sent transactions are processed and sent to the blockchain node but have not yet been broadcast on-chain.
Sent Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
Confirmed transactions have been successfully broadcast on the blockchain but have not yet reached the number of confirmations needed to be considered complete.
Confirmed Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
Completed transactions are settled transactions in which the needed number of blockchain confirmations has been met. Therefore the funds should be available in the destination account.
Completed Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
The following structure represents notifications for confirmed cancel requests:
Canceled Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
A transaction might fail due to insufficient balance, failed challenge and so forth. A notification with the following structure is sent for failed transactions:
Failed Transaction Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "transactions.outbound",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Transaction Object.
This section introduces the events that may occur with a challenge.
Complete challenges indicate that the operation has been successfully passed by the end-user. Therefore the associated action should be automatically initiated.
Complete Challenge Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "challenges.initialize",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Challenge Object.
Challenges can fail for reasons such as an incorrect pin being entered, the challenge expiring and so forth. A notification with the following structure is sent for failed challenges. This indicates that the operation needs to be re-initiated.
Failed Challenge Notification Payload:
{
"subscriptionId": "80b9b08f-fd12-4f40-a3a6-51bad45cec51",
"notificationId": "b3f2761f-6ae8-49f8-a730-6216aea08900",
"notificationType": "challenges.initialize",
"notification": {
"id": "",
...
},
"timestamp": "2023-06-29T15:05:33.135665781Z",
"version": 2
}
The payload will contain the information of a Challenge Object.