Skip to main content
WEBHOOK
transaction.failed
{
  "type": "transaction.failed",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "transaction_id": "36d384ec-4e62-4332-ae6f-9ded2c27c680",
  "caip2": "eip155:1",
  "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c"
}

Body

application/json

Payload for the transaction.failed webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
transaction.failed
​
wallet_id
string
required

The ID of the wallet that initiated the transaction.

​
transaction_id
string
required

The Privy-assigned ID for this transaction.

​
caip2
string
required

The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).

​
transaction_hash
string
required

The blockchain transaction hash.

Response

200

Return a 200 status to indicate that the webhook was received successfully.