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

# Kredit- & Debitkarten

> Akzeptieren Sie alle großen Kredit- und Debitkarten-Netzwerke weltweit mit Dodo Payments. Erfahren Sie mehr über 3D Secure, gespeicherte Karten, Tokenisierung und regionale Kartensupport.

Kartenzahlungen sind die Grundlage der Online-Zahlungen, werden weltweit akzeptiert und von Kunden vertrauenswürdig angesehen. Dodo Payments unterstützt alle großen Kreditkarten-Netzwerke mit integriertem Betrugsschutz und PCI-Compliance.

## Unterstützte Karten-Netzwerke

### Globale Netzwerke

| Netzwerk             | Abdeckung                                                   |
| :------------------- | :---------------------------------------------------------- |
| **Visa**             | Globaler Marktführer, mehr als 4 Milliarden Karten weltweit |
| **Mastercard**       | Globale Reichweite, starke Sicherheitsmerkmale              |
| **American Express** | Premium-Karteninhaber, höhere Ausgaben                      |
| **Discover**         | US-zentriert, global wachsend                               |
| **JCB**              | Führend in Japan, expandiert in Asien                       |
| **UnionPay**         | Dominant in China, über 8 Milliarden Karten                 |
| **Diners Club**      | Premium internationale Reisende                             |

### Regionale Netzwerke

| Netzwerk               | Region                          |
| :--------------------- | :------------------------------ |
| **Interac**            | Kanadas Debitnetzwerk           |
| **Cartes Bancaires**   | Frankreichs nationales Netzwerk |
| **Korean Local Cards** | Koreanische Inlandsnetzwerke    |
| **Rupay**              | Indiens nationales Netzwerk     |

## Konfiguration

Verwenden Sie diese Werte in `allowed_payment_method_types`:

| Typ      | Beschreibung      |
| :------- | :---------------- |
| `credit` | Alle Kreditkarten |
| `debit`  | Alle Debitkarten  |

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

<Tip>
  Schließen Sie sowohl `credit` als auch `debit` ein, sofern Sie keinen bestimmten Grund haben, einen davon auszuschließen. Debitkarten werden von vielen Kunden bevorzugt und haben häufig niedrigere Gebühren.
</Tip>

## 3D Secure Authentifizierung

3D Secure (3DS) fügt eine Authentifizierungsebene hinzu, die Betrug und Rückbuchungen reduziert, indem die Identität des Karteninhabers verifiziert wird.

### Wann 3DS ausgelöst wird

3DS wird automatisch ausgelöst, wenn:

* Vom Karten-Netzwerk erforderlich
* Von regionalen Vorschriften gefordert (z. B. PSD2 in Europa)
* Die Transaktion als risikobehaftet eingestuft wird

### 3DS erzwingen

Sie können 3DS für alle Transaktionen anfordern:

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});
```

<Note>
  Die Aktivierung von 3DS für alle Transaktionen reduziert Betrug, kann aber die Conversion leicht verringern, da einige Kunden während der Authentifizierung abbrechen.
</Note>

### Umgang mit Authentifizierungsfehlern

Wenn eine Zahlung eine 3DS-Authentifizierung benötigt, durchläuft die Zahlung Zwischenzustände, bevor sie erfolgreich ist oder fehlschlägt:

| Status                     | Bedeutung                                                                                                                                                                  | Was zu tun ist                                                                                                                                      |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `requires_customer_action` | Der Kunde muss eine 3DS-Herausforderung abschließen                                                                                                                        | Lassen Sie den Kunden die Authentifizierung während des Checkouts abschließen                                                                       |
| `requires_payment_method`  | Der Kunde hat nie eine Zahlungsmethode bereitgestellt (hat keine Details eingegeben oder die Eingabeaufforderung abgebrochen) – normalerweise ein Abbruch, keine Ablehnung | Den Kunden ermutigen, den Checkout abzuschließen; siehe [Wiederherstellung von verlassenen Warenkörben](/features/recovery/abandoned-cart-recovery) |

Wenn die Authentifizierung nicht abgeschlossen wird, schlägt die Zahlung mit einem dieser Ablehnungscodes fehl:

* `AUTHENTICATION_FAILURE` — der Kunde konnte nicht authentifiziert werden.
* `AUTHENTICATION_REQUIRED` — Authentifizierung ist erforderlich, wurde jedoch nicht durchgeführt.
* `AUTHENTICATION_TIMEOUT` — der Kunde hat nicht rechtzeitig geantwortet.

Siehe die Referenz [Transaktionsfehler](/api-reference/transaction-failures) für die empfohlene Aktion für jeden.

#### Beim Checkout vs. bei der Erneuerung

* **Beim Checkout (Kunde anwesend):** Der Kunde ist anwesend, daher wird die 3DS-Herausforderung während des Checkouts angezeigt. Wenn sie fehlschlägt, bitten Sie ihn, es erneut zu versuchen oder eine andere Karte zu verwenden.
* **Bei Abonnementerneuerung (Kunde nicht anwesend):** Der Kunde ist nicht anwesend, daher kann eine 3DS-Herausforderung nicht in Echtzeit angezeigt werden. Wenn eine Erneuerung eine Authentifizierung erfordert, wechselt das Abonnement zu `on_hold`. Stellen Sie es wieder her, indem Sie den Kunden auffordern, zurückzukehren und seine Zahlungsmethode zu aktualisieren – siehe [Zahlungsfehler behandeln](/developer-resources/handle-payment-failures) und [Abonnement Dunning](/features/recovery/subscription-dunning).

## Gespeicherte Zahlungsmethoden

Kunden können ihre Karten für schnellere zukünftige Checkouts speichern.

<CardGroup cols={3}>
  <Card title="Tokenized" icon="lock">
    Originale Kartennummern werden nie gespeichert.
  </Card>

  <Card title="PCI Compliant" icon="shield-check">
    Dodo übernimmt alle Compliance-Anforderungen.
  </Card>

  <Card title="Customer-Scoped" icon="user">
    Karten sind spezifischen Kunden zugeordnet.
  </Card>
</CardGroup>

### Gespeicherte Karten aktivieren

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});
```

