Payment-method icon

PayMe Component

Add PayMe QR to an existing Components integration.

This page explains how to add PayMe to your existing Web Components integration.

Depending on whether your shopper is using a desktop or laptop, or the browser on their mobile device, the Component:

  • Shows the shopper a QR code which they can scan to pay using their PayMe app.
  • Redirects the shopper to the PayMe app on their mobile device.

Implement both flows to make sure that your shoppers can pay on different devices.

PayMe is supported from Web Components version 5.56.0.

Requirements

Select the server-side flow that your integration uses:

Requirement Description
Integration type Make sure that you have built a Sessions flow Web Components integration.
Setup steps Before you begin, add PayMe in your Customer Area.

Import resources for v6

If you are using Web Components v6, import the Component that you need for PayMe:

Copy code
import { AdyenCheckout, PayMe } from '@adyen/adyen-web'

API reference

Select which endpoint you are using:

This is the default with Components v5.0.0 or later.

Parameter name Required Description
channel To determine whether the shopper is using a desktop, laptop or mobile.
lineItems.quantity The number of items. Must be between 0 and 9999.
lineItems.sku The stock keeping unit. Maximum length 200 characters. Available if you use Checkout API v70 and later.
lineItems.description The order description to display to the shopper. Maximum length 200 characters.
lineItems.amountIncludingTax Item amount including the tax, in minor units. Must be between 1 and 100000000.
lineItems.itemCategory The item category. Maximum length 200 characters.
Expand view
Copy link to code block
Copy code
Copy code
curl https://checkout-test.adyen.com/v71/payments \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
"paymentMethod": {
"type": "payme"
},
"amount": {
"currency": "HKD",
"value": 4200
},
"countryCode": "HK",
"merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
"reference": "YOUR_ORDER_REFERENCE",
"returnUrl": "https://your-company.com/...",
"channel":"Web",
"lineItems": [
{
"quantity": "1",
"sku": "3232",
"description": "Shoes",
"amountIncludingTax": 4200,
"itemCategory": "Fashion"
}
]
}'

See the Web Components integration guide to get the payment outcome and show your shopper the result of the payment.

Component configuration

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

Copy code
 <div id="payme-container"></div>

Step 2: Create an instance of the Component

v6.0.0 or later

Create an instance of the Component, passing:

  • Your instance of AdyenCheckout.
Copy code
const payMe = new PayMe(checkout).mount('#payme-container');

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

Copy code
const payMeComponent = checkout.create('payme').mount('#payme-container');

Test and go live

Use the PayMe sandbox to test your integration. You do not need to use the PayMe app to test using the sandbox.

Use the amounts specified below to simulate different payment outcomes.

Amount ending in Result Description
30 or 81 Authorised Successful payment.
77 or 90 OfferCancelled The payment request expired after PayMe's default expiry time of ten minutes.
40 or 44 Error There was an error when creating the payment request.