KakaoPay via Adyen
This feature is currently a Private Beta release. Contact Chargebee Support to enable KakaoPay via Adyen for your live and test sites.
KakaoPay is a leading digital wallet in South Korea that enables customers to authorize payments through the KakaoPay app. Chargebee supports KakaoPay as a payment method through the Adyen payment gateway.
When customers select KakaoPay at checkout, they are redirected to KakaoPay to authorize the payment. The payment is processed asynchronously by Adyen, and the final status is confirmed through webhooks. After the initial authorization, Adyen stores a token that enables merchant-initiated charges for subsequent billing cycles, making KakaoPay suitable for recurring subscriptions.
Supported countries and currencies
KakaoPay via Adyen supports the following country and currency:
| Country | Currency |
|---|---|
| South Korea | KRW |
Prerequisites
To accept KakaoPay payments in Chargebee, ensure the following:
- The Adyen payment gateway is configured in your Chargebee site. Learn more
- KakaoPay is enabled in your Adyen account (South Korea only).
- A Merchant Account for KakaoPay is configured in Adyen, with API credentials and webhooks enabled.
- KRW (South Korean Won) is enabled as a supported currency in your Chargebee account.
Integration options
You can integrate KakaoPay via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept KakaoPay payments with minimal integration effort. |
| Chargebee JS | Embed KakaoPay as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate KakaoPay using Chargebee APIs for a fully custom checkout and payment flow. |
Supported tokens
KakaoPay supports reusable payment tokens for recurring billing. The following token types are supported:
| 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] |
| Gateway Permanent Token | Used for recurring payments. This token is stored by Adyen after the first successful KakaoPay transaction, enabling merchant-initiated charges for subsequent billing cycles. | Format: shopper_reference_id/recurring_detail_reference_id |
Configure KakaoPay in Chargebee
Follow these steps to enable KakaoPay 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 KakaoPay under the supported payment methods.
- Click Apply to save the configuration.
Note
KakaoPay availability depends on your Adyen merchant configuration.
Configure smart routing for KakaoPay
When KakaoPay is enabled via Adyen, smart routing for the KRW currency is automatically configured. If another gateway is already assigned to KRW, update the routing rules manually to ensure KakaoPay 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 KakaoPay section:
- Click Add a Gateway for KRW, or
- Click Edit if a gateway is already assigned.
- From the Choose a payment gateway dropdown, select the Adyen instance with KakaoPay enabled.
- Click Save.
Checkout flow
During checkout, customers complete the following steps when using KakaoPay via Adyen:
- Initiate checkout and proceed to the payment step.
- Enter your email address (required for KakaoPay payments).
- Select KakaoPay as the payment method.
- Get redirected to KakaoPay to authorize the payment.
- Confirm the payment in the KakaoPay app.
- After successful authorization, get redirected back to the merchant’s website.
Testing
Sandbox testing
Refer to Adyen’s documentation for instructions on testing KakaoPay in a sandbox environment.
Production testing
Before going live:
- Ensure KakaoPay 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 KakaoPay-enabled account
- A mobile device with the KakaoPay app installed
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.
- Match the transactions using this reference.
Limitations and important points
- KakaoPay cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the KakaoPay checkout flow to use it.
- KakaoPay requires a customer email address as a mandatory field. Ensure that the email is collected during checkout.
- The initial transaction requires explicit customer authorization via redirect. Subsequent recurring charges are processed as merchant-initiated transactions without customer intervention.
- KakaoPay is available only for KRW (South Korean Won) transactions.
Was this article helpful?