Create Withdrawal — THB
ถอนเป็นบาท เข้าบัญชีธนาคารปลายทาง
This withdrawal now supports PromptPay
Just set receiver_bank to "PromptPay"
ใช้ API นี้กับระบบ P2P ได้ — แต่ต้องเป็น PromptPay เท่านั้น
ดูไทม์ไลน์ของรายการถอนแบบ P2P, การแบ่งเป็นรายการย่อยให้ผู้ฝากหลายราย และบัญชีบริษัทที่โอนแทนเมื่อได้รับชำระไม่ครบ ที่หน้า P2P Flow
https://testnet.trustsig.xyz/v1/withdrawal/createRequest/fiatAuthentication Status
API Key is required for all requests Webhook Secret
Headers
x-api-keyYour shop API key
x-signatureHMAC-SHA256 of timestamp|method|fullUrl|body signed with your secret key, sent as 64 hex characters
How to create the signaturex-timestampCurrent Unix time in milliseconds — must be the same value used to create x-signature
Parameters (Request Body)
withdrawal_modeWithdrawal type. Optional — this endpoint always records it as "FIAT". If you send it, it must be "FIAT".
order_idA 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_referenceYour own reference for the end user, e.g. a member or player ID. It is stored with the withdrawal and checked against the withdrawal block list; a blocked request gets error 10051.
amountWithdrawal amount in THB. Must be a whole multiple of 100, e.g. 500 or 1100. Amounts such as 567 or 1105 are rejected with error 10067. Each request must also stay within the per-request ceiling (50,000 THB by default, error 10044) and at or above the minimum set for your shop (error 10028).
currencyWithdrawal currency. Only "THB" is accepted.
receiver_bankDestination bank code, e.g. "SCB" (case-insensitive), or the bank's 3-digit number such as "022" for CIMB. Set "PromptPay" to withdraw via PromptPay — this single field decides the payout rail. An unknown code returns 422 with the list of accepted codes (live list: GET /v1/ebank/bankConfig).
receiver_nameName of the destination account holder. Validation counts only Thai and English letters, spaces and dots (1–200 characters after that), but the name is stored exactly as sent — send the plain account name.
withdrawal_addressDestination bank account number, or the PromptPay number when receiver_bank is "PromptPay". Validation looks at the digits only, and a bank account number must have exactly as many digits as that bank uses (e.g. 10 for SCB). Send digits only, because the value is stored as sent.
promptpay_id_typePromptPay number type. Use it only when receiver_bank is "PromptPay"; sending it with any other bank returns 422. Leave it out (or send null / "") and the system detects the type from withdrawal_address. NATID and TAXID are interchangeable, but a type that contradicts the number (e.g. MSISDN with a 13-digit ID) returns 422.
chainNot used for THB withdrawals, so it is optional. Whatever you send, the withdrawal is recorded with chain "offchain".
asset_typeNot used for THB withdrawals, so it is optional. Whatever you send, the withdrawal is recorded with asset_type "native".
additionalOptional JSON object for your own data, such as a note or your user ID. It is stored with the withdrawal and returned in the withdrawal data.
PromptPay
The same endpoint supports PromptPay withdrawals — set receiver_bank to "PromptPay" (case-insensitive) and put the PromptPay number in withdrawal_address. The system reads its format for you.
| Accepted number | Format |
|---|---|
| Thai mobile phone | 10 digits, starts with 06, 08, or 09 |
| Thai citizen national ID | 13 digits (mod-11 checksum) |
| Thai juristic tax ID | 13 digits (mod-11 checksum) |
| BOT-issued e-wallet ID | 15 digits, digits only |