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
Transaction
Resource-
Returns korea_local for Korean payment methods.
-
Returns information about the underlying payment method used to pay.