PAYWISE
← Semua artikel

Panduan

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 bacaan

Artikel ini belum tersedia dalam Bahasa Melayu. Ia dipaparkan dalam English.

Juga tersedia dalam: ไทย

Payment gateway in Thailand: how to accept PromptPay and TrueMoney on your website

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:

  1. Hard reconciliation: hundreds of transfers a day, and no way to tell who paid which order.
  2. Fake slips: edited slips or transfers that never completed.
  3. 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

  1. Dynamic PromptPay QR with a unique reference per order.
  2. TrueMoney Wallet for wallet users.
  3. Signed webhooks with retries, and a status API.
  4. A sandbox to simulate paid, failed and expired payments.
  5. Clear fees, nothing on failed payments.
  6. Settlement that suits you: local account, foreign account or stablecoins.
  7. Reports with gross, fee and net per payment.
  8. One API for several countries if Thailand is one of several markets.

Step by step

  1. Create a merchant account and add your website.
  2. Create a sandbox API key and keep it on your server only.
  3. Set your webhook URL and save the secret.
  4. At checkout, create the charge by API with the amount and your own order reference.
  5. Show the QR, or open the wallet on mobile.
  6. Verify each webhook's signature and mark the order paid only once.
  7. 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.

Lagi artikel

Mulakan hari ini dengan kunci sandbox.

Buat akaun, jana kunci sandbox dan hantar transaksi pertama anda dari playground dalam beberapa minit.