v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Transaction failed

Fired when a transaction fails.

postWebhooktransaction.failed

caip2string required

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

reference_idstring nullable

Developer-provided reference ID for transaction reconciliation, if one was provided.

transaction_hashstring required

The blockchain transaction hash.

transaction_idstring required

The Privy-assigned ID for this transaction.

type'transaction.failed' required

The type of webhook event.

wallet_idstring required

The ID of the wallet that initiated the transaction.

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