### Ein-Klick-Käufe

```javascript theme={null}
// Get customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Use saved card for instant checkout
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});
```

## Testen

<Tabs>
  <Tab title="Successful Payments">
    | Region | Marke      | Kartennummer       | Ablaufdatum | CVV |
    | :----- | :--------- | :----------------- | :---------- | :-- |
    | US     | Visa       | `4242424242424242` | 06/32       | 123 |
    | US     | Mastercard | `5555555555554444` | 06/32       | 123 |
    | Indien | Visa       | `4576238912771450` | 06/32       | 123 |
    | Indien | Mastercard | `5409162669381034` | 06/32       | 123 |
  </Tab>

  <Tab title="Declined Payments">
    | Region | Marke      | Kartennummer       | Szenario             |
    | :----- | :--------- | :----------------- | :------------------- |
    | US     | Visa       | `4000000000000002` | Allgemeine Ablehnung |
    | US     | Mastercard | `4000000000009995` | Unzureichende Mittel |
    | Indien | Visa       | `4706131211212123` | Allgemeine Ablehnung |
    | Indien | Mastercard | `5105105105105100` | Allgemeine Ablehnung |
  </Tab>
</Tabs>

<Warning>
  Testkarten funktionieren nur im Testmodus. Verwenden Sie sie niemals für Produktionstransaktionen.
</Warning>

## Sicherheit & Compliance

| Feature              | Beschreibung                     |
| :------------------- | :------------------------------- |
| **PCI DSS Level 1**  | Höchste Zertifizierungsstufe     |
| **Tokenisierung**    | Kartennummern sofort tokenisiert |
| **Betrugserkennung** | Echtzeit-Risikobewertung         |
| **AVS**              | Address Verification Service     |
| **CVV-Validierung**  | Sicherheitscode-Überprüfung      |
| **3D Secure**        | Karteninhaber-Authentifizierung  |

## Beste Praktiken

<AccordionGroup>
  <Accordion title="Accept all major networks">
    Beschränken Sie Kartentypen nur, wenn es notwendig ist. Kunden erwarten, dass ihre bevorzugte Karte funktioniert.
  </Accordion>

  <Accordion title="Display card logos">
    Zeige Visa-, Mastercard-, Amex-Logos an Ihrem Checkout, um Vertrauen aufzubauen.
  </Accordion>

  <Accordion title="Handle declines gracefully">
    Zeigen Sie klare Fehlermeldungen an. Geben Sie keine rohen Fehlercodes an Kunden weiter.
  </Accordion>

  <Accordion title="Enable saved cards for returning customers">
    Gespeicherte Zahlungsmethoden steigern erheblich die Konversion bei wiederholten Käufen.
  </Accordion>
</AccordionGroup>

## Fehlersuche

<AccordionGroup>
  <Accordion title="Card declined">
    **Ursachen:** Unzureichende Mittel, abgelaufene Karte, falscher CVV, Betrugsschutz der Bank.

    **Lösung:** Bitten Sie den Kunden, die Details zu überprüfen oder eine andere Karte zu versuchen. Suchen Sie den spezifischen Ablehnungs `Error Code` und die empfohlene Aktion in der Referenz [Transaktionsfehler](/api-reference/transaction-failures) und sehen Sie sich [Zahlungsfehler behandeln](/developer-resources/handle-payment-failures) für die programmgesteuerte Verarbeitung an.
  </Accordion>

  <Accordion title="3DS authentication failed">
    **Ursachen:** Kunde hat abgebrochen, Banksystem nicht verfügbar, Zeitüberschreitung.

    **Lösung:** Erneut versuchen oder Kunden bitten, ihre Bank zu kontaktieren. Siehe [Umgang mit Authentifizierungsfehlern](#handling-authentication-failures) für die beteiligten Zahlungszustände und Ablehnungscodes.
  </Accordion>

  <Accordion title="Card not supported">
    **Ursachen:** Regionale Karte nicht unterstützt, Einschränkungen bei Prepaid-Karten.

    **Lösung:** Kunde sollte eine andere Karte von einem großen Netzwerk ausprobieren.
  </Accordion>
</AccordionGroup>

## Verwandte Seiten

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="layer-group" href="/features/payment-methods">
    Alle unterstützten Zahlungsmethoden.
  </Card>

  <Card title="Upsells & Downsells" icon="arrow-up-right-dots" href="/features/upsells-and-downsells">
    Ein-Klick-Käufe mit gespeicherten Karten.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Kompletter Testleitfaden.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Wiederkehrende Abrechnungen mit Karten.
  </Card>
</CardGroup>