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

# Phương Thức Thanh Toán Hàn Quốc

> Chấp nhận các ví địa phương của Hàn Quốc như PAYCO, Naver Pay, và Kakao Pay cùng với các thẻ địa phương và thẻ quốc tế, tính phí bằng KRW. Tìm hiểu về tính khả dụng, hỗ trợ đăng ký và cấu hình.

Khách hàng Hàn Quốc ưa thích sử dụng ví địa phương và thẻ nội địa hơn là các phương thức thanh toán quốc tế. Dodo Payments hỗ trợ các ví lớn của Hàn Quốc — **PAYCO**, **Naver Pay**, và **Kakao Pay** — cùng với **các thẻ địa phương Hàn Quốc** và thẻ quốc tế, tất cả đều được tính phí bằng **KRW** (Won Hàn Quốc).

## Tại Sao Phương Thức Thanh Toán Hàn Quốc Quan Trọng

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    Người mua sắm Hàn Quốc thường xuyên sử dụng các ví địa phương như Kakao Pay và Naver Pay thay vì nhập chi tiết thẻ.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Nhiều thẻ Hàn Quốc hoạt động trên mạng lưới địa phương. Hỗ trợ thẻ địa phương Hàn Quốc giúp tránh các trường hợp thẻ bị từ chối mà các hệ thống quốc tế không xử lý được.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Cung cấp các phương thức địa phương quen thuộc giúp giảm ma sát và từ bỏ thanh toán cho khách hàng ở Hàn Quốc.
  </Card>
</CardGroup>

## Phương Thức Hỗ Trợ

| Phương Thức                   | Loại          | Hỗ Trợ Đăng Ký | Số Tiền Tối Thiểu |
| :---------------------------- | :------------ | :------------: | :---------------- |
| **Kakao Pay**                 | Ví            |       Có       | \~1,00 USD        |
| **Naver Pay**                 | Ví            |       Có       | \~1,00 USD        |
| **PAYCO**                     | Ví            |      Không     | \~1,00 USD        |
| **Thẻ Địa Phương Hàn Quốc**   | Thẻ           |       Có       | \~1,00 USD        |
| **Thẻ Tín Dụng & Thẻ Ghi Nợ** | Thẻ (quốc tế) |       Có       | \~1,00 USD        |

<Info>
  Khả dụng của ví phụ thuộc vào loại giao dịch. **Kakao Pay** và **Naver Pay** được cung cấp cho các đăng ký, trong khi **PAYCO** được cung cấp cho các khoản thanh toán một lần. Tất cả yêu cầu tiền tệ tính phí là **KRW**.
</Info>

## Cấu Hình

### Loại Phương Thức API

| Loại        | Mô Tả                                         |
| :---------- | :-------------------------------------------- |
| `kakao_pay` | Ví Kakao Pay                                  |
| `naver_pay` | Ví Naver Pay                                  |
| `payco`     | Ví PAYCO                                      |
| `credit`    | Thẻ tín dụng, bao gồm thẻ địa phương Hàn Quốc |
| `debit`     | Thẻ ghi nợ, bao gồm thẻ địa phương Hàn Quốc   |

### Ví Dụ: Thanh Toán Tập Trung Vào Hàn Quốc

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

### Yêu Cầu

Để các phương thức thanh toán Hàn Quốc xuất hiện tại thanh toán:

1. **Quốc gia Thanh Toán** là Hàn Quốc (`KR`)
2. **Tiền Tệ** là KRW
3. Đối với các thương gia có giá trong tiền tệ khác: **Tiền Tệ Thích Ứng** phải được kích hoạt để khách hàng được tính bằng KRW

<Warning>
  Nếu bạn định giá bằng tiền tệ khác và Tiền Tệ Thích Ứng không được kích hoạt, khách hàng Hàn Quốc sẽ không được tính phí bằng KRW và các ví của Hàn Quốc sẽ không khả dụng.
</Warning>

<Note>
  KRW là loại tiền tệ không có số thập phân — các số lượng được biểu thị bằng số nguyên mà không có đơn vị nhỏ. Gửi và đọc số lượng KRW dưới dạng giá trị số nguyên hoàn chỉnh thay vì chia cho 100.
</Note>

## Thực Hành Tốt Nhất

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    Đối với khách hàng Hàn Quốc, ví địa phương nên là tùy chọn chính. Kakao Pay và Naver Pay là phương thức thanh toán quen thuộc nhất cho hầu hết người mua sắm Hàn Quốc.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Luôn bao gồm `credit` và `debit` để khách hàng không có ví ưa thích — và khách hàng thanh toán bằng thẻ địa phương Hàn Quốc — vẫn có thể hoàn thành thanh toán.
  </Accordion>

  <Accordion title="Match currency to region">
    Phương thức thanh toán Hàn Quốc yêu cầu KRW. Nếu danh mục của bạn được định giá bằng tiền tệ khác, hãy kích hoạt Tiền Tệ Thích Ứng để khách hàng Hàn Quốc được báo giá và tính bằng KRW.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    Sử dụng Kakao Pay và Naver Pay cho đăng ký và PAYCO cho các khoản thanh toán một lần. Bao gồm cả ba sẽ cho phép Dodo đề xuất tùy chọn phù hợp dựa trên ngữ cảnh thanh toán.
  </Accordion>
</AccordionGroup>

## Khắc Phục Sự Cố

<AccordionGroup>
  <Accordion title="Korean wallets not appearing at checkout">
    **Kiểm Tra:**

    1. Quốc gia thanh toán đã được đặt là `KR`?
    2. Tiền tệ đã được đặt là `KRW`?
    3. Nếu định giá bằng tiền tệ khác: Tiền Tệ Thích Ứng đã được kích hoạt?
    4. Ví (`kakao_pay`, `naver_pay`, hoặc `payco`) có trong `allowed_payment_method_types` không?

    **Giải Pháp:** Xác minh địa chỉ thanh toán đã có `country: "KR"` và `billing_currency: "KRW"`.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **Nguyên Nhân:** PAYCO chỉ được cung cấp cho các khoản thanh toán một lần. Đối với thanh toán định kỳ, sử dụng Kakao Pay hoặc Naver Pay.

    **Giải Pháp:** Bao gồm `kakao_pay` và `naver_pay` trong `allowed_payment_method_types` cho thanh toán đăng ký.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **Nguyên Nhân:** Một số thẻ Hàn Quốc hoạt động trên mạng nội địa mà các hệ thống quốc tế không xử lý được.

    **Giải Pháp:** Giữ `credit` và `debit` được kích hoạt để thẻ địa phương Hàn Quốc được định tuyến đúng cách.
  </Accordion>
</AccordionGroup>

## Trang Liên Quan

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Xem tất cả các phương thức thanh toán được hỗ trợ.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Mạng lưới thẻ, bao gồm thẻ địa phương Hàn Quốc.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Tính phí khách hàng bằng đồng tiền địa phương của họ, bao gồm KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Dữ liệu kiểm tra và hướng dẫn kiểm tra thanh toán.
  </Card>
</CardGroup>