What's new?
We updated the Paddle platform to support Korean payment methods.
korea_local is a new allowed value for the payments[].method_details.type field against a transaction in the Paddle API, and there's a new underlying_payment_method field that has information about the selected payment method.
Information about the payment method used for a payment attempt.
Type of payment method used for this payment attempt.
korea_local Korean payment methods, which includes over 20 payment options for the Korean market.
Information about the underlying payment method used to pay. Populated for payment methods that offer multiple payment options, like korea_local.
Information about the Korean payment method used to pay. null unless the type is korea_local.
Type of Korean payment method used to pay.
bc BC Card (BCard), a kind of card issued in Korea. (비씨카드)
citi Card issued by Citi Bank in Korea. (한국씨티은행)
hana Card issued by Hana Bank in Korea. (하나카드)
hyundai Hyundai Card, a credit card issued by Hyundai in Korea. (현대카드)
jeju Card issued by Jeju Bank in Korea. (제주은행)
jeonbuk Card issued by Jeonbuk Bank in Korea. (전북은행)
kakaobank Card issued by Kakaobank in Korea. (주식회사 카카오뱅크)
kakaopay KakaoPay digital wallet, popular in Korea. (카카오페이)
kbank Card issued by K Bank in Korea. (케이뱅크)
kdbbank Card issued by KDB Bank in Korea. (한국산업은행)
kookmin Card issued by Kookmin Bank in Korea. (국민은행)
kwangju Card issued by Kwangju Bank in Korea. (광주은행)
lotte Lotte Card, a credit card issued by the Lotte Corporation in Korea. (롯데카드)
mg Card issued by MG Community Credit Cooperatives (KFCC) in Korea. (MG새마을금고)
naverpaycard Card issued by Naver Pay in Korea. (네이버 페이)
naverpaypoint Naver Pay digital wallet, popular in Korea. (네이버 페이)
nh NH Card, a card issued by Nonghyup Bank in Korea. (NH농협은행)
payco PayCo digital wallet, popular in Korea. (페이코)
post Card issued by Korea Post. (우체국예금보험)
samsung Samsung Card, a card issued by Samsung in Korea. (삼성카드)
samsungpay Samsung Pay digital wallet, popular in Korea. (삼성 월렛)
savingsbank Card issued by the Korean Federation of Savings Banks in Korea. (저축은행중앙회)
shinhan Card issued by Shinhan Bank in Korea. (주식회사 신한은행)
shinhyup Card issued by the National Credit Unit Federation of Korea (Shinhyup) in Korea. (신한은행 신협)
suhyup Card issued by the National Federation of Fisheries Cooperation (Suhyup) in Korea. (수협은행)
tossbank Card issued by Toss Bank in Korea. (토스뱅크)
unknown Underlying payment method not known.
woori Card issued by Woori Bank in Korea. (주식회사 우리은행)
How it works
South Korea is one of the fastest-growing major economies, with a highly urbanized and tech-savvy population. It has its own unique payments market, with nine main local card networks — alternatives to Visa, Mastercard, and other international networks — and local digital wallets built into chat or other apps.
You can now turn on Korean payment methods for Paddle Checkout to let customers pay using:
- 22 Korean local card types, including all the main issuers
- KakaoPay
- Naver Pay
- Samsung Pay
- PayCo
Once enabled, Paddle automatically presents the option to pay using Korean payment methods for customers in South Korea paying in Korean Won (KRW) — no additional configuration required.
We use a local processor partner to offer Korean payment methods at Paddle Checkout, so all payment methods are available when you turn on Korean payment methods. Customers choose to pay using Korean payment methods, then choose the local payment method they'd like to use from a list presented by our local processor partner.
As a result, we added korea_local as an allowed value for the payments[].method_details.type field against a transaction entity. We also added a new underlying_payment_method field that has information about the selected payment Korean payment method. You may see this when working with transactions using the API, as well as in transaction events that occur.
Paddle Checkout only presents Korean payment methods as a payment method for items priced in Korean Won (KRW), where the customer address is South Korea.
Next steps
This change is available now.
It's a non-breaking change, meaning it doesn't impact existing integrations.
To start accepting Korean payment methods, enable them in Paddle > Checkout > Checkout settings. You don't need to sign up for a Korean bank account or establish a local entity, and you don't need to make any code changes to your checkout implementation.
For testing instructions, see our payment methods overview guide.
You can work with transactions using the API to see the new payments[].method_details.type value.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| Transaction | payments[].method_details.type | + Added | Enum value |
| Returns korea_local for Korean payment methods. | |||
| Transaction | payments[]. method_details.underlying_details | + Added | Field |
| Returns information about the underlying payment method used to pay. | |||