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) WebhooksWebhooks for this transactions are created when calling their respective endpoints. Webhooks created in this section do NOT get called for this transaction types.
Production IPs for webhooks
When you receive a webhook check the secret AND the ip address of the sender for maximum security
34.148.92.171 35.196.168.24
Webhook body
{
"transaction": {
"id": "string (UUID)",
"accountId": "string (UUID)",
"amount": "number (float64)",
"networkFee": "number (float64)",
"currencyId": "number (int)",
"transactionTypeId": "number (int)",
"infoId": "string (UUID)",
"createdAt": "string (ISO 8601 Timestamp)",
"settledAt": "string (ISO 8601 Timestamp) | null",
"status": "string"
},
"secret": "string | null"
}infoId refers to a transactions underlying information id. You will need to determine its type based on the transaction's transactionTypeId. Below is a table with current transaction type id's and their corresponding info type.
| Transaction Type Id | Transaction Type | Info |
|---|---|---|
| 7 | Deposit | DepositInfo |
| 8 | Withdrawal | WithdrawalDestination |
| 9 | CryptoReceive | ReceiveInfo |
| 10 | CryptoSend | SendInfo |
Crypto
Crypto webhooks are triggered when a Send or Receive transaction have reached a terminal status (completed or failed).
Ramp
Ramp webhooks are triggered when a Deposit or Withdrawal transaction have reached a terminal status (completed or failed).
Transaction Types
| ID | Name | Description |
|---|---|---|
| 7 | Ramp Deposit | Bank Deposit |
| 8 | Ramp Withdrawal | Bank Withdrawal |
| 9 | Crypto Receive | Crypto Receive |
| 10 | Crypto Send | Crypto Send |
** For a complete list of transaction types use the transaction type endpoint
Transaction Statuses
| Status | Value |
|---|---|
UNKNOWN | 0 |
PENDING | 1 |
COMPLETED | 2 |
FAILED | 3 |
