Cancel Transfer

Cancels an EVM transfer by creating a replacement transaction with the same nonce. The new transaction sends 0 value to the same address, effectively nullifying the original transfer.

This endpoint works for:

• EVM-compatible networks (Ethereum, Polygon, BSC, etc.)
• Transfers that are in ‘Broadcasted’ status (pending inclusion in a block)
• Transfers that are in ‘Failed’ status, but failed off-chain (before being broadcasted to the network)

The cancellation works by:

1. Extracting the nonce from the original transfer’s signed data
2. Creating a new transaction to the same wallet address with 0 amount
3. Using the same nonce to either:
   • Replace the original transaction in the mempool (if it was broadcasted)
   • Consume the nonce that was reserved but not used (if the transfer failed off-chain)

Note: For transfers that were broadcasted on-chain, success is not guaranteed as it depends on network conditions and whether the original transaction has already been mined.

POST /wallets/{walletId}/transfers/{transferId}/cancel

Cancel Transfer

cURL

curl --request POST \
  --url https://api.dfns.io/wallets/{walletId}/transfers/{transferId}/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'

200

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>",
  "replacementId": "<string>",
  "details": {}
}

Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

Required Permissions

Wallets:Transactions:Create: Always required.
Wallets:Transfers:Read: Always required.

Authorizations

Authorization · string · header · required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION · string · header · required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Path Parameters

walletId · string · required

Wallet id.

Required string length: 1 - 64

transferId · string · required

Transfer id.

Required string length: 1 - 64

Response

200 - application/json

Success

id · string · required

Transaction id.

Required string length: 1 - 64

Pattern: ^tx-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"tx-583hu-sp2p7-slvb9nqpa3hd8bus"

walletId · string · required

Wallet id.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

network · enum<string> · required

Network the address is watched on.

Available options: Algorand, AlgorandTestnet, Aptos, AptosTestnet, ArbitrumOne, ArbitrumSepolia, ArcTestnet, AvalancheC, AvalancheCFuji, BabylonGenesis, BabylonTestnet5, Base, BaseSepolia, Berachain, BerachainBepolia, Bitcoin, BitcoinSignet, BitcoinTestnet4, BitcoinCash, Bob, BobSepolia, Bsc, BscTestnet, Canton, CantonTestnet, Cardano, CardanoPreprod, Concordium, ConcordiumTestnet, Celo, CeloAlfajores, Codex, CodexSepolia, CosmosHub4, CosmosIcsTestnet, Dogecoin, DogecoinTestnet, Ethereum, EthereumClassic, EthereumClassicMordor, EthereumSepolia, EthereumHoodi, FlareC, FlareCCoston2, FlowEvm, FlowEvmTestnet, Hedera, HederaTestnet, Ink, InkSepolia, InternetComputer, Ion, IonTestnet, Iota, IotaTestnet, Kusama, KusamaAssetHub, Litecoin, LitecoinTestnet, Movement, MovementTestnet, Near, NearTestnet, Optimism, OptimismSepolia, Origyn, Plasma, PlasmaTestnet, Plume, PlumeSepolia, Paseo, PaseoAssetHub, Polkadot, PolkadotAssetHub, Polygon, PolygonAmoy, Polymesh, PolymeshTestnet, Race, RaceSepolia, Rayls, RaylsTestnet, Robinhood, RobinhoodSepolia, SeiAtlantic2, SeiPacific1, Solana, SolanaDevnet, Sonic, SonicTestnet, Starknet, StarknetSepolia, Stellar, StellarTestnet, Sui, SuiTestnet, Tezos, TezosGhostnet, TezosShadownet, Tempo, TempoModerato, Tsc, TscTestnet1, Ton, TonTestnet, Tron, TronNile, Westend, WestendAssetHub, Xdc, XdcApothem, XLayer, XLayerSepolia, XrpLedger, XrpLedgerTestnet

requester · object · required

The user who initiated the request.

Show child attributes

requestBody · Transaction · object · required

Signs an unsigned transaction and broadcasts it to chain. For EVM transactions, you may use JSON objects:

Field	Description	Type - Optional
type	Ethereum transaction type. 0 for legacy transaction; 2 for EIP-1559 transaction; 4 for EIP-7702 transaction. Default is 2 if undefined.	Integer (optional)
to	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String (optional)
value	The amount of native tokens to transfer in minimum denomination.	String (optional)
data	ABI encoded function call data in hex format. Can also be the encoded smart contract data when the transaction is a contract deployment.	String (optional)
nonce	The transaction number to guarantee idempotency. If omitted, it will be provided automatically. Note the same nonce can be submitted multiple times with a higher maxFeePerGas to "overwrite" existing transactions in the mempool.	Integer or String (optional)
gasLimit	The maximum amount of gas that can be spent for executing the transaction. If omitted, it will be calculated automatically.	String (optional)
gasPrice	The amount of per unit gas. Only valid for a type 0 legacy transaction. If omitted, it will be calculated automatically.	String (optional)
maxFeePerGas	The maximum amount of per unit gas willing to be paid for the transaction. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
maxPriorityFeePerGas	The maximum amount of per unit gas to be included as a tip to the validator. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.	String (optional)
authorizationList	A list that indicates what code the signer of each authorization desires to execute in the context of their EOA. Only valid for type 4 transaction.	Authorization (optional)

