Payment gateway in Thailand: how to accept PromptPay and TrueMoney on your website
How Thai buyers pay online, how a payment gateway handles PromptPay and TrueMoney from QR code to webhook, the risks to watch and a checklist for choosing a provider.
5 min de leitura
Este artigo ainda não está disponível em Português. Ele é exibido em English.
Também disponível em: ไทย
If you sell online to customers in Thailand, one payment method is a must: PromptPay. Many Thais pay by scanning a QR code with their banking app rather than using a credit card, and many others use TrueMoney Wallet. A website that only takes cards misses a large share of Thai buyers.
This guide explains how Thai buyers pay online, how a payment gateway handles PromptPay and TrueMoney, which risks to watch and how to choose a provider.
What is PromptPay?
PromptPay is Thailand's national real-time transfer and payment service, promoted by the Bank of Thailand. Users link their account to a phone number or national ID and pay by scanning a Thai QR Payment code from almost any banking app. Money arrives within seconds, 24 hours a day.
| Method | How it works | For whom |
|---|---|---|
| PromptPay QR | The customer scans a QR with a banking app; the amount is pre-filled | Bank customers (almost everyone) |
| TrueMoney Wallet | Paid from the wallet by QR or app switch | Wallet users |
| Cards | Debit or credit cards | People who use cards online |
The problem with manual transfers
Many shops still ask customers to transfer to a personal account and send a slip. That causes three problems:
- Hard reconciliation: hundreds of transfers a day, and no way to tell who paid which order.
- Fake slips: edited slips or transfers that never completed.
- Slow delivery: orders wait for someone to check slips, especially at night.
How a payment gateway handles it
| Step | What happens | Who does it |
|---|---|---|
| 1. Create a payment | Your website asks the gateway for a charge for the order amount | Your server, via API |
| 2. Show the QR | The gateway returns a dynamic PromptPay QR with the amount and a unique reference | Gateway → your checkout |
| 3. Customer pays | Scans with a banking or wallet app and confirms | Customer |
| 4. Confirmation | The bank or wallet confirms to the gateway | Bank/wallet → gateway |
| 5. Webhook | The gateway sends a signed webhook: this order is paid | Gateway → your server |
| 6. Fulfilment | Your system marks the order paid and delivers or credits a balance | Your server |
| 7. Settlement | Paid funds become available to withdraw | Gateway → your account |
The key is a unique reference per order: when money arrives, the gateway knows which order it belongs to — no checking slips by hand.
Risks and how to handle them
Fake slips. Simple rule: never deliver on a slip or screenshot, only when the webhook confirms.
Wrong amounts. A dynamic QR locks the amount, so this problem almost disappears.
Expired payments. A customer opens an old QR after it expired. Create a new charge instead of reusing the old code.
Missed webhooks. If your server is down you can miss a confirmation. Choose a gateway that retries webhooks and offers a status API, and handle webhooks idempotently so nothing is credited twice.
For gaming, trading and digital goods
- Gaming and top-ups: credit the balance as soon as the webhook arrives.
- Trading platforms: take deposits in THB with a clear record of every payment.
- Digital goods: deliver codes, vouchers and subscriptions right after confirmation.
Checklist for choosing a gateway in Thailand
- Dynamic PromptPay QR with a unique reference per order.
- TrueMoney Wallet for wallet users.
- Signed webhooks with retries, and a status API.
- A sandbox to simulate paid, failed and expired payments.
- Clear fees, nothing on failed payments.
- Settlement that suits you: local account, foreign account or stablecoins.
- Reports with gross, fee and net per payment.
- One API for several countries if Thailand is one of several markets.
Step by step
- Create a merchant account and add your website.
- Create a sandbox API key and keep it on your server only.
- Set your webhook URL and save the secret.
- At checkout, create the charge by API with the amount and your own order reference.
- Show the QR, or open the wallet on mobile.
- Verify each webhook's signature and mark the order paid only once.
- Test every outcome in the sandbox, then switch to a live key.
How PAYWISE handles Thailand
PAYWISE is an API-first payment platform. Indonesia (QRIS) and crypto payments are live today, and Thailand (PromptPay and TrueMoney) opens on request: merchants who ask first are prepared first. When Thailand opens for your account, you keep the same API, webhooks and dashboard as everywhere else.
See the Thailand page and send a request in two minutes.
Frequently asked questions
What is the difference between PromptPay and Thai QR? PromptPay is the real-time transfer service; Thai QR Payment is the QR standard used to pay through PromptPay from banking apps.
How fast is a PromptPay payment? Usually a few seconds, 24 hours a day, holidays included.
Can a customer cancel a completed transfer? Not like a card chargeback. Refunds are made by the merchant with a new transfer.
Can a foreign company get paid in Thailand? Yes, through a provider that collects in Thailand and settles to you. Ask how funds are settled and converted.
Sources: Bank of Thailand — PromptPay, TrueMoney. This article is general information, not legal or financial advice.

