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

# Metodi di Pagamento in Corea del Sud

> Accetta i wallet locali coreani PAYCO, Naver Pay e Kakao Pay insieme a carte locali coreane e carte internazionali, fatturate in KRW. Scopri la disponibilità, il supporto per gli abbonamenti e la configurazione.

I clienti sudcoreani preferiscono fortemente i wallet locali e le carte nazionali rispetto ai metodi di pagamento internazionali. Dodo Payments supporta i principali wallet coreani — **PAYCO**, **Naver Pay** e **Kakao Pay** — insieme a **carte locali coreane** e carte internazionali, tutte fatturate in **KRW** (Won sudcoreano).

## Perché i Metodi di Pagamento Coreani Sono Importanti

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    I compratori coreani preferiscono nettamente i wallet locali come Kakao Pay e Naver Pay invece di inserire i dettagli della carta.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Molte carte coreane funzionano su reti locali. Supportare le carte locali coreane evita rifiuti su carte che le reti internazionali non possono elaborare.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Offrire metodi locali familiari riduce gli attriti al checkout e gli abbandoni per i clienti in Corea del Sud.
  </Card>
</CardGroup>

## Metodi Supportati

| Metodo                        | Tipo                   | Abbonamenti | Importo Minimo |
| :---------------------------- | :--------------------- | :---------: | :------------- |
| **Kakao Pay**                 | Wallet                 |      Sì     | \~\$1.00       |
| **Naver Pay**                 | Wallet                 |      Sì     | \~\$1.00       |
| **PAYCO**                     | Wallet                 |      No     | \~\$1.00       |
| **Carte Locali Coreane**      | Carta                  |      Sì     | \~\$1.00       |
| **Carte di Credito e Debito** | Carta (internazionale) |      Sì     | \~\$1.00       |

<Info>
  La disponibilità del wallet dipende dal tipo di transazione. **Kakao Pay** e **Naver Pay** sono offerti per gli abbonamenti, mentre **PAYCO** è offerto per i pagamenti singoli. Tutti richiedono una valuta di fatturazione in **KRW**.
</Info>

## Configurazione

### Tipi di Metodo API

| Tipo        | Descrizione                                    |
| :---------- | :--------------------------------------------- |
| `kakao_pay` | Wallet Kakao Pay                               |
| `naver_pay` | Wallet Naver Pay                               |
| `payco`     | Wallet PAYCO                                   |
| `credit`    | Carte di credito, incluse carte locali coreane |
| `debit`     | Carte di debito, incluse carte locali coreane  |

### Esempio: Checkout Focalizzato sulla Corea del Sud

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

### Requisiti

Perché i metodi di pagamento coreani appaiano al checkout:

1. **Paese di fatturazione** è la Corea del Sud (`KR`)
2. **Valuta** è KRW
3. Per commercianti che utilizzano un'altra valuta: **Valuta Adattiva** deve essere abilitata affinché i clienti siano fatturati in KRW

<Warning>
  Se si utilizza un'altra valuta e la Valuta Adattiva non è abilitata, i clienti coreani non saranno fatturati in KRW e i wallet coreani non saranno disponibili.
</Warning>

<Note>
  KRW è una valuta senza decimali — gli importi sono espressi in won interi senza unità minori. Invia e leggi gli importi in KRW come valori numerici interi anziché dividere per 100.
</Note>

## Migliori Pratiche

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    Per i clienti coreani, i wallet locali dovrebbero essere le opzioni principali. Kakao Pay e Naver Pay sono i metodi di checkout più familiari per la maggior parte degli acquirenti coreani.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Includi sempre `credit` e `debit` così i clienti senza un wallet preferito — e i clienti che pagano con carte locali coreane — possono comunque completare il checkout.
  </Accordion>

  <Accordion title="Match currency to region">
    I metodi di pagamento coreani richiedono KRW. Se il tuo catalogo è prezzato in un'altra valuta, abilita Valuta Adattiva in modo che i clienti coreani ricevano un preventivo e siano fatturati in KRW.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    Usa Kakao Pay e Naver Pay per gli abbonamenti e PAYCO per i pagamenti singoli. Includere tutti e tre consente a Dodo di presentare l'opzione giusta in base al contesto del checkout.
  </Accordion>
</AccordionGroup>

## Risoluzione dei Problemi

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

    1. Il paese di fatturazione è impostato su `KR`?
    2. La valuta è impostata su `KRW`?
    3. Se prezzato in un'altra valuta: Valuta Adattiva abilitata?
    4. Il wallet (`kakao_pay`, `naver_pay`, o `payco`) incluso in `allowed_payment_method_types`?

    **Soluzione:** Verifica che l'indirizzo di fatturazione abbia `country: "KR"` e `billing_currency: "KRW"`.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **Causa:** PAYCO è offerto solo per pagamenti singoli. Per la fatturazione ricorrente, usa Kakao Pay o Naver Pay.

    **Soluzione:** Includi `kakao_pay` e `naver_pay` in `allowed_payment_method_types` per i checkout in abbonamento.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **Causa:** Alcune carte coreane funzionano su reti domestiche che le reti internazionali non possono elaborare.

    **Soluzione:** Tieni `credit` e `debit` abilitati in modo che le carte locali coreane siano indirizzate correttamente.
  </Accordion>
</AccordionGroup>

## Pagine Correlate

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Vedi tutti i metodi di pagamento supportati.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Reti di carte, incluse carte locali coreane.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Addebita i clienti nella loro valuta locale, incluso KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Guida ai dati di test e al test del checkout.
  </Card>
</CardGroup>