PayMe via Adyen
This feature is currently a Private Beta release. Contact Chargebee Support to enable PayMe via Adyen for your live and test sites.
PayMe is a popular QR-code-based mobile payment method in Hong Kong. Chargebee supports PayMe as a payment method via the Adyen payment gateway.
When customers select PayMe at checkout, a QR code is displayed for them to scan using the PayMe app. Payment is completed instantly after the customer scans and authorises the payment, and the final status is confirmed via Adyen webhooks.
Supported countries and currencies
PayMe via Adyen supports the following countries and currencies:
| Country | Currency |
|---|---|
| Hong Kong | HKD |
Prerequisites
To accept PayMe payments using Chargebee, you must:
- Have an active Adyen account with PayMe enabled as a payment method in your Adyen Customer Area.
- Ensure HKD (Hong Kong Dollar) currency is enabled for your Chargebee account.
- Ensure the Adyen payment gateway and webhooks are configured in your Chargebee account. Learn more
Integration options
You can integrate PayMe via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept PayMe payments with minimal integration effort. |
| Chargebee JS | Embed PayMe as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate PayMe using Chargebee APIs for a fully custom checkout and payment flow. |
Supported tokens
This integration supports the following set of tokens:
| Token | Description | Format and Sample |
|---|---|---|
| Chargebee Payment Intent ID | This is the Payment Intent ID returned after a successful authorization process using Chargebee JS. | Format: payment_intent[id] |
Configure PayMe in Chargebee
Follow these steps to configure PayMe via Adyen in your Chargebee site:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Select the relevant Adyen instance from the list.
- On the Configure Adyen page, ensure PayMe is enabled under the list of supported payment methods.
- Click Apply to save changes.
Note
PayMe availability depends on your Adyen merchant configuration.
Configure smart routing for PayMe
When you configure PayMe through Adyen, smart routing for the HKD currency is automatically enabled. Check the Smart Routing settings, and if any other gateway is already designated for the HKD currency, adjust the Smart Routing settings manually to allocate PayMe to it.
Follow these steps to modify Smart Routing settings:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Click Manage Rules under Smart Routing.
- Go to the PayMe section and click Add a Gateway for HKD. If you already have a payment gateway assigned to it, click Edit.
- From the Choose a payment gateway drop-down menu, select the relevant Adyen instance with PayMe enabled.
- Click Save.
Enable PayMe to pay for subscriptions
PayMe is a one-time payment method and cannot be used for recurring payments. To use it for subscriptions, configure your Chargebee site to allow all one-time payment methods for subscriptions.
Note
While testing, ensure Allow customers to pay for subscriptions with payment methods that only support one-time payments and One-time Payments - Enable button are enabled under Settings > Configure Chargebee > Checkout & Self-Serve Portal.
Follow these steps to enable one-time payment methods for subscriptions:
- In the Chargebee app, go to Settings > Configure Chargebee > Checkout & Self-Serve Portal.
- Select the Configuration tab and enable Allow customers to pay for subscriptions with payment methods that only support one-time payments.
Checkout flow
Your customer performs the following steps during checkout using PayMe via Adyen:
- Initiate checkout and proceed to the payment step.
- Select PayMe as the payment method.
- A PayMe QR code is displayed in the checkout.
- Scan the QR code using the PayMe app and authorise the payment.
- Once payment is authorised, you are redirected back to the merchant's website.
Testing
Sandbox testing
- Use the gateway's sandbox environment with PayMe enabled.
- Testing involves generating QR codes via API and simulating customer scan and approval flows (if supported).
- Payment outcomes are controlled via gateway test configurations and API-triggered responses or webhook simulations.
Note
QR-based methods like PayMe typically do not support amount-based outcome simulation.
Production testing
Before going live:
- Ensure PayMe is enabled in your Adyen account.
- Verify webhook configuration is complete (mandatory for payment status updates).
- Perform end-to-end testing using a real PayMe-enabled wallet account and scan the QR code using a mobile device.
Reconciliation
For financial reconciliation between Chargebee and Adyen:
- Use the Chargebee transaction field id_at_gateway, which maps to the gateway transaction reference ID returned for the PayMe payment.
Follow these steps to reconcile transactions:
- Retrieve the id_at_gateway value from the Chargebee transaction details.
- Locate the corresponding transaction in the gateway dashboard or reports.
- Match using the gateway's reference identifier.
Limitations and important points
- PayMe cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the QR-based PayMe payment flow.
- PayMe does not support storing payment methods for recurring billing. Each transaction requires explicit customer action (QR scan and approval).
- PayMe is not suitable for automatic subscription renewals or merchant-initiated transactions. To collect payments for subscriptions using PayMe, send email notifications with a Pay Now link when a new invoice is generated.
- PayMe payments are non-reversible push payments. Chargebacks are not supported. Refunds must be handled manually via refund APIs.
- PayMe is exclusively available for HKD (Hong Kong Dollar) transactions.
Was this article helpful?