Skip to main content
PUT
/
wallets
/
{walletId}
/
offers
/
{offerId}
/
reject
Reject Offer
curl --request PUT \
  --url https://api.dfns.io/wallets/{walletId}/offers/{offerId}/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'
{
  "id": "offer-3ugfu-o8duj-vqu770ckmg7ilhp4",
  "orgId": "or-30tnh-itmjs-s235s5ontr3r23h2",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "kind": "Native",
  "metadata": {
    "asset": {
      "symbol": "<string>",
      "decimals": 123,
      "verified": true,
      "quotes": {
        "EUR": 123,
        "USD": 123
      }
    }
  },
  "txHash": "<string>",
  "status": "Pending",
  "from": "<string>",
  "to": "<string>",
  "value": "<string>",
  "timestamp": "2023-04-14T20:41:28.715Z",
  "expiresAt": "2023-04-14T20:41:28.715Z",
  "memo": "<string>",
  "settlementTransactionId": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "dateSettled": "2023-04-14T20:41:28.715Z"
}

​
Authentication

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

​
Required Permissions

Wallets:Offers:Settle: 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
​
offerId
string
required

Offer id.

Required string length: 1 - 64
Pattern: ^offer-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Response

200 - application/json

Success

​
id
string
required

Offer id.

Required string length: 1 - 64
Pattern: ^offer-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"offer-3ugfu-o8duj-vqu770ckmg7ilhp4"

​
orgId
string
required

Organization id.

Required string length: 1 - 64
Pattern: ^or-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"or-30tnh-itmjs-s235s5ontr3r23h2"

​
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,
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
​
kind
enum<string>
required
Available options:
Native,
Aip21,
Asa,
Coin,
Cip56,
Erc20,
Erc721,
Asset,
Hip17,
Hts,
Sep41,
Spl,
Spl2022,
Snip2,
Snip3,
Tep74,
Trc10,
Trc20,
Trc721,
Cis7,
Cis2,
Iou,
Xls33
​
metadata
object
required
​
txHash
string
required
​
status
enum<string>
required
Available options:
Pending,
Accepted,
Rejected,
Withdrawn,
Expired
​
from
string
required
​
to
string
required
​
value
string
required
Pattern: ^\d+(\.\d+)?$
​
timestamp
string<date-time>
required

ISO 8601 date (must be UTC). When the offer was created.

Example:

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

​
expiresAt
string<date-time>

ISO 8601 date (must be UTC). When the offer expires.

Example:

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

​
memo
string
​
settlementTransactionId
string

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"

​
dateSettled
string<date-time>

ISO 8601 date (must be UTC). When the offer was settled.

Example:

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

Last modified on February 26, 2026