Skip to main content
South Korean customers strongly prefer local wallets and domestic cards over international payment methods. Dodo Payments supports the major Korean wallets — PAYCO, Naver Pay, and Kakao Pay — alongside Korean local cards and international cards, all billed in KRW (South Korean Won).

​
Why Korean Payment Methods Matter

Wallet-First Market

Korean shoppers overwhelmingly check out with local wallets like Kakao Pay and Naver Pay rather than entering card details.

Domestic Card Networks

Many Korean cards run on local networks. Supporting Korean local cards avoids declines on cards that international rails can’t process.

Higher Conversion

Offering familiar local methods reduces checkout friction and abandonment for customers in South Korea.

​
Supported Methods

MethodTypeSubscriptionsMin Amount
Kakao PayWalletYes~$1.00
Naver PayWalletYes~$1.00
PAYCOWalletNo~$1.00
Korean Local CardsCardYes~$1.00
Credit & Debit CardsCard (international)Yes~$1.00
Wallet availability depends on the transaction type. Kakao Pay and Naver Pay are offered for subscriptions, while PAYCO is offered for one-time payments. All require a KRW billing currency.

​
Configuration

​
API Method Types

TypeDescription
kakao_payKakao Pay wallet
naver_payNaver Pay wallet
paycoPAYCO wallet
creditCredit cards, including Korean local cards
debitDebit cards, including Korean local cards

​
Example: South Korea-Focused Checkout

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'kakao_pay',
    'naver_pay',
    'payco',
    'credit',
    'debit'
  ],
  billing_currency: 'KRW',
  billing_address: {
    country: 'KR',
    zipcode: '06236'
  },
  return_url: 'https://example.com/success'
});

​
Requirements

For Korean payment methods to appear at checkout:
  1. Billing country is South Korea (KR)
  2. Currency is KRW
  3. For merchants priced in another currency: Adaptive Currency must be enabled so customers are billed in KRW
If you price in another currency and Adaptive Currency is not enabled, Korean customers will not be billed in KRW and the Korean wallets will not be available.
KRW is a zero-decimal currency — amounts are expressed in whole won with no minor units. Send and read KRW amounts as whole-number values rather than dividing by 100.

​
Best Practices

For Korean customers, local wallets should be the primary options. Kakao Pay and Naver Pay are the most familiar checkout methods for most Korean shoppers.
Always include credit and debit so customers without a preferred wallet — and customers paying with Korean local cards — can still complete checkout.
Korean payment methods require KRW. If your catalog is priced in another currency, enable Adaptive Currency so Korean customers are quoted and billed in KRW.
Use Kakao Pay and Naver Pay for subscriptions and PAYCO for one-time payments. Including all three lets Dodo present the right option based on the checkout context.

​
Troubleshooting

Check:
  1. Billing country set to KR?
  2. Currency set to KRW?
  3. If priced in another currency: Adaptive Currency enabled?
  4. The wallet (kakao_pay, naver_pay, or payco) included in allowed_payment_method_types?
Solution: Verify the billing address has country: "KR" and billing_currency: "KRW".
Cause: PAYCO is offered for one-time payments only. For recurring billing, use Kakao Pay or Naver Pay.Solution: Include kakao_pay and naver_pay in allowed_payment_method_types for subscription checkouts.
Cause: Some Korean cards run on domestic networks that international rails can’t process.Solution: Keep credit and debit enabled so Korean local cards are routed correctly.

Payment Methods Overview

See all supported payment methods.

Credit & Debit Cards

Card networks, including Korean local cards.

Adaptive Currency

Bill customers in their local currency, including KRW.

Testing Process

Test data and checkout testing guidance.
Last modified on June 18, 2026