Notification Types

Explore which notifications you can receive from our subscriptions

Notifications from Inabit's webhook service provide real-time updates on transaction events and status changes, ensuring that you stay informed about crucial activities within your organization. Below are the different types of notifications you can expect to receive:

1. New Transaction Event:

   • Date and Time: Timestamp indicating when the transaction occurred.

   • Transaction Type: Whether it's a deposit (received) or a withdrawal (sent).

   • Transaction ID: Unique identifier for the transaction.

   • Transaction Status: Current status of the transaction.

   • Wallet ID: Identifier for the wallet associated with the transaction.

   • Wallet Name: Name of the wallet involved in the transaction.

   • Address Name: Name of the address involved in the transaction.

   • Coin/Asset Symbol: Symbol representing the cryptocurrency involved.

   • Blockchain: Name of the blockchain associated with the transaction.

   • Cryptocurrency Amount: Amount of cryptocurrency transacted.

   • Fee in Cryptocurrency: Transaction fee in cryptocurrency.

   • Fee (in Organization's Base Currency): Transaction fee converted to the organization's base currency.

   • Amount (in Organization's Base Currency): Transaction amount converted to the organization's base currency.

   • Transaction Hash: Unique hash identifying the transaction.

   • Source Address (From): Address from which the cryptocurrency was sent.

   • Destination Address (To): Address to which the cryptocurrency was sent.

2. Transaction Status Updates (Including Transaction Fee Updates):

   • Similar details as the new transaction event, with updates on the transaction status and associated fees + transaction hash (if completed).

These notifications empower you to track and manage transactions effectively, enabling timely decision-making and ensuring transparency and security within your crypto service.

Remember, you can subscribe to notifications through Inabit's GraphQL API, and manage your subscriptions conveniently to tailor notifications to your specific needs.

New Transaction Event

{
  "createTime": "2024-04-01T12:21:00.205Z",
  "transactionType": "Withdrawal",
  "transactionId": "clugx5j1p000pvj4wgog8amvc",
  "transactionStatus": "PendingApproval",
  "walletId": "clu1dzpw00015vjto6gxeld8w",
  "walletName": "My inabit Wallet",
  "addressName": "inabit Wallet Ethereum",
  "coin": "ETH",
  "blockchain": "Ethereum",
  "amount": 0.00034,
  "baseCurrencyAmount": 0.5951873640866312,
  "fee": null,
  "baseCurrencyFee": null,
  "transactionHash": null,
  "sourceAddress": "0xd92a0778ee3f6c35c79407e1611d0dd5543b631f",
  "destinationAddress": "0xaf79d75c836aa10195ce358fc592fbbc2b0c62cc"
}

Transaction Status Updates

This notification is received for every transaction status change.

Here are the possible changes you can receive notifications on:

• Status changed to Processing:

  • Once you approve a transaction, its status should change to this.

• Status changed to Broadcasting:

  • The transaction entered the mempool and is being broadcasted to the blockchain.

• Status changed to Completed:

  • The transaction was completed in the blockchain.

  • In this notification you'll also receive additional data that includes:

    • The transaction fees breakdown.

    • The transaction's hash.

• Status changed to Failed:

  • Transaction failures can occur in the blockchain during broadcasting process or before that, in the processing phase in case any issue occured. (For example - insufficient gas fees to broadcast the transaction)

• Status changed to Rejected:

  • If the approver/s rejected the transaction in the mobile app, the status will be turned "Rejected".

• Status changed to Expired:

  • Transactions have a 5 hour window to be approved/rejected.

  • In case the time limit was reached, the transaction is expired and its status changes to "Expired".

Example Notification

Status changes to Broadcasting:

{
  "createTime": "2024-04-01T12:21:00.205Z",
  "transactionType": "Withdrawal",
  "transactionId": "clugx5j1p000pvj4wgog8amvc",
  "transactionStatus": "Broadcasting",
  "walletId": "clu1dzpw00015vjto6gxeld8w",
  "walletName": "My inabit Wallet",
  "addressName": "inabit Wallet Ethereum",
  "coin": "ETH",
  "blockchain": "Ethereum",
  "amount": 0.00034,
  "baseCurrencyAmount": 0.5951873640866312,
  "fee": null,
  "baseCurrencyFee": null,
  "transactionHash": null,
  "sourceAddress": "0xd92a0778ee3f6c35c79407e1611d0dd5543b631f",
  "destinationAddress": "0xaf79d75c836aa10195ce358fc592fbbc2b0c62cc"
}

Example Notification

Status changes to Completed:

{
  "createTime": "2024-04-01T12:21:00.205Z",
  "transactionType": "Withdrawal",
  "transactionId": "clugx5j1p000pvj4wgog8amvc",
  "transactionStatus": "Completed",
  "walletId": "clu1dzpw00015vjto6gxeld8w",
  "walletName": "My inabit Wallet",
  "addressName": "inabit Wallet Ethereum",
  "coin": "ETH",
  "blockchain": "Ethereum",
  "amount": 0.00034,
  "baseCurrencyAmount": 0.5951873640866312,
  "fee": 0.0013,
  "baseCurrencyFee": 4.38,
  "transactionHash": "0x6a5599d82e56ea89a218f76162cb28c29e28e3e85923ef6dd4cdba8aeec87149",
  "sourceAddress": "0xd92a0778ee3f6c35c79407e1611d0dd5543b631f",
  "destinationAddress": "0xaf79d75c836aa10195ce358fc592fbbc2b0c62cc"
}

Once you receive updates on completion of transactions (status changes to completed), the fees are also updated and are given in the notification data (no longer null):

• Notice the fees are given in both the crypto native currency (in the example above - ethereum) but also in the base currency, which is the base currency of the organization (EUR/USD).

  • fee

  • baseCurrencyFee

• You will also receive the transactionHash of the completed transaction in this notification.