> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# South Korea Payment Methods

> Accept Korean local wallets PAYCO, Naver Pay, and Kakao Pay alongside Korean local cards and international cards, billed in KRW. Learn about availability, subscription support, and configuration.

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

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    Korean shoppers overwhelmingly check out with local wallets like Kakao Pay and Naver Pay rather than entering card details.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Many Korean cards run on local networks. Supporting Korean local cards avoids declines on cards that international rails can't process.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Offering familiar local methods reduces checkout friction and abandonment for customers in South Korea.
  </Card>
</CardGroup>

## Supported Methods

| Method                   | Type                 | Subscriptions | Min Amount |
| :----------------------- | :------------------- | :-----------: | :--------- |
| **Kakao Pay**            | Wallet               |      Yes      | \~\$1.00   |
| **Naver Pay**            | Wallet               |      Yes      | \~\$1.00   |
| **PAYCO**                | Wallet               |       No      | \~\$1.00   |
| **Korean Local Cards**   | Card                 |      Yes      | \~\$1.00   |
| **Credit & Debit Cards** | Card (international) |      Yes      | \~\$1.00   |

<Info>
  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.
</Info>

## Configuration

### API Method Types

| Type        | Description                                |
| :---------- | :----------------------------------------- |
| `kakao_pay` | Kakao Pay wallet                           |
| `naver_pay` | Naver Pay wallet                           |
| `payco`     | PAYCO wallet                               |
| `credit`    | Credit cards, including Korean local cards |
| `debit`     | Debit cards, including Korean local cards  |

### Example: South Korea-Focused Checkout

```javascript theme={null}
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

<Warning>
  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.
</Warning>

<Note>
  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.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    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.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Always include `credit` and `debit` so customers without a preferred wallet — and customers paying with Korean local cards — can still complete checkout.
  </Accordion>

  <Accordion title="Match currency to region">
    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.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    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.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Korean wallets not appearing at checkout">
    **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"`.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **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.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **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.
  </Accordion>
</AccordionGroup>

## Related Pages

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    See all supported payment methods.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Card networks, including Korean local cards.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Bill customers in their local currency, including KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Test data and checkout testing guidance.
  </Card>
</CardGroup>