Abort Transfer

Aborts a transfer that is currently in ‘Executing’ status and has not yet been signed. Sets the transfer status to ‘Failed’ and removes it from the retry queue.

This is useful when a transfer is stuck in the execution pipeline (e.g., during construct or sign phase) and you want to abort it without waiting for it to fail on its own.

Unlike cancel, which creates a replacement on-chain transaction, abort simply marks the transfer as failed without any blockchain interaction.

PUT /wallets/{walletId}/transfers/{transferId}/abort

Abort Transfer

cURL

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

200

{
  "id": "xfr-20g4k-nsdpo-mg6arrifgvid4orn",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Native",
    "to": "<string>",
    "amount": "<string>",
    "memo": "<string>",
    "priority": "Slow",
    "createDestinationAccount": true,
    "offer": true,
    "expiresAt": "2023-11-07T05:31:56Z",
    "externalId": "<string>",
    "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
  },
  "metadata": {
    "asset": {
      "symbol": "<string>",
      "decimals": 123,
      "verified": true,
      "quotes": {
        "EUR": 123,
        "USD": 123
      }
    }
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "externalId": "<string>",
  "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
}

Authentication

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

Required Permissions

Wallets:Transfers:Abort: 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

Transfer id.

Required string length: 1 - 64

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

Example:

"xfr-20g4k-nsdpo-mg6arrifgvid4orn"

walletId · string · required

The source wallet for this tranfer.

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

The blockchain network this transfer is on.

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

requester · object · required

The user who initiated the request.

Show child attributes

requestBody · Native Asset · object · required

Transfer the native token of the network. All networks support the native token type.

Native Asset

Aptos Fungible Asset (AIP-21)

Algorand Standard Asset

Cardano Asset

Canton Standard Token (CIP-56)

CIS-2 Standard

Concordium Protocol Level Token (CIS-7)

Sui Coin

EVM Fungible Token (ERC-20)

EVM Non Fungible Token (ERC-721)

Hedera Non-Fungible Token (HIP-17)

Hedera Tokens (HTS)

XRPL IOU Token

Stellar Classic Assets (SEP-41)

Starknet SNIP-2 (ERC-20 like)

Starknet SNIP-3 (ERC-721-like)

Solana Program Library Token (SPL and SPL 2022)

TON Jetton (TEP-74)

TRON Native Fungible Token (TRC-10)

TRON Smart Contract Fungible Token (TRC-20)

TRON Non Fungible Token (TRC-721)

XRPL XLS-33 Token

Show child attributes

metadata · object · required

Additional metadata about the transfered asset.

Show child attributes

status · enum<string> · required

Transfer status.

Status	Definition
Pending	The request is pending approval due to a policy applied to the wallet.
Executing	The request is approved and is in the process of being executed. note this status is only set for a short time between pending and broadcasted.
Broadcasted	The transaction has been successfully written to the mempool.
Confirmed	The transaction has been confirmed on-chain by our indexing pipeline.
Failed	Indicates either system failure to complete the request or the transaction failed on chain.
Rejected	The request has been rejected by a policy approval action.

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

dateRequested · string<date-time> · required

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

Example:

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

reason · string

The reason for a failed transfer.

txHash · string

The blockchain transaction hash for this transfer.

fee · string

The fee paid for this transfer in minimum denomination.

datePolicyResolved · string<date-time>

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

Example:

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

dateBroadcasted · string<date-time>

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

Example:

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

dateConfirmed · string<date-time>

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

Example:

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

approvalId · string

The id of the approval request if this transfer triggered a policy.

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"

externalId · string

The external id provided at transfer creation time.

feeSponsorId · string

The fee sponsor id used to pay for the transfer fees.

Required string length: 1 - 64

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

Example:

"fs-5vqdl-gliqk-b4rfukqauov1sp7j"