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 the server-side flow that your integration uses:
Requirement | Description |
---|---|
Integration type | Make sure that you have built a Sessions flow integration. |
Setup steps | Before you begin, contact our Support Team to add in your Customer Area. |
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
.
- Pass
data.paymentMethod
to your server. -
From your server, make a /payments request, specifying:
paymentMethod
: Thedata.paymentMethod
from thedidSubmit
event from your client app.
Expand viewCopy link to code blockCopy codecurl https://checkout-test.adyen.com/v69/payments \ -H 'x-api-key: ADYEN_API_KEY' \ -H 'content-type: application/json' \ -d '{ "merchantAccount": "YOUR_MERCHANT_ACCOUNT", "amount": { "currency": "THB", "value": 10000 }, "paymentMethod": { "type": "promptpay" }, "reference": "YOUR_ORDER_NUMBER" }' 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:
eventCode | success field | Description | Action to take |
---|---|---|---|
AUTHORISATION | false | The transaction failed. | Cancel the order and inform the shopper that the payment failed. |
AUTHORISATION | true | The shopper successfully completed the payment. | Inform the shopper that the payment has been successful and proceed with the order. |
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.