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

# Métodos de Pagamento na Coreia do Sul

> Aceite carteiras locais coreanas PAYCO, Naver Pay e Kakao Pay, juntamente com cartões locais coreanos e internacionais, faturados em KRW. Saiba mais sobre disponibilidade, suporte a assinaturas e configuração.

Os clientes sul-coreanos preferem fortemente carteiras locais e cartões domésticos em vez de métodos de pagamento internacionais. A Dodo Payments suporta as principais carteiras coreanas — **PAYCO**, **Naver Pay** e **Kakao Pay** — juntamente com **cartões locais coreanos** e cartões internacionais, todos faturados em **KRW** (Won sul-coreano).

## Por que os Métodos de Pagamento Coreanos Importam

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    Os compradores coreanos geralmente optam por carteiras locais como Kakao Pay e Naver Pay em vez de inserir detalhes do cartão.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Muitos cartões coreanos operam em redes locais. Apoiar cartões locais coreanos evita recusas em cartões que as redes internacionais não podem processar.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Oferecer métodos locais familiares reduz o atrito no checkout e o abandono para clientes na Coreia do Sul.
  </Card>
</CardGroup>

## Métodos Suportados

| Método                          | Tipo                   | Assinaturas | Quantia Mínima |
| :------------------------------ | :--------------------- | :---------: | :------------- |
| **Kakao Pay**                   | Carteira               |     Sim     | \~\$1.00       |
| **Naver Pay**                   | Carteira               |     Sim     | \~\$1.00       |
| **PAYCO**                       | Carteira               |     Não     | \~\$1.00       |
| **Cartões Locais Coreanos**     | Cartão                 |     Sim     | \~\$1.00       |
| **Cartões de Crédito & Débito** | Cartão (internacional) |     Sim     | \~\$1.00       |

<Info>
  A disponibilidade das carteiras depende do tipo de transação. **Kakao Pay** e **Naver Pay** são oferecidos para assinaturas, enquanto **PAYCO** é oferecido para pagamentos únicos. Todos requerem a moeda de faturamento em **KRW**.
</Info>

## Configuração

### Tipos de Método API

| Tipo        | Descrição                                             |
| :---------- | :---------------------------------------------------- |
| `kakao_pay` | Carteira Kakao Pay                                    |
| `naver_pay` | Carteira Naver Pay                                    |
| `payco`     | Carteira PAYCO                                        |
| `credit`    | Cartões de crédito, incluindo cartões locais coreanos |
| `debit`     | Cartões de débito, incluindo cartões locais coreanos  |

### Exemplo: Checkout Focado na Coreia do Sul

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

### Requisitos

Para os métodos de pagamento coreanos aparecerem no checkout:

1. O **país de faturamento** é a Coreia do Sul (`KR`)
2. A **moeda** é KRW
3. Para comerciantes precificados em outra moeda: **Moeda Adaptativa** deve estar habilitada para que os clientes sejam cobrados em KRW

<Warning>
  Se você definir preços em outra moeda e a Moeda Adaptativa não estiver habilitada, os clientes coreanos não serão cobrados em KRW, e as carteiras coreanas não estarão disponíveis.
</Warning>

<Note>
  KRW é uma moeda sem casa decimal — os valores são expressos em won inteiros sem unidades menores. Envie e leia os valores de KRW como valores de número inteiro em vez de dividir por 100.
</Note>

## Melhores Práticas

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    Para clientes coreanos, carteiras locais devem ser as opções principais. Kakao Pay e Naver Pay são os métodos de checkout mais familiares para a maioria dos compradores coreanos.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Sempre inclua `credit` e `debit` para que clientes sem carteiras preferidas — e clientes pagando com cartões locais coreanos — ainda possam concluir o checkout.
  </Accordion>

  <Accordion title="Match currency to region">
    Os métodos de pagamento coreanos requerem KRW. Se seu catálogo estiver precificado em outra moeda, habilite a Moeda Adaptativa para que os clientes coreanos sejam cotados e cobrados em KRW.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    Use Kakao Pay e Naver Pay para assinaturas e PAYCO para pagamentos únicos. Incluir todos os três permite que a Dodo apresente a opção correta com base no contexto do checkout.
  </Accordion>
</AccordionGroup>

## Solução de Problemas

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

    1. País de faturamento definido como `KR`?
    2. Moeda definida como `KRW`?
    3. Se precificado em outra moeda: Moeda Adaptativa habilitada?
    4. A carteira (`kakao_pay`, `naver_pay`, ou `payco`) incluída em `allowed_payment_method_types`?

    **Solução:** Verifique se o endereço de faturamento tem `country: "KR"` e `billing_currency: "KRW"`.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **Causa:** PAYCO é oferecido apenas para pagamentos únicos. Para faturamento recorrente, utilize Kakao Pay ou Naver Pay.

    **Solução:** Inclua `kakao_pay` e `naver_pay` em `allowed_payment_method_types` para checkouts de assinatura.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **Causa:** Alguns cartões coreanos operam em redes domésticas que as redes internacionais não podem processar.

    **Solução:** Mantenha `credit` e `debit` habilitados para que os cartões locais coreanos sejam roteados corretamente.
  </Accordion>
</AccordionGroup>

## Páginas Relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Veja todos os métodos de pagamento suportados.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Redes de cartões, incluindo cartões locais coreanos.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Cobre clientes em sua moeda local, incluindo KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Dados de teste e orientações de teste de checkout.
  </Card>
</CardGroup>