1. Crypto Withdrawal
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
          GET
        • Create Crypto Withdrawal
          POST
        • Get Crypto Withdrawal Details
          GET
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
        • High Risk KYC Verification Webhook
      • Transfers & Payments Webhooks
        • Internal Transfer Webhook
        • IBAN Status Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order Status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Crypto Withdrawal

Create Crypto Withdrawal

Testing Env
https://stage-api.fintegence.io
Testing Env
https://stage-api.fintegence.io
POST
/v1/partner/crypto-withdrawal
Initiates a cryptocurrency withdrawal from the partner balance to an external blockchain address.
This endpoint is used for sending funds to personal wallets, exchanges, or business partners. The request must include currency, amount, destination wallet address, and required compliance information. If the request is valid, the withdrawal is queued for processing and a withdrawal ID is returned immediately.
Actual transfer and all compliance checks are performed asynchronously. The network fee is deducted from the balance in addition to the withdrawal amount. You can track the status and outcome using Get Crypto Withdrawal Details.

Key Integration Details#

Asynchronous Processing: A successful response only means the request was accepted and queued.
Status Updates: Use webhooks for real-time notifications or poll Get Crypto Withdrawal Details.
Balance Deduction: The network fee is charged in addition to the withdrawal amount.
Travel Rule: Recipient compliance fields such as name, walletType, and receiverType are mandatory.
Asynchronous Processing
Business logic errors such as insufficient funds are not checked immediately.
The API accepts the request and schedules it for processing. Verify the final status and any errors via Get Crypto Withdrawal Details.
Network Accuracy is Critical
Ensure the correct network is selected before submitting the withdrawal. Sending assets to an unsupported network or incompatible address may result in permanent loss of funds.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢201Created
application/json
Bodyapplication/json

🟠401Access Denied
🟠400P403: Validation error
🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stage-api.fintegence.io/v1/partner/crypto-withdrawal' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "currency": "eth",
  "amount": 0.006,
  "walletAddress": "0xc0e8FDbaF02688B060C9f3be5De041BD8149EDE4",
  "memo": "Transaction to savings wallet",
  "name": "Acme Corp",
  "walletType": "CUSTODIAL",
  "receiverType": "LEGAL"
}'
Response Response Example
201 - Success
{
    "withdrawalId": "9e4923bf-575b-470c-9d72-1c96fd594d40"
}
Previous
Get Network Fee
Next
Get Crypto Withdrawal Details
Built with