Skip to main content
WEBHOOK
If a reference_id was provided when the transaction was created via eth_sendTransaction or signAndSendTransaction, it is included in the webhook payload for reconciliation.

Body

application/json

Payload for the transaction.provider_error webhook event.

type
enum<string>
required

The type of webhook event.

Available options:
transaction.provider_error
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:4217 for Tempo, eip155:1 for Ethereum mainnet).

transaction_hash
string
required

The blockchain transaction hash.

event_id
string
required

The ID of this event, stable across repeat deliveries so clients can deduplicate on it.

reference_id
string | null

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

Response

200

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