For Starknet transactions, you may use invocation request objects (https://github.com/starkware-libs/starknet-specs/blob/v0.8.1/api/starknet_api_openrpc.json#L2621):

Field	Description	Type - Optional
calldata	Array of encoded function call parameters	Array of Strings (required)
nonce	Transaction nonce in hex format	String (required)
version	Transaction version in hex format. Typically "0x3" for current transactions	String (required)
resourceBounds	Gas bounds for L1, L2, and L1 data gas	Object (required)
↳ resourceBounds.l1Gas	L1 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l2Gas	L2 gas configuration with maxAmount and maxPricePerUnit	Object (required)
↳ resourceBounds.l1DataGas	L1 data gas configuration with maxAmount and maxPricePerUnit	Object (required)
tip	Transaction tip in hex format. Typically "0x0"	String (required)
paymasterData	Paymaster data array	Array of Strings (required)
accountDeploymentData	Account deployment data array	Array of Strings (required)
nonceDataAvailabilityMode	Data availability mode for nonce. Typically "L1" for now	String (required)
feeDataAvailabilityMode	Data availability mode for fee. Typically "L1" for now	String (required)

For Concordium transactions, you may use JSON objects (from https://github.com/Concordium/concordium-node-sdk-js/blob/sdk/12.0.0-alpha.3/packages/sdk/src/transactions/Transaction.ts#L102)

Field	Description	Type - Optional
Header	Transaction header for the intermediary state of account transactions, i.e. prior to being signing.	Object (required)
↳ Header.executionEnergyAmount	The destination address or target contract. Leave undefined when the transaction is a contract deployment.	String/Number/BigInt (required)
↳ Header.numSignatures	The number of signatures the transaction can hold. If "undefined", this will be defined at the time of signing	Integer (optional)
↳ Header.sender	The account address that is source of this transaction	String (optional)
↳ Header.nonce	The account nonce	String/Number/BigInt (optional)
↳ Header.expiry	expiration of the transaction	Integer (optional)
Payload	The transaction account payload in JSON format (https://github.com/Concordium/concordium-node-sdk-js/blob/main/packages/sdk/src/accountTransactions.ts#L646)	Object (required)

{
  "kind": "Transaction",
  "transaction": {
    "to": "0x00fb58432ef9d418bf6688bcf0a226d2fcaa18e2",
    "data": "0x40d097c3000000000000000000000000d2f77f85a50cdd650ca562f3a180284e1d5b4934",
    "maxFeePerGas": "1626000000000",
    "maxPriorityFeePerGas": "1332000000000"
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "type": "INVOKE",
    "calldata": [
      "1",
      "2009894490435840142178314390393166646092438090257831307886760648929397478285",
      "232670485425082704932579856502088130646006032362877466777181098476241604910",
      "3",
      "296727860213112272332383824629975240127004024814636931420022890499591637514",
      "1",
      "0"
    ],
    "nonce": "0x51",
    "version": "0x3",
    "resourceBounds": {
      "l1Gas": { "maxAmount": "0x0", "maxPricePerUnit": "0x239a01ff6e6c" },
      "l2Gas": { "maxAmount": "0x1694a0", "maxPricePerUnit": "0x10c388d00" },
      "l1DataGas": { "maxAmount": "0x120", "maxPricePerUnit": "0x98e8" }
    },
    "tip": "0x0",
    "paymasterData": [],
    "accountDeploymentData": [],
    "nonceDataAvailabilityMode": "L1",
    "feeDataAvailabilityMode": "L1",
  }
}

{
  "kind": "Transaction",
  "transaction": {
    "header": {
      "sender": undefined,
      "nonce": undefined,
      "expiry": undefined,
      "executionEnergyAmount": 300
    },
    "payload": {
      "type": "transferWithMemo",
      "toAddress": "4HhAcToZs6rtxGcgsBRS3VcjeAECPTTSTFVUKS6rBSVEZAPL6d",
      "memo": "000968656c6c6f20636364",
      "amount": "1"
    }
  }
}

Transaction

PSBT

SignDocDirect

EVM Sponsored transaction

Function Call

Canton Transfer Preapproval

<Deprecated> EVM Transaction

<Deprecated> EVM EIP-1559

Create Solana Nonce Accounts

AcceptInboundAsset

Solana CCTP Burn

Offer Settlement

Account Activation

Transaction Cancellation

Transaction Speed Up

Show child attributes

status · enum<string> · required

Available options: Pending, Executing, Broadcasted, Confirmed, Failed, Rejected

dateRequested · string<date-time> · required

ISO 8601 date (must be UTC). When the transaction was requested.

Example:

"2023-04-14T20:41:28.715Z"

reason · string

txHash · string

fee · string

approvalId · string

Required string length: 1 - 64

Pattern: ^ap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"ap-2a9in-tt2a1-983lho480p35ejd0"

datePolicyResolved · string<date-time>

ISO 8601 date (must be UTC). When the transaction was approved by policy reviewers.

Example:

"2023-04-14T20:41:28.715Z"

dateBroadcasted · string<date-time>

ISO 8601 date (must be UTC). When the transaction was broadcasted to the blockchain.

Example:

"2023-04-14T20:41:28.715Z"

dateConfirmed · string<date-time>

ISO 8601 date (must be UTC). When the transaction was confirmed on chain.

Example:

"2023-04-14T20:41:28.715Z"

externalId · string

replacementId · string

The id of the replacement transaction (cancel or speed-up) issued for this transaction.

details · object

Structured representation of the data used to construct the signature (e.g. nonce, gas parameters). Shape is blockchain specific.

Show child attributes