South Korean Cards via Stripe
This feature is a Private Beta release. Contact Chargebee Support to enable South Korean Cards via Stripe for your live and test sites.
Chargebee now supports South Korean cards through the Stripe payment gateway, so you can offer a secure, convenient checkout experience for South Korean cards directly in Chargebee.
With this integration, customers can pay quickly using their South Korean card details while you continue to manage payment processing through Stripe. This adds checkout flexibility and helps improve conversion for businesses on the Chargebee platform.
When a customer selects South Korean cards as their payment method:
- Stripe redirects them to the South Korean card provider's website.
- The customer authenticates with their South Korean card credentials or checks out as a first-time user.
- After authentication, the customer returns to your website.
Key features
- Supports both one-time payments (one-time charges) and recurring payments (subscriptions).
- Supports KRW (South Korean Won) as the payment currency.
- Compatible with:
Prerequisites
Before you configure South Korean cards in Chargebee:
- Stripe is configured as a payment gateway in Chargebee.
- South Korean cards are enabled in your Stripe account.
Configure South Korean cards via Stripe in Chargebee
To configure South Korean cards support on your Chargebee site:
- Log in to your Chargebee Billing site.
- Go to Settings > Configure Chargebee > Payment Gateway.
- Select Stripe from the list of configured gateways.
- On the Configure Stripe page, enable South Korean cards.
- Click Apply to save your changes.
Configuring webhooks
To keep your Chargebee–Stripe integration in sync, configure webhooks in Stripe. Webhooks let Chargebee receive real-time updates from Stripe when specific events, such as refunds, occur.
For this integration to work correctly, enable the following event:
This event notifies Chargebee when a refund transaction is created, fails, or is updated in Stripe, so refunds are reflected accurately in your Chargebee account.
Payment workflow
Your customer completes the following steps at checkout when paying with South Korean cards via Stripe:
- The customer reviews the order details on the Your order page and selects Proceed To Checkout.
- The customer enters the billing address on the Add your billing address page and selects Next.
- On the Add your payment details page, the customer selects South Korean Cards, agrees to the terms authorizing recurring charges, and selects Continue with South Korean Cards.
- The customer reviews the order summary on the Complete your order page and selects Pay.
- The customer is redirected to the South Korean Cards payment page and authenticates using their card credentials.
- After authentication, the customer is redirected back to Chargebee, where the transaction is processed.
Note
The screenshots above show the South Korean Cards authentication flow in Stripe's test environment. In production, customers authenticate using their actual South Korean card credentials.
Payment features
The following features are supported for South Korean cards via Stripe.
| Feature | Description | Supported | Default state | Configuration or behavior |
|---|---|---|---|---|
| Integration sync mode | Defines how payment requests are processed and statuses are communicated between Chargebee and Stripe. | Yes (asynchronous) | Asynchronous | Stripe processes South Korean card payments asynchronously. Chargebee receives the final payment status through Stripe webhooks. Webhook configuration is mandatory and is used to receive refund updates through the charge.refund.updated event. |
| Capture settings | Payment processing involves two stages: authorization and capture. Capture settings determine when funds are collected after authorization. | Yes | Auto capture | Auto capture is the default and only supported capture setting for South Korean cards via Stripe. No additional configuration is required. |
| Verification modes | Defines how payment methods are verified before processing. | Yes | Enabled | The customer authenticates on the South Korean card provider's redirect page using their card credentials. No separate verification configuration is required in Chargebee. |
| Statement descriptor | Displays the business name on the customer's card statement, helping them recognize charges and reducing disputes. | Yes | Disabled | Configure this under Settings > Configure Chargebee > Transaction Descriptor. |
| Chargeback management | Handles chargeback events and applies configured actions on invoices and subscriptions. | Yes | Disabled | Enable Chargeback Management under Settings > Configure Chargebee > Billing LogIQ > Chargeback Management, and configure the required dispute webhooks in Stripe. |
| Fraud management | Uses gateway fraud signals to identify and flag high-risk transactions. | Yes | Enabled | Stripe Radar fraud screening applies to card payments. No South Korean card-specific fraud configuration is available in Chargebee. |
| Transaction initiation type | Identifies whether a transaction is customer-initiated (CIT) or merchant-initiated (MIT). | Yes | Supported | The initial payment is customer-initiated through the South Korean card redirect flow. Subsequent recurring charges are merchant-initiated using the stored Stripe payment method. |
| Error intelligence | Provides standardized categorization of payment failures. | Yes | Enabled | Available through Stripe payment responses. No configuration is required. |
| Gateway transaction details | Provides access to raw gateway responses for transactions. | Yes | Enabled | Available on the transaction page under Error details. No configuration is required. |
| Adding payment methods in the Chargebee dashboard | Allows a payment method to be added in Chargebee when details are collected outside checkout. | No | Not applicable | Customers must complete the South Korean card checkout flow. The payment method can't be added from the Chargebee dashboard. |
Supported token formats
This section is relevant if you're building a custom checkout or migrating payment methods from another provider to Stripe.
| Token type | Description | Supported | Token field | Token format |
|---|---|---|---|---|
| Chargebee Payment Intent | Recommended token format when building a custom checkout using Chargebee.js. | Yes | payment_intent[id] | payment_intent_id |
| Chargebee token | Legacy token format supported for selected payment methods and gateways with Chargebee.js. Not recommended for new implementations. | No | token_id | Not applicable |
| Gateway permanent token | Permanent reference provided by Stripe and used for subsequent recurring payments. | Yes | payment_method[reference_id] | customer_id/payment_method_id |
| Gateway temporary token | Short-lived token format that can be converted to a permanent token. | No | Not applicable | Not applicable |
Testing
Sandbox testing
Refer to Stripe's South Korean cards documentation for instructions on testing in the Stripe test environment. Make sure webhooks are configured to receive the charge.refund.updated event for refund settlement updates.
Production testing
Before you go live:
- Make sure South Korean cards are enabled in your Stripe live account.
- Verify that webhook configuration is complete (required for refund settlement updates).
- Run end-to-end testing using a real South Korean card.
Reconciliation
For financial reconciliation between Chargebee and Stripe, use the Chargebee transaction field id_at_gateway, which maps to the Stripe PaymentIntent ID.
To reconcile transactions:
- Retrieve the
id_at_gatewayvalue from the Chargebee transaction details. - Locate the corresponding transaction in your Stripe Dashboard or reports.
- Match transactions using this reference to keep your records consistent.
Limitations and important points
- South Korean cards can't be added as a payment method through the customer portal or the Chargebee app. Customers must complete the South Korean card checkout flow.
- The initial transaction requires explicit customer authorization through redirect. Subsequent recurring charges are processed as merchant-initiated transactions without customer intervention.
- South Korean cards are available only for KRW (South Korean Won) transactions.
Was this article helpful?