Abort Transaction

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

import requests

url = "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort"

headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>"
}

response = requests.put(url, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'X-DFNS-USERACTION': '<api-key>'}
};

fetch('https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "debugTrace": "<unknown>",
  "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": {}
}

Abort Transaction

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

This is useful when a transaction 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 transaction as failed without any blockchain interaction.

PUT

wallets

{walletId}

transactions

{transactionId}

abort

Abort Transaction

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

import requests

url = "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort"

headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>"
}

response = requests.put(url, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'X-DFNS-USERACTION': '<api-key>'}
};

fetch('https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/wallets/{walletId}/transactions/{transactionId}/abort")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "debugTrace": "<unknown>",
  "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

✅ Tenant User (TenantUser)
✅ Organization User (CustomerEmployee)
✅ End User (EndUser)
✅ Service Account

Required Permissions

Wallets:Transactions: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

transactionId

string

required

Transaction id.

Required string length: 1 - 64

Response

200 - application/json

Success

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

Available options:

Algorand,

AlgorandTestnet,

Aptos,

AptosTestnet,

ArbitrumOne,

ArbitrumSepolia,

Arc,

ArcTestnet,

Areum,

AvalancheC,

AvalancheCFuji,

Base,

BaseSepolia,

Berachain,

BerachainBepolia,

Bitcoin,

BitcoinSignet,

BitcoinTestnet4,

BitcoinCash,

Bob,

BobSepolia,

Bsc,

BscTestnet,

Canton,

CantonTestnet,

Cardano,

CardanoPreprod,

Concordium,

ConcordiumTestnet,

Celo,

CeloSepolia,

Codex,

CodexSepolia,

CosmosHub4,

CosmosIcsTestnet,

Dogecoin,

DogecoinTestnet,

Ethereum,

EthereumClassic,

EthereumClassicMordor,

EthereumSepolia,

EthereumHoodi,

FlareC,

FlareCCoston2,

FlowEvm,

FlowEvmTestnet,

Hedera,

HederaTestnet,

HyperEvm,

HyperEvmTestnet,

Ink,

InkSepolia,

InternetComputer,

Ion,

IonTestnet,

Iota,

IotaTestnet,

Kusama,

KusamaAssetHub,

Litecoin,

LitecoinTestnet,

Monad,

MonadTestnet,

Movement,

MovementTestnet,

Near,

NearTestnet,

Optimism,

OptimismSepolia,

Origyn,

Plasma,

PlasmaTestnet,

Plume,

PlumeSepolia,

Paseo,

PaseoAssetHub,

Polkadot,

PolkadotAssetHub,

Polygon,

PolygonAmoy,

Polymesh,

PolymeshTestnet,

Rayls,

RaylsTestnet,

Robinhood,

RobinhoodSepolia,

SeiAtlantic2,

SeiPacific1,

Solana,

SolanaDevnet,

Sonic,

SonicTestnet,

Starknet,

StarknetSepolia,

Stellar,

StellarTestnet,

Sui,

SuiTestnet,

Tezos,

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. This is the recommended transaction kind for EVM networks — use it instead of the deprecated Evm and Eip1559 kinds. It accepts a JSON transaction object (type 0 legacy, 2 EIP-1559, or 4 EIP-7702) as well as a hex-encoded raw transaction. 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
<Deprecated> Canton Transfer Preapproval
<Deprecated> EVM Transaction
<Deprecated> EVM EIP-1559
Create Solana Nonce Accounts
AcceptInboundAsset
Solana CCTP Burn
Stellar CCTP Approve
Stellar CCTP Burn
Stellar CCTP Claim
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

The reason for a failed transaction.

debugTrace

any

Raw blockchain node diagnostics, when available. Omitted when the diagnostic or response size limit is exceeded.

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 policy evaluation resolved for this transaction (cleared or blocked).

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

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Abort Transaction

Authentication

Required Permissions

Authorizations

Path Parameters

Response