GrabPay via Adyen
This feature is currently a Private Beta release. Contact Chargebee Support to enable GrabPay via Adyen for your live and test sites.
GrabPay is a widely used digital wallet across Southeast Asia that allows customers to complete payments using their Grab account. Chargebee supports GrabPay as a payment method through the Adyen payment gateway.
When customers select GrabPay at checkout, they are redirected to the GrabPay app or website to complete the payment using their stored Grab account details. After the payment is completed, customers are redirected back to your website. Payment confirmation is handled asynchronously through Adyen webhooks.
Supported countries and currencies
GrabPay via Adyen supports the following countries and currencies:
| Country | Currency |
|---|---|
| Singapore | SGD |
| Malaysia | MYR |
| Philippines | PHP |
Prerequisites
To accept GrabPay payments in Chargebee, ensure the following:
- You have an active Adyen account with GrabPay enabled as a payment method in the Adyen Customer Area.
- At least one of the following currencies is enabled in your Chargebee account: SGD, MYR, or PHP.
- The Adyen payment gateway and webhooks are configured in Chargebee. Learn more
Integration options
You can integrate GrabPay via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept GrabPay payments with minimal integration effort. |
| Chargebee JS | Embed GrabPay as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate GrabPay using Chargebee APIs for a fully custom checkout and payment flow. |
Supported tokens
This integration supports the following token type:
| Token | Description | Format and Sample |
|---|---|---|
| Chargebee Payment Intent ID | Represents the Payment Intent ID returned after a successful authorization using Chargebee JS. | Format: payment_intent[id] |
Configure GrabPay in Chargebee
Follow these steps to enable GrabPay via Adyen in your Chargebee site:
- Log in to the Chargebee app.
- Navigate to Settings > Configure Chargebee > Payment Gateways.
- Select the required Adyen gateway instance.
- On the Configure Adyen page, enable GrabPay under the supported payment methods.
- Click Apply to save the configuration.
Configure smart routing for GrabPay
When GrabPay is enabled via Adyen, smart routing for the supported currencies is automatically configured. If another gateway is already assigned to SGD, MYR, or PHP, update the routing rules manually to ensure GrabPay is correctly allocated.
Refer to Smart Routing for more details.
Update Smart Routing settings
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Click Manage Rules under Smart Routing.
- In the GrabPay section:
- Click Add a Gateway for the relevant currency, or
- Click Edit if a gateway is already assigned.
- From the Choose a payment gateway dropdown, select the Adyen instance with GrabPay enabled.
- Click Save.
Enable GrabPay to pay for subscriptions
GrabPay is a one-time payment method and does not support recurring payments. To use GrabPay for subscriptions, configure your Chargebee site to allow one-time payment methods for subscription payments.
Follow these steps to enable this setting:
- 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
During checkout, customers complete the following steps when using GrabPay via Adyen:
- Initiate checkout and proceed to the payment step.
- Select GrabPay as the payment method.
- Get redirected to the GrabPay app or website to complete the payment using the Grab account.
- Confirm the payment in GrabPay.
- After successful authorization, get redirected back to the merchant’s website.
Testing
Sandbox testing
- Use the Adyen test environment with GrabPay enabled.
- Testing is performed using Adyen-provided test credentials and the simulator.
Production testing
Before going live:
- Ensure GrabPay is enabled in your Adyen account.
- Verify that webhooks are correctly configured (required for payment status updates).
- Perform end-to-end testing using:
- A real GrabPay account
- A device to complete the GrabPay payment flow after redirection
Reconciliation
To reconcile transactions between Chargebee and Adyen:
- Use the Chargebee transaction field id_at_gateway, which corresponds to pspReference in Adyen.
Steps for reconciliation
- Retrieve the id_at_gateway value from the Chargebee transaction.
- Locate the corresponding pspReference in Adyen reports for GrabPay transactions.
- Match the transactions using this reference to ensure financial consistency.
Limitations and important points
- GrabPay cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the GrabPay payment flow to use it.
- GrabPay does not support storing payment methods for fully automated recurring billing. Each transaction requires explicit customer authorization.
- GrabPay is not suitable for automatic subscription renewals. To collect payments for subscriptions, send email notifications with a Pay Now link when a new invoice is generated.
- GrabPay does not support chargebacks. Refunds must be processed manually when required.
Was this article helpful?