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

# Zahlungsmethoden in Südkorea

> Akzeptieren Sie koreanische lokale Wallets PAYCO, Naver Pay und Kakao Pay sowie koreanische lokale Karten und internationale Karten, berechnet in KRW. Erfahren Sie mehr über Verfügbarkeit, Abonnementunterstützung und Konfiguration.

Koreanische Kunden bevorzugen stark lokale Wallets und nationale Karten gegenüber internationalen Zahlungsmethoden. Dodo Payments unterstützt die wichtigsten koreanischen Wallets — **PAYCO**, **Naver Pay** und **Kakao Pay** — sowie **koreanische lokale Karten** und internationale Karten, alle abgerechnet in **KRW** (Südkoreanischer Won).

## Warum koreanische Zahlungsmethoden wichtig sind

<CardGroup cols={3}>
  <Card title="Wallet-First Market" icon="wallet">
    Koreanische Käufer bezahlen überwiegend mit lokalen Wallets wie Kakao Pay und Naver Pay, anstatt Kartendetails einzugeben.
  </Card>

  <Card title="Domestic Card Networks" icon="credit-card">
    Viele koreanische Karten laufen über lokale Netzwerke. Die Unterstützung koreanischer lokaler Karten vermeidet Ablehnungen bei Karten, die internationale Systeme nicht verarbeiten können.
  </Card>

  <Card title="Higher Conversion" icon="chart-line">
    Das Anbieten vertrauter lokaler Methoden reduziert Checkout-Reibung und Abbruch für Kunden in Südkorea.
  </Card>
</CardGroup>

## Unterstützte Methoden

| Methode                       | Typ                   | Abonnements | Min. Betrag |
| :---------------------------- | :-------------------- | :---------: | :---------- |
| **Kakao Pay**                 | Wallet                |      Ja     | \~1,00 \$   |
| **Naver Pay**                 | Wallet                |      Ja     | \~1,00 \$   |
| **PAYCO**                     | Wallet                |     Nein    | \~1,00 \$   |
| **Koreanische lokale Karten** | Karte                 |      Ja     | \~1,00 \$   |
| **Kredit- & Debitkarten**     | Karte (international) |      Ja     | \~1,00 \$   |

<Info>
  Die Verfügbarkeit von Wallets hängt vom Transaktionstyp ab. **Kakao Pay** und **Naver Pay** werden für Abonnements angeboten, während **PAYCO** für Einmalzahlungen angeboten wird. Alle erfordern eine Abrechnung in **KRW**.
</Info>

## Konfiguration

### API-Methodentypen

| Typ         | Beschreibung                                             |
| :---------- | :------------------------------------------------------- |
| `kakao_pay` | Kakao Pay Wallet                                         |
| `naver_pay` | Naver Pay Wallet                                         |
| `payco`     | PAYCO Wallet                                             |
| `credit`    | Kreditkarten, einschließlich koreanischer lokaler Karten |
| `debit`     | Debitkarten, einschließlich koreanischer lokaler Karten  |

### Beispiel: Auf Südkorea fokussierter 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'
});
```

### Anforderungen

Damit koreanische Zahlungsmethoden beim Checkout angezeigt werden:

1. **Rechnungsland** ist Südkorea (`KR`)
2. **Währung** ist KRW
3. Für Händler, die in einer anderen Währung bepreist sind: **Adaptive Currency** muss aktiviert sein, damit Kunden in KRW abgerechnet werden

<Warning>
  Wenn Sie in einer anderen Währung bepreisen und Adaptive Currency nicht aktiviert ist, werden koreanische Kunden nicht in KRW abgerechnet und die koreanischen Wallets sind nicht verfügbar.
</Warning>

<Note>
  KRW ist eine Währung ohne Dezimalstellen — Beträge werden in ganzen Won ohne kleinere Einheiten ausgedrückt. Senden und lesen Sie KRW-Beträge als ganze Zahlenwerte und nicht dividiert durch 100.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion title="Offer wallets prominently">
    Für koreanische Kunden sollten lokale Wallets die primären Optionen sein. Kakao Pay und Naver Pay sind die bekanntesten Checkout-Methoden für die meisten koreanischen Käufer.
  </Accordion>

  <Accordion title="Include card fallbacks">
    Immer `credit` und `debit` einschließen, damit Kunden ohne bevorzugtes Wallet — und Kunden, die mit koreanischen lokalen Karten bezahlen — den Checkout trotzdem abschließen können.
  </Accordion>

  <Accordion title="Match currency to region">
    Koreanische Zahlungsmethoden erfordern KRW. Wenn Ihr Katalog in einer anderen Währung bepreist ist, aktivieren Sie Adaptive Currency, damit koreanische Kunden in KRW angeboten und abgerechnet werden.
  </Accordion>

  <Accordion title="Choose wallets by transaction type">
    Verwenden Sie Kakao Pay und Naver Pay für Abonnements und PAYCO für Einmalzahlungen. Das Einschließen aller drei ermöglicht es Dodo, je nach Checkout-Kontext die richtige Option anzubieten.
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Korean wallets not appearing at checkout">
    **Überprüfung:**

    1. Rechnungsland auf `KR` gesetzt?
    2. Währung auf `KRW` gesetzt?
    3. Wenn in einer anderen Währung bepreist: Adaptive Currency aktiviert?
    4. Das Wallet (`kakao_pay`, `naver_pay` oder `payco`) in `allowed_payment_method_types` enthalten?

    **Lösung:** Überprüfen Sie, ob die Rechnungsadresse `country: "KR"` und `billing_currency: "KRW"` hat.
  </Accordion>

  <Accordion title="Wallet missing for a subscription">
    **Ursache:** PAYCO wird nur für Einmalzahlungen angeboten. Für wiederkehrende Abrechnungen verwenden Sie Kakao Pay oder Naver Pay.

    **Lösung:** Einschließen von `kakao_pay` und `naver_pay` in `allowed_payment_method_types` für Abonnement-Checkouts.
  </Accordion>

  <Accordion title="Korean card declined on the international network">
    **Ursache:** Einige koreanische Karten laufen über nationale Netzwerke, die internationale Systeme nicht verarbeiten können.

    **Lösung:** Halten Sie `credit` und `debit` aktiviert, damit koreanische lokale Karten korrekt geroutet werden.
  </Accordion>
</AccordionGroup>

## Verwandte Seiten

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Sehen Sie alle unterstützten Zahlungsmethoden.
  </Card>

  <Card title="Credit & Debit Cards" icon="credit-card" href="/features/payment-methods/cards">
    Kartennetzwerke, einschließlich koreanischer lokaler Karten.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Rechnungstellung in der lokalen Währung der Kunden, einschließlich KRW.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Testdaten und Anleitungen zum Testen des Checkouts.
  </Card>
</CardGroup>