Skip to main content
POST
/
partners
/
orders
/
withdrawal
{
  "amount": "100",
  "currency": "usd",
  "chain_id": 56,
  "token_address": "0x55d398326f99059ff775485246999027b3197955",
  "callback": "https://yourapp.com/api/webhooks/payment",
  "reference_no": "WITHDRAW-001",
  "buffer": 0.005,
  "payment_info": {
    "bank_id": 1,
    "full_name": "NGUYEN VAN A",
    "account_type": 1,
    "account_number": "1234567890"
  }
}
{
  "message": "success",
  "data": {
    "order": {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "code": 100002,
      "order_type": 2,
      "state": 2,
      "processing_state": 20,
      "amount": "100",
      "currency": "usd",
      "rate": "25750",
      "token_address": "0x55d398326f99059ff775485246999027b3197955",
      "chain_id": 56,
      "recipient": "0xABCD...1234",
      "reference_no": "WITHDRAW-001",
      "fees": {
        "service_fee": 0.01,
        "min_fee": 5000
      },
      "total_fee_vnd": 25750,
      "callback": "https://yourapp.com/api/webhooks/payment"
    }
  }
}

Overview

Create a new withdrawal order to sell tokens for VND. The user will transfer tokens to the provided recipient address, and Holdstation Pay will send VND to the user’s bank account.
amount
string
required
Amount to withdraw in USD.
currency
string
required
Currency of the amount: vnd or usd.
chain_id
integer
required
Blockchain network ID.
token_address
string
required
Token contract address.
callback
string
required
Callback URL for receiving withdrawal updates via webhooks.
reference_no
string
required
Reference number for the withdrawal.
buffer
number
required
Optional buffer rate override (fractional). If set, effective buffer = max(override, configured buffer). Example: 0.005 = 0.5%.
payment_info
object
required
Payment information for the withdrawal.
{
  "amount": "100",
  "currency": "usd",
  "chain_id": 56,
  "token_address": "0x55d398326f99059ff775485246999027b3197955",
  "callback": "https://yourapp.com/api/webhooks/payment",
  "reference_no": "WITHDRAW-001",
  "buffer": 0.005,
  "payment_info": {
    "bank_id": 1,
    "full_name": "NGUYEN VAN A",
    "account_type": 1,
    "account_number": "1234567890"
  }
}
{
  "message": "success",
  "data": {
    "order": {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "code": 100002,
      "order_type": 2,
      "state": 2,
      "processing_state": 20,
      "amount": "100",
      "currency": "usd",
      "rate": "25750",
      "token_address": "0x55d398326f99059ff775485246999027b3197955",
      "chain_id": 56,
      "recipient": "0xABCD...1234",
      "reference_no": "WITHDRAW-001",
      "fees": {
        "service_fee": 0.01,
        "min_fee": 5000
      },
      "total_fee_vnd": 25750,
      "callback": "https://yourapp.com/api/webhooks/payment"
    }
  }
}