PayCo via Adyen
This feature is a Private Beta release. Contact Chargebee Support to enable PayCo via Adyen for your live and test sites.
PayCo is a popular digital wallet payment method in South Korea that allows customers to authorise payments through the PayCo wallet redirect flow. Chargebee supports PayCo as a payment method via the Adyen payment gateway.
When customers select PayCo at checkout, they are redirected to the PayCo wallet to authenticate and authorise the payment. Funds are captured immediately after successful authorization, and the final status is confirmed via Adyen webhooks.
Supported countries and currencies
PayCo via Adyen supports the following countries and currencies:
| Country | Currency |
|---|---|
| South Korea | KRW |
Prerequisites
To accept PayCo payments using Chargebee, you must:
- Have an active Adyen account with PayCo enabled as a payment method in your Adyen Customer Area.
- Ensure KRW (South Korean Won) 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 PayCo via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept PayCo payments with minimal integration effort. |
| Chargebee JS | Embed PayCo as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate PayCo 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 PayCo in Chargebee
Follow these steps to configure PayCo 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 PayCo is enabled under the list of supported payment methods.
- Click Apply to save changes.
Note
PayCo availability depends on your Adyen merchant configuration.
Configure smart routing for PayCo
When you configure PayCo through Adyen, smart routing for the KRW currency is automatically enabled. Check the Smart Routing settings, and if any other gateway is already designated for the KRW currency, adjust the Smart Routing settings manually to allocate PayCo 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 PayCo section and click Add a Gateway for KRW. 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 PayCo enabled.
- Click Save.
Enable PayCo to pay for subscriptions
PayCo 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 PayCo via Adyen:
- Initiate checkout and proceed to the payment step.
- Select PayCo as the payment method.
- You are redirected to the PayCo wallet to authenticate and authorise the payment.
- Log in to your PayCo account and confirm the payment.
- Once payment is authorised, you are redirected back to the merchant's website.
Testing
Sandbox testing
- Use the PayCo sandbox environment provided by the gateway.
- Testing involves redirecting to PayCo test pages and using test wallet credentials.
- Payment outcomes are controlled via PayCo sandbox scenarios and gateway-triggered responses or webhook simulations.
Note
Redirect-based methods like PayCo rely on sandbox account behaviour rather than amount-based simulation.
Production testing
Before going live:
- Ensure PayCo is enabled in your Adyen account.
- Verify webhook configuration is complete (mandatory for payment status updates).
- Perform end-to-end testing using real PayCo wallet accounts and validate the full redirect and return flow.
Reconciliation
For financial reconciliation between Chargebee and Adyen:
- Use the Chargebee transaction field id_at_gateway, which maps to the PayCo transaction reference ID returned by the gateway.
Follow these steps to reconcile transactions:
- Retrieve the id_at_gateway value from the Chargebee transaction details.
- Locate the corresponding transaction in PayCo reports or the gateway dashboard.
- Match transactions using this reference ID.
Limitations and important points
- PayCo cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the PayCo redirect flow.
- PayCo does not support storing reusable payment methods for recurring use. Each transaction requires customer authentication via redirect.
- PayCo is not suitable for automatic subscription renewals or merchant-initiated transactions. To collect payments for subscriptions using PayCo, send email notifications with a Pay Now link when a new invoice is generated.
- PayCo does not support chargebacks. Refunds must be initiated manually via the gateway APIs.
- PayCo is exclusively available for KRW (South Korean Won) transactions.
Was this article helpful?