Sign in

v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
wallets

Initiate Onchain Withdrawal

Send funds on chain to a whitelisted destination on the blockchain. The amount being withdrawn + total fees (including your fees + network fees) must be >= the business account balance.

post/business/send/initiate/onchain

Request body

businessIdstring uuid required

Unique Id of the business who is sending this transactions

sourceAccountIdstring required

The Id of the account to debit

whitelistedAddressIdstring uuid required

The Id of the whitelisted destination

amountstring required

The amount denominated in the smallest divisible unit of the sending currency. For example, cents or satoshis

fixedFeestring

Optional fixedFee in Euro cents to override the default application fee configuration. This amount can only be <= the default configured amount for this transaction type.

percentFeeBpsstring

Optional percentage fee in bps to override the default application fee configuration. This amount can only be <= the default configured amount for this transaction type.

Example request

{
  "businessId": "b6c77114-0e07-48ec-96a8-6c7f52d07415",
  "sourceAccountId": "d3ec681f6f84f404554c44bba797315b",
  "whitelistedAddressId": "118a9e6b-6e75-4d15-a20a-e7e666a72e62",
  "amount": "1000"
}

Response

success

challengeIdstring required
dateExpiresstring date-time required

Example response

{
  "challengeId": "e49febf6-7b05-44cb-a8c8-0a64ec2575a8",
  "dateExpires": "2023-08-20T08:05:38.905Z",
  "transaction": {
    "syncedOwnerId": "b6c77114-0e07-48ec-96a8-6c7f52d07415",
    "sourceAccountId": "d3ec681f6f84f404554c44bba797315b",
    "parentWalletId": "1a6cd565-590f-4187-8d53-2f65774f9f40",
    "currency": "USDC",
    "amount": "1000",
    "status": "PENDING_2FA_CONFIRMATION",
    "txType": "ON_CHAIN_WITHDRAWAL_INITIATED",
    "blockchainDestinationAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
    "blockchainNetwork": {
      "name": "USD Coin Test (Goerli)",
      "type": "ERC20",
      "contractAddress": "0x07865c6E87B9F70255377e024ace6630C1Eaa37F"
    },
    "transactionCurrency": "USDC"
  },
  "feeEstimate": {
    "totalFee": "398",
    "networkFee": "1662779116152000",
    "ourFee": "279",
    "theirFee": "119",
    "feeCurrency": "USDT",
    "gasLimit": "84000",
    "gasPrice": "15.014",
    "fixedFeeDetails": {
      "amount": "104",
      "exchangeRate": "0.96",
      "appliedFeeCents": "100"
    },
    "percentageFeeDetails": {
      "amount": "15",
      "appliedFeeBps": "100"
    }
  }
}