Accept a PromptPay payment
Accept payments with PromptPay, an instant funds transfer service in Thailand.
Caution
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
PromptPay is a single-use payment method where customers pay with PromptPay by scanning the QR code that they see during checkout. Completing the payment redirects customers back to your website.
Determine compatibility
A Checkout Session must satisfy all of the following conditions to support PromptPay payments:
- Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
- You can only use one-time line items (PromptPay Checkout Sessions don’t support recurring subscription plans).
Accept a payment
Note
This guide builds on the foundational accept a payment Checkout integration.
This guides you through enabling PromptPay and shows the differences between accepting a card payment and using PromptPay.
Enable PromptPay as a payment method
When creating a new Checkout Session, you need to:
- Add
promptpay
to the list ofpayment_
method_ types - Make sure all your
line_
use the same currencyitems
Fulfill your orders
After accepting a payment, learn how to fulfill orders.
Test your integration
When testing your Checkout integration, select PromptPay as the payment method and click the Generate QR code button, which creates and renders a QR code.
In test mode, scan the QR code with a QR code scanning application on your mobile device. The QR code payload contains a URL which brings you to a Stripe-hosted PromptPay test payment page where you can either authorize or fail the test payment.
In live mode, you will be able to scan the QR code using a preferred banking app or payment app that supports PromptPay.