> ## 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.

# 대한민국 결제 방법

> 한국의 로컬 지갑 PAYCO, 네이버페이, 카카오페이와 한국 로컬 카드 및 국제 카드를 KRW로 결제받습니다. 가용성, 구독 지원 및 설정에 대해 알아보세요.

한국 고객들은 국제 결제 방식보다 로컬 지갑과 국내 카드를 선호합니다. Dodo Payments는 주요 한국 지갑인 **PAYCO**, **네이버페이**, **카카오페이**와 함께 **한국 로컬 카드** 및 국제 카드를 **KRW**(한국 원화)로 청구합니다.

## 한국 결제 방법이 중요한 이유

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    한국 소비자들은 카드 정보를 입력하기보다 카카오페이와 네이버페이 같은 로컬 지갑으로 결제하는 경우가 많습니다.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    많은 한국 카드들이 로컬 네트워크에서 운영됩니다. 한국 로컬 카드 지원은 국제 결제망에서 처리할 수 없는 카드의 결제 실패를 방지합니다.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    익숙한 로컬 방법을 제공하면 한국 고객의 결제 과정에서의 마찰과 포기를 줄일 수 있습니다.
  </Card>
</CardGroup>

## 지원되는 방법

| 방법             | 유형      |  구독 | 최소 금액    |
| :------------- | :------ | :-: | :------- |
| **카카오페이**      | 지갑      |  예  | \~\$1.00 |
| **네이버페이**      | 지갑      |  예  | \~\$1.00 |
| **PAYCO**      | 지갑      | 아니요 | \~\$1.00 |
| **한국 로컬 카드**   | 카드      |  예  | \~\$1.00 |
| **신용 및 직불 카드** | 카드 (국제) |  예  | \~\$1.00 |

<Info>
  지갑 가용성은 거래 유형에 따라 다릅니다. **카카오페이**와 **네이버페이**는 구독에, **PAYCO**는 일회성 결제에 제공됩니다. 모두 **KRW** 청구 통화가 필요합니다.
</Info>

## 설정

### API 방법 유형

| 유형          | 설명                |
| :---------- | :---------------- |
| `kakao_pay` | 카카오페이 지갑          |
| `naver_pay` | 네이버페이 지갑          |
| `payco`     | PAYCO 지갑          |
| `credit`    | 신용카드, 한국 로컬 카드 포함 |
| `debit`     | 직불카드, 한국 로컬 카드 포함 |

### 예제: 한국 중심의 체크아웃

```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'
});
```

### 요구 사항

한국 결제 방법이 체크아웃에 나타나려면:

1. **청구 국가**가 대한민국 (`KR`)
2. **통화**가 KRW
3. 다른 통화로 가격 책정된 상인: **Adaptive Currency**가 활성화되어 고객이 KRW로 청구됨

<Warning>
  다른 통화로 가격을 책정하고 Adaptive Currency가 활성화되어 있지 않으면 한국 고객은 KRW로 청구되지 않으며 한국 지갑은 사용할 수 없습니다.
</Warning>

<Note>
  KRW는 소수 단위가 없는 통화입니다. 금액은 전체 원 단위로 표시되며 100으로 나누지 않고 전체 숫자 값으로 전송하고 읽어야 합니다.
</Note>

## 모범 사례

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    한국 고객을 위해 로컬 지갑을 주 옵션으로 제공해야 합니다. 카카오페이와 네이버페이는 대부분의 한국 쇼핑객에게 가장 익숙한 체크아웃 방법입니다.
  </Accordion>

  <Accordion title="Include card fallbacks">
    항상 `credit` 및 `debit`를 포함하여 선호하는 지갑이 없는 고객과 한국 로컬 카드로 결제하는 고객도 체크아웃을 완료할 수 있도록 합니다.
  </Accordion>

  <Accordion title="Match currency to region">
    한국 결제 방법에는 KRW가 필요합니다. 카탈로그가 다른 통화로 가격이 설정된 경우, Adaptive Currency를 활성화하여 한국 고객이 KRW로 견적 및 청구되도록 합니다.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    구독에는 카카오페이와 네이버페이를 사용하고, 일회성 결제에는 PAYCO를 사용합니다. 모든 세 가지를 포함하면 Dodo가 체크아웃 상황에 따라 적절한 옵션을 제공할 수 있습니다.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="Korean wallets not appearing at checkout">
    **확인:**

    1. 청구 국가가 `KR`로 설정되었는가?
    2. 통화가 `KRW`로 설정되었는가?
    3. 다른 통화로 가격이 책정된 경우, Adaptive Currency가 활성화되었는가?
    4. 지갑 (`kakao_pay`, `naver_pay` 또는 `payco`)가 `allowed_payment_method_types`에 포함되어 있는가?

    **해결책:** 청구 주소에 `country: "KR"` 및 `billing_currency: "KRW"`가 있는지 확인하십시오.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **원인:** PAYCO는 일회성 결제에만 제공됩니다. 반복 청구의 경우 카카오페이 또는 네이버페이를 사용하십시오.

    **해결책:** 구독 체크아웃에 `kakao_pay` 및 `naver_pay`를 `allowed_payment_method_types`에 포함하십시오.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **원인:** 일부 한국 카드들은 국제 결제망에서 처리할 수 없는 국내 네트워크에서 운영됩니다.

    **해결책:** 한국 로컬 카드가 올바르게 라우팅되도록 `credit` 및 `debit`를 활성화 상태로 유지하십시오.
  </Accordion>
</AccordionGroup>

## 관련 페이지

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    모든 지원 결제 방법을 참조하세요.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    카드 네트워크, 한국 로컬 카드 포함.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    고객에게 로컬 통화로 청구, KRW 포함.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    테스트 데이터 및 체크아웃 테스트 가이드.
  </Card>
</CardGroup>