Webhooks

This section explains how to manage an account's webhook.

Webhooks associated to an account in this section are used for Crypto and ON:OFF Ramp transactions.

🚧

Invoice, Send to address, LURL (Pay and Withdraw) Webhooks

Webhooks for this transactions are created when calling their respective endpoints. Webhooks created in this section do NOT get called for this transaction types.

Crypto

Crypto webhooks are triggered when a Send or Receive transaction have reached a terminal status (completed or failed).

Webhook body

{
  "transaction": {
    "amount": "number (float64)",
    "accountId": "string (UUID)",
    "networkFee": "number (float64)",
    "transactionTypeId": "number (int)",
    "createdAt": "string (ISO 8601 Timestamp)",
    "settledAt": "string (ISO 8601 Timestamp) | null",
    "status": "string"
  },
  "secret": "string | null"
}

Ramp

Ramp webhooks are triggered when a Deposit or Withdrawal transaction have reached a terminal status (completed or failed).

Webhook body

{
  "transaction": {
    "id": "string (UUID)",
    "accountId": "string (UUID)",
    "amount": "number (float64)",
    "networkFee": "number (float64)",
    "currencyId": "number (int)",
    "transactionTypeId": "number (int)",
    "createdAt": "string (ISO 8601 Timestamp)",
    "settledAt": "string (ISO 8601 Timestamp) | null",
    "status": "string"
  },
  "secret": "string | null"
}

Transaction Types

IDNameDescription
7Ramp DepositBank Deposit
8Ramp WithdrawalBank Withdrawal
9Crypto ReceiveCrypto Receive
10Crypto SendCrypto Send

** For a complete list of transaction types use the transaction type endpoint