Withdrawals

Back to Core Concepts

Overview

Withdrawals allow customers to move their cryptocurrency balances from SDigital2 to external wallet addresses.

Withdrawal Lifecycle

Withdrawal Statuses

PROCESSING: The withdrawal has been created and the stablecoin is being sent to the destination wallet.
SUCCESS: The withdrawal completed successfully.

Withdrawal Features

Supported Assets:

USDT
USDC

Supported Networks:

Ethereum (ETHEREUM)
Polygon (POLYGON)
Base (BASE)

Key Features:

Automatic transaction hash generation
Block explorer link generation
Real-time status tracking
Precision handling (6 decimal places)

Important Withdrawal Notes

Critical Requirements:

Withdrawals can only be made from existing customer balances
Ensure the destination wallet address matches the selected blockchain network
Withdrawal amounts are truncated to 6 decimal places
Verify wallet addresses carefully, transactions cannot be reversed

Withdrawal Process

Check Balance: Verify customer has sufficient balance
Validate Address: Ensure destination address is valid for the selected chain
Create Withdrawal: Submit withdrawal request with amount and destination
Monitor Status: Track withdrawal progress until completion
Receive Receipt: Get transaction hash and block explorer link

Example Withdrawal Response

{
  "id": "c2e3d98a-b40d-4d60-896e-ae7bb6716948",
  "customerId": "774f7a53-fd45-4634-9548-eb37c9554137",
  "currency": "USDC",
  "amount": "100",
  "chain": "ETHEREUM",
  "destinationWalletAddress": "0x2fc4512d5859226cf0bf61fbbbdb5444fda60053",
  "createdAt": "2025-09-13T18:01:00.764Z",
  "updatedAt": "2025-09-13T18:01:00.756Z",
  "status": "SUCCESS",
  "receipt": {
    "transactionHash": "0xb1189aa2a2c17eff237ece7a99bc284d70218ee13f3dea8e0027227d97244ca8",
    "blockExplorerUrl": "https://etherscan.io/tx/0xb1189aa2a2c17eff237ece7a99bc284d70218ee13f3dea8e0027227d97244ca8"
  }
}