Create Payment — Fiat (THB)

สร้างคำขอชำระเงินผ่าน PromptPay QR หรือโอนผ่านธนาคาร

THB THB

POSTCreate Fiat 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

สกุลที่ merchant ได้รับ

payer_bank_provider

string Required

Bank Transfer

payer_bank_account_number

string Required

Account Number

payer_bank_account_name

string Required

Account Name

payment_domain

string Required

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

url_return

string Required

Redirect URL

url_success

string Required

Redirect URL

url_failed

string Required

Redirect URL

additional_data

object Optional

Metadata

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": "100.5",
    "from_currency": "THB",
    "to_currency": "THB",
    "payer_bank_provider": "SCB",
    "payer_bank_account_number": "4052512594",
    "payer_bank_account_name": "รณชิต ราโช",
    "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",
    "additional_data": {
        "description": "test create payment"
    }
}'

Response Example

200 OK Response

{
  "data": {
    "id": "f5f0e968-95aa-4939-9b97-a38ae03a3d68",
    "seq_num": 2206,
    "source_id": "wpayz",
    "order_id": "ORDER-DEMO-001",
    "order_user_reference": "12345",
    "order_display_mode": "FIAT",
    "payment_method_type": "PROMPTPAY_QR",
    "payment_provider": "EBANK",
    "invoice_type": "FIAT",
    "from_currency": "THB",
    "to_currency": "THB",
    "chain": "offchain",
    "network": "mainnet",
    "amount": "100.5",
    "payment_amount": 100.71,
    "payer_bank_provider": "SCB",
    "payer_bank_account_number": "4052512594",
    "payer_bank_account_name": "รณชิต ราโช",
    "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...",
    "auto_convert": false,
    "payment_status": "PAYMENT_CHECKING",
    "status": "PENDING",
    "created_at": "2026-05-22T19:23:02.773Z"
  },
  "success": true,
  "code": 0
}