Korean local card elements

Note

Korean local cards feature is currently available in beta. Please reach out to your Airwallex Account Manager or [email protected] if you'd like to join the beta client list.

Korean card elements allow you to embed individual input fields (Korean Card Number JS, Korean Card Expiry Date JS, Korean Card Password First-2 Digits JS and Korean Card Identifier JS) on your checkout page to securely collect card details and submit these details to Airwallex to process a payment with Korean local branded cards. In comparison to Split Card Element, it is customized to cater the special data fields that are only required by the Korean local card companies during checkout.

See Quickstart guide for Korean local cards.

Supported features

Note

Note: Korean Local Cards does not support 3D secure authentication. For consumer cards, Korea’s local card companies rely on the cardholder's date of birth and card PIN first-2 digits to determine whether the shopper is the cardholder itself.

You can use the following features in your Korean local card elements integration.

Style and appearance customization

Pass style JS on each Korean local card element (for example krCardNumber, krCardExpiry, krCardIdentifier, and krCardPswFirstTwo) to match your checkout. For iframe field styling patterns and examples, see Customize style and appearance and open the Card element / Split card element tab.

Localization

You can configure the Element to display localized text for payment fields based on the locale specified in init(). If no locale is specified, the browser's locale will be used, if it is supported by Airwallex.js. For a list of supported locales, see locales JS.

If the browser's locale is not supported, the Element will default to en.

Device fingerprinting

Device fingerprinting uniquely tracks and identifies devices used for transacting on your shopping site, increasing your protection from fraud. Airwallex.js automatically handles device fingerprinting, so no additional integration is needed.

Payments for platforms

You can accept payments from Korean local cards as a platform via the Korean Local Cards - Split Card Element. Example platforms include marketplaces, SaaS platforms, on-demand service providers. For more information on payments for platforms with Airwallex as an acquirer, see Airwallex payment gateway.

To use Connected Account information to process the payment, e.g., statement descriptor displayed on the shopper's credit card or bank statement, provide connected_account_id in Create a Payment Intent API.

Fraud protection

You can provide specific data fields in Create a PaymentIntent API and Confirm a Payment Intent API endpoints to significantly improve Airwallex's fraud protection performance, ultimately boosting conversion rates and minimizing fraud risk. For more information, see Payment data for enhanced fraud protection.

FAQ

What card schemes can I accept using Korean local card elements?

You can accept credit and debit cards issued by Korea’s 9 major local card companies in the market:

BC
Hana
Hyundai
KB
Lotte
NH
Samsung
Shinhan
Woori

How do I display the cardholder name field for Korean local card elements?

You can render a Cardholder Name input field on your checkout page alongside the Korean local card elements. The cardholder name is not mandatory to confirm and complete a payment.

Was this page helpful?