Create Payment — Fiat → Crypto

รับฝาก THB ผ่าน PromptPay/โอนธนาคาร และ convert เป็น USDT

THB USDT auto_convert

ตั้ง auto_convert: true และ convert_to: "USDT" ปัจจุบันรองรับ pair USDT ↔ THB

POSTCreate Fiat → Crypto Payment

Endpoint URL

https://testnet.trustsig.xyz/v1/payment/createInvoicePayment/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)

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.

order_user_reference

string Required

Customer Name

payment_method_type

enum Required

Payment Method

amount

string Required

Amount

from_currency

string Required

สกุลที่ลูกค้าจ่าย

to_currency

string Required

สกุลที่รับฝากเข้าระบบ

payer_bank_provider

string Required

Bank Transfer

payer_bank_account_number

string Required

Account Number

payer_bank_account_name

string Required

Account Name

Convert

auto_convert

boolean Required

ต้องเป็น true เพื่อเปิด convert THB → USDT อัตโนมัติ

Convert

convert_to

enum Required

สกุลที่ merchant จะได้รับหลัง convert (USDT เท่านั้น)

payment_domain

string Required

โดเมนของระบบชำระเงิน

url_return

string Required

Redirect URL

url_success

string Required

Redirect URL

url_failed

string Required

Redirect URL

Request Example

cURL

curl --location 'https://testnet.trustsig.xyz/v1/payment/createInvoicePayment/fiat' \
  --request POST \
  --header 'x-api-key: $SIGNATURE_API_KEY' \
  --header 'x-signature: $SIGNATURE' \
  --header 'x-timestamp: $TIMESTAMP' \
  --header 'Content-Type: application/json' \
  --data '{
    "order_id": "ORDER-DEMO-001",
    "order_user_reference": "12345",
    "payment_method_type": "PROMPTPAY_QR",
    "amount": "1000",
    "from_currency": "THB",
    "to_currency": "THB",
    "payer_bank_provider": "SCB",
    "payer_bank_account_number": "4052512594",
    "payer_bank_account_name": "รณชิต ราโช",
    "auto_convert": true,
    "convert_to": "USDT",
    "payment_domain": "https://app.wpayz.xyz",
    "url_return": "http://example.com/home_page",
    "url_success": "http://example.com/success_page",
    "url_failed": "http://example.com/failed_page"
}'

Response Example

200 OK Response

{
  "data": {
    "id": "f5f0e968-95aa-4939-9b97-a38ae03a3d68",
    "source_id": "wpayz",
    "order_id": "ORDER-DEMO-001",
    "payment_method_type": "PROMPTPAY_QR",
    "invoice_type": "FIAT",
    "from_currency": "THB",
    "to_currency": "THB",
    "auto_convert": true,
    "convert_to": "USDT",
    "chain": "offchain",
    "network": "mainnet",
    "amount": "1000",
    "payment_amount": 1000,
    "merchant_amount": 31.77,
    "merchant_currency": "USDT",
    "exchange_rate": 31.4728,
    "exchange_rate_source": "BINANCE_TH",
    "lifetime": 900,
    "expired_at": "2026-05-22T19:38:02.695Z",
    "payment_url": "https://app.wpayz.xyz/pay/f5f0e968-95aa-4939-9b97-a38ae03a3d68",
    "payment_qr": "00020101021229370016A000000677...",
    "payment_status": "PAYMENT_CHECKING",
    "status": "PENDING",
    "created_at": "2026-05-22T19:23:02.773Z"
  },
  "success": true,
  "code": 0
}