Skip to main content
PromptPay is the national instant payment network in Thailand. Customers pay by scanning a QR code with the banking app of a participating Thai bank. Payrails processes PromptPay through dLocal as the payment service provider (PSP). Open the dLocal guide below for its setup steps and request examples.

​
How a PromptPay payment works

PromptPay is a redirect QR payment method:
  1. The customer selects PromptPay at checkout.
  2. Payrails returns a redirect URL from dLocal, and the customer goes to a hosted page that shows a QR code.
  3. The customer scans the QR code with their banking app and confirms the payment.
  4. dLocal sends the customer back to your returnInfo URL.
  5. Payrails receives the final result from dLocal and updates the payment.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures PromptPay payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

PromptPay supports THB (Thai baht) as its only presentment currency.

​
Integrate PromptPay

The dLocal guide covers the setup in dLocal and in Payrails, plus the request fields dLocal requires.

dLocal

PromptPay via dLocal

​
Check PSPs

Each PromptPay payment is a new customer-initiated payment.

​
Ways to integrate PromptPay

  • Payrails SDK: the Web SDK shows PromptPay when your workflow returns it as a payment option, and redirects the customer to the QR code page. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with promptPay as the paymentMethodCode. The dLocal guide lists the meta fields dLocal requires.
In both cases, confirm the final result through webhook notifications or the execution status. Don’t treat the customer’s return to your success URL as proof of payment.
Last modified on October 5, 2026