Skip to main content

Introduction

PromptPay uses a redirect-based payment flow. When a customer selects PromptPay at checkout, they are redirected to a hosted page where they can complete the payment using their preferred Thai banking app. Once payment is confirmed, the customer returns to your website or app. This guide explains the process of integrating PromptPay into your app or website using Payrails.

Pre-requisites

Before you start accepting PromptPay payments with Payrails, there are a few requirements you must meet:

Ways to integrate PromptPay

Payrails SDK

Server-to-server integration

Parse PromptPay from lookup response

Pass PromptPay payment method in request to authorize payment with Payrails

Note on amountsTHB uses 2 decimal places. Amounts should be provided in the smallest currency unit—for example, 50000 for ฿500.00.
PromptPay is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to a hosted page to complete payment via their banking app. Once confirmed, the customer will be redirected back to the returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.

Handle the redirect response

Supported currencies

PromptPay via dLocal supports the following presentment currency:
  • THB — Thai Baht

Supported regions / countries

Supported workflows and services

Last modified on September 28, 2026