PromptPay Drop-in integration

Our iOS Drop-in renders PromptPay in your payment form, and generates a QR code that the shopper uses to pay with their choice of app from PromptPay participating banks.

Requirements

Select which endpoint you are using:

Show PromptPay in your payment form

Drop-in uses the countryCode and the amount.currency from your /paymentMethods request to show the available payment methods to your shopper.

To show PromptPay in your payment form, you need to specify in your /paymentMethods request:

• countryCode: TH
• amount.currency: THB
• amount.value: The value of the payment.

After the shopper selects a payment method and provides payment details, Drop-in invokes the didSubmit method which contains data.paymentMethod. Pass data.paymentMethod to your server and make a payment request.

Make a payment

When the shopper proceeds to pay, Drop-in invokes the didSubmit method which contains data.paymentMethod.

1. Pass data.paymentMethod to your server.

2. From your server, make a /payments request, specifying:

   • paymentMethod: The data.paymentMethod from the didSubmit event from your client app.

   Drop-in generates the QR code that the shopper uses to pay.

Show the payment result

Use the resultCode from the /payments/details response to show the payment outcome on your frontend.

You will also receive the outcome of the payment asynchronously in a webhook.

The resultCode values you can receive for PromptPay are:

Test and go live

Test PromptPay payments with real payment details and small amounts.

Check the status of your test PromptPay payments in your Customer Area > Transactions > Payments.

To accept live PromptPay payments, you must contact our Support Team to add PromptPay in your live Customer Area.

See also