{
"type": "wallet_action.transfer.rejected",
"wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"action_type": "transfer",
"status": "rejected",
"created_at": "2026-06-15T15:24:00.000Z",
"rejected_at": "2026-06-15T15:24:12.000Z",
"source_asset": "usdc",
"source_amount": "1.5",
"source_chain": "base",
"destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"failure_reason": {
"message": "Transaction simulation reverted"
},
"steps": [
{
"type": "evm_transaction",
"status": "rejected",
"caip2": "eip155:8453",
"transaction_hash": null,
"failure_reason": {
"message": "Transaction simulation reverted"
}
}
]
}Transfer rejected
Fired when a wallet action fails before any onchain effects (e.g. policy rejection, simulation failure). Safe to retry.
{
"type": "wallet_action.transfer.rejected",
"wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"action_type": "transfer",
"status": "rejected",
"created_at": "2026-06-15T15:24:00.000Z",
"rejected_at": "2026-06-15T15:24:12.000Z",
"source_asset": "usdc",
"source_amount": "1.5",
"source_chain": "base",
"destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"failure_reason": {
"message": "Transaction simulation reverted"
},
"steps": [
{
"type": "evm_transaction",
"status": "rejected",
"caip2": "eip155:8453",
"transaction_hash": null,
"failure_reason": {
"message": "Transaction simulation reverted"
}
}
]
}Body
Payload for the wallet_action.transfer.rejected webhook event.
The type of webhook event.
wallet_action.transfer.rejected The ID of the wallet action.
The ID of the wallet involved in the action.
Type of wallet action
swap, transfer, earn_deposit, earn_withdraw, earn_incentive_claim, earn_fee_collect, payout ISO 8601 timestamp of when the wallet action was created.
Chain name (e.g. "tempo", "base").
Recipient address.
The status of the wallet action.
rejected A description of why a wallet action (or a step within a wallet action) failed.
Show child attributes
Show child attributes
The steps of the wallet action at the time of rejection.
A wallet action step consisting of an EVM transaction.
- EVMTransactionWalletActionStep
- EVMUserOperationWalletActionStep
- SVMTransactionWalletActionStep
- TVMTransactionWalletActionStep
- ExternalTransactionWalletActionStep
- CustodianTransactionWalletActionStep
Show child attributes
Show child attributes
ISO 8601 timestamp of when the wallet action was rejected.
Developer-provided reference ID, if one was included in the request.
Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated with a named asset; omitted for custom-token transfers.
Token contract address (EVM) or mint address (Solana). Present when the transfer was initiated with asset_address.
Number of decimals for the transferred token. Present when the transfer was initiated with asset_address and the decimals were resolved onchain.
Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output cross-chain transfers until the source amount is determined.
Response
Return a 200 status to indicate that the webhook was received successfully.
Was this page helpful?

