Documentation

API Reference & Integration Guide

API Available

Create Withdrawal

Create a new withdrawal request

POSTCreate Withdrawal
Endpoint URL
https://testnet.trustsig.xyz/v1/withdrawal/createRequest/fiat

⚙️Authentication Status

⚠️ API Key is required for all requests Webhook Secret

🔑

Headers

x-api-key
Required

API Key is required for all requests

Accept-Language
Optional

Select Language

Content-Type
Required

Format

📖

Parameters (Request Body)

withdrawal_mode
string Required

Withdrawal Status

order_id
string Required

Withdrawal Reference

amount
number Required

Withdrawal Amount

currency
string Required

Currency

receiver_bank
string Required

Bank Name

receiver_name
string Required

Recipient

withdrawal_address
string Required

Account Number

chain
string Required

Type

asset_type
string Required

Type

additional
object Required

Metadata

Request Example

Terminal
curl --location 'https://testnet.trustsig.xyz/v1/withdrawal/createRequest/fiat' \
--header 'Accept-Language: en' \
--header 'Content-Type: application/json' \
--header 'x-api-key: key_3fGmFBVVwXjKHNnNW9WEu2npQuMS' \
--data '{
    "withdrawal_mode": "FIAT",
    "order_id": "ORDER-123456789",
    "amount": 10.5, 
    "currency": "THB", 
    "receiver_bank": "SCB", 
    "receiver_name": "MR. John Snow", 
    "withdrawal_address": "9999999999",  
    "chain": "offchain", 
    "asset_type": "native", 
    "additional": {
        "description": "test withdrawal",
        "reference_user_id": 123
    }
}'

Response Example

200 OK
JSON Response
{
  "data": {
    "id": "650c44b0-7371-4e73-a766-d3216b87e7a2",
    "seq_num": 489,
    "source_id": "wpayz",
    "unique_hash": "8f1a9c432af55a04f606458cdabf3a77ce01f28bebe6d059b0caa07d064ed5b2",
    "order_id": "ORDER-12345678111",
    "order_user_reference": null,
    "request_platform": "API",
    "request_ip": null,
    "withdrawal_mode": "FIAT",
    "receiver_bank": "SCB",
    "receiver_name": "MR. John Snow",
    "currency": "THB",
    "address": "9999999999",
    "amount": "100",
    "chain": "offchain",
    "asset_type": "native",
    "token_address": null,
    "network": "testnet",
    "fee_model_type": "PERCENTAGE",
    "fee": 0,
    "fee_amount": 0,
    "extra_fee_network": 0,
    "realized_amount": 100,
    "tx_value": 3.0983145,
    "fx_rate": {
      "AED": 11.38,
      "CNY": 22.058,
      "EUR": 2.643,
      "GBP": 2.3,
      "HKD": 24.11,
      "IDR": 51614.692,
      "INR": 274.661,
      "JPY": 456.108,
      "KRW": 4345.123,
      "RUB": 255.6,
      "SGD": 3.992,
      "THB": 100.5,
      "USD": 100.5
    },
    "exchange_rate": 0.030829,
    "exchange_rate_raw": {
      "id": "37a0c593-820e-4853-bc09-2f2c24f5ef61",
      "route_path": "2ad58acdc01e8c5c1e83f6f6ca30b8ae936bfc19",
      "symbol": "USD",
      "base_pair": "THB",
      "value": "0.03082900",
      "timestamp": "2025-10-01T16:19:15.000Z",
      "source": "Fixer.io",
      "type": "FIAT",
      "created_at": "2025-03-27T08:10:05.652Z"
    },
    "operator_id": null,
    "operator_type": "NO_OPERATOR",
    "approved_at": null,
    "callback_url": null,
    "callback_data": null,
    "lifetime": 300,
    "http_status": null,
    "request_data": null,
    "response_data": null,
    "whitelist_address_id": null,
    "ebank_account_id": null,
    "transfer_payloads": null,
    "admin_notes": null,
    "rejected_reason": "UNKNOWN",
    "additional": {
      "description": "test withdrawal",
      "reference_user_id": 123
    },
    "last_updated_by": null,
    "last_updated_at": "2025-10-08T19:38:18.586Z",
    "withdrawal_status": "PENDING",
    "pending_transaction_id": null,
    "is_settlement": false,
    "webhook_request_id": null,
    "sequence_time": "2025-10-08T19:38:18.586Z",
    "created_at": "2025-10-08T19:38:18.586Z",
    "owned_by_group": "5a5e6247-d7c3-4b86-b67d-dab9a052653d",
    "owned_by_group_parent": "1990a106-c97f-4c8f-b751-12879d931bdc",
    "organization_id": "5f5a3ae8-6fa4-47fd-bb4f-231935a32eb8",
    "agent_id": "c5688e45-584f-4d54-8fbe-b07179034917"
  },
  "success": true,
  "code": 0
}