Logo

Payment

API Documentation

Create (fiat/crypto)

Create a new withdrawal request

POSTCreate (fiat/crypto)
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 for authentication

x-signature
Required

HMAC-SHA256 signature for authentication

x-timestamp
Required

Timestamp (milliseconds) for signature

Parameters (Request Body)

withdrawal_mode
string Required

Withdrawal Status

order_id
string Required

A unique order reference ID from your system (e.g., mystore_order_1234, uuid). Please use the same Order ID for the same transaction and do not generate a new one.

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 'Content-Type: application/json' \
--header 'x-api-key: $SIGNATURE_API_KEY' \
--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",
    "withdrawal_mode": "FIAT",
    "receiver_bank": "SCB",
    "receiver_name": "MR. John Snow",
    "currency": "THB",
    "address": "9999999999",
    "amount": "100",
    "chain": "offchain",
    "asset_type": "native",
    "network": "testnet",
    "fee_model_type": "PERCENTAGE",
    "fee": 0,
    "fee_amount": 0,
    "realized_amount": 100,
    "tx_value": 3.0983145,
    "exchange_rate": 0.030829,
    "withdrawal_status": "PENDING",
    "additional": {
      "description": "test withdrawal",
      "reference_user_id": 123
    },
    "created_at": "2025-10-08T19:38:18.586Z"
  },
  "success": true,
  "code": 0
}