Kredit- & Debitkarten

Karten sind bei jedem Dodo Payments Checkout in jedem unterstützten Land und jeder unterstützten Währung verfügbar. Dodo Payments akzeptiert die gängigen Kartennetzwerke, ersetzt Kartennummern durch Tokens und führt die für Kartenzahlungen erforderlichen Prüfungen durch, sodass Sie keine unverarbeiteten Kartendaten handhaben müssen.

Unterstützte Karten-Netzwerke

Dodo Payments akzeptiert globale Netzwerke und mehrere regionale Netzwerke.

Globale Netzwerke

Network	Coverage
Visa	Weltweit führend, über 4 Mrd. Karten weltweit
Mastercard	Globale Reichweite, starke Sicherheitsfunktionen
American Express	Premium-Karteninhaber, höhere Ausgaben
Discover	Auf die USA fokussiert, weltweit zunehmend verbreitet
JCB	Führend in Japan, expandiert in Asien
UnionPay	Dominierend in China
Diners Club	Internationale Premium-Reisende

Regionale Netzwerke

Network	Region
Interac	Kanadas Debitnetzwerk
Cartes Bancaires	Frankreichs nationales Netzwerk
Korean Local Cards	Koreanische Inlandsnetzwerke
Rupay	Indiens nationales Netzwerk

Konfiguration

Cards verwenden zwei Werte in allowed_payment_method_types:

Type	Description
`credit`	Alle Kreditkarten
`debit`	Alle Debitkarten

Diese Sitzung bietet nur Kartenzahlungen an:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});

Füge sowohl credit als auch debit hinzu, sofern du keinen bestimmten Grund hast, einen der beiden Werte auszuschließen. Viele Kunden bevorzugen die Zahlung mit einer Debitkarte.

3D-Secure-Authentifizierung

3D Secure (3DS) bittet die Bank des Karteninhabers, die Identität des Karteninhabers zu bestätigen, beispielsweise mit einem Einmalcode, einer biometrischen Prüfung oder einer Bestätigung in der Banking-App. Dadurch werden Betrug und Rückbuchungen reduziert.

Wann 3DS ausgelöst wird

Dodo Payments fordert 3DS an, wenn:

Das Kartennetzwerk dies verlangt.
Eine regionale Vorschrift dies verlangt, beispielsweise PSD2 in Europa.
Die Transaktion als risikoreich eingestuft wird.

3DS erzwingen

Um 3DS für jede Kartenzahlung deines Unternehmens zu verlangen, aktiviere 3D Secure unter Settings → Pricing. Um diese Einstellung für eine einzelne Checkout-Sitzung zu überschreiben, übergib force_3ds:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

Die Anforderung von 3DS für jede Transaktion reduziert Betrug, kann aber die Conversion-Rate senken, da einige Kunden den Checkout während der Authentifizierung abbrechen.

Umgang mit Authentifizierungsfehlern

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

Status	Meaning	What to do
`requires_customer_action`	Der Kunde muss eine 3DS-Herausforderung abschließen	Lass den Kunden die Authentifizierung während des Checkouts abschließen
`requires_payment_method`	Der Kunde hat nie eine Zahlungsmethode angegeben (keine Daten eingegeben oder die Aufforderung abgebrochen). Dies ist normalerweise ein Abbruch und keine Ablehnung	Gewinne den Kunden zurück, damit er den Checkout abschließt. Siehe 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: Eine Authentifizierung ist erforderlich, wurde aber nicht durchgeführt.
AUTHENTICATION_TIMEOUT: Der Kunde hat nicht rechtzeitig geantwortet.

Die Referenz Transaction Failures enthält die empfohlene Aktion für jeden Code.

Beim Checkout vs. bei der Verlängerung

Beim Checkout (Kunde anwesend): Die 3DS-Herausforderung wird während des Checkouts angezeigt. Wenn sie fehlschlägt, bitte den Kunden, es erneut zu versuchen oder eine andere Karte zu verwenden.
Bei der Abonnementverlängerung (Kunde nicht anwesend): Eine 3DS-Herausforderung kann nicht in Echtzeit angezeigt werden. Wenn eine Verlängerung eine Authentifizierung erfordert und fehlschlägt, wechselt das Abonnement zu on_hold oder zunächst zu past_due, wenn du eine grace period festgelegt hast. Um es wiederherzustellen, fordere den Kunden auf, zurückzukehren und seine Zahlungsmethode zu aktualisieren. Siehe Handle Payment Failures und Subscription Dunning.

Gespeicherte Zahlungsmethoden

Wiederkehrende Kunden können mit einer Karte bezahlen, die bei einem früheren Checkout gespeichert wurde.

Tokenized

Originale Kartennummern werden niemals gespeichert.

PCI Compliant

Dodo Payments übernimmt die PCI-Compliance.

Customer-Scoped

Jede gespeicherte Karte gehört genau einem Kunden.

Gespeicherte Karten aktivieren

Um beim Checkout die gespeicherten Karten eines wiederkehrenden Kunden anzuzeigen, übergib show_saved_payment_methods: true zusammen mit dem vorhandenen customer_id. Der Standardwert ist false.

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

Käufe mit einem Klick

Um eine gespeicherte Karte zu belasten, ohne den Checkout anzuzeigen, übergib deren payment_method_id zusammen mit confirm: true und dem vorhandenen customer_id. Die Sitzung belastet die Karte direkt und gibt kein checkout_url zurück. Verwende daher Webhooks, um das Zahlungsergebnis zu erfahren.

// `client` is an initialized DodoPayments client.
// Get the customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Charge the first saved card
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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

Verwende diese Karten im Testmodus. Weitere Testdaten findest du unter Testing Process.

Successful Payments
Declined Payments

Region	Brand	Card Number	Expiry	CVV
US	Visa	`4242424242424242`	06/32	123
US	Mastercard	`5555555555554444`	06/32	123
India	Visa	`4576238912771450`	06/32	123
India	Mastercard	`5409162669381034`	06/32	123

Region	Brand	Card Number	Scenario
US	Visa	`4000000000000002`	Allgemeine Ablehnung
US	Visa	`4000000000009995`	Unzureichendes Guthaben
India	Visa	`4706131211212123`	Allgemeine Ablehnung
India	Mastercard	`5105105105105100`	Allgemeine Ablehnung

Testkarten funktionieren nur im Testmodus. Im Live-Modus schlägt eine mit einer Testkarte durchgeführte Zahlung fehl.

Sicherheit und Compliance

Dodo Payments wendet diese Schutzmaßnahmen auf Kartenzahlungen an:

Feature	Description
PCI DSS Level 1	Die höchste Stufe der PCI-DSS-Zertifizierung
Tokenization	Kartennummern werden bei der Eingabe tokenisiert
Fraud Scoring	Risikobewertung in Echtzeit
CVV Validation	Überprüfung des Sicherheitscodes
3D Secure	Authentifizierung des Karteninhabers

Best Practices

Accept all major networks

Beschränke Kartentypen nur, wenn dies erforderlich ist. Kunden erwarten, dass ihre bevorzugte Karte funktioniert.

Display card logos

Zeige die Logos von Visa, Mastercard und Amex auf deiner Website, um Vertrauen aufzubauen.

Handle declines gracefully

Zeige klare Fehlermeldungen an. Zeige Kunden keine unverarbeiteten Fehlercodes.

Enable saved cards for returning customers

Gespeicherte Zahlungsmethoden beschleunigen Wiederholungskäufe für wiederkehrende Kunden.

Fehlerbehebung

Card declined

Ursachen: Unzureichendes Guthaben, eine abgelaufene Karte, ein falscher CVV oder der Betrugsschutz der Bank.Lösung: Bitte den Kunden, seine Daten zu überprüfen oder eine andere Karte zu verwenden. Suche den Fehlercode der Ablehnung und die empfohlene Aktion in der Referenz Transaction Failures nach. Unter Handle Payment Failures erfährst du, wie du Ablehnungen im Code behandelst.

3DS authentication failed

Ursachen: Der Kunde hat die Herausforderung abgebrochen, das System der Bank war nicht verfügbar oder die Herausforderung ist abgelaufen.Lösung: Versuche es erneut oder bitte den Kunden, seine Bank zu kontaktieren. Unter Handling Authentication Failures findest du die betreffenden Zahlungsstatus und Ablehnungscodes.

Card not supported

Ursachen: Das regionale Netzwerk wird nicht unterstützt oder die Karte ist eine eingeschränkte Prepaid-Karte.Lösung: Bitte den Kunden, eine Karte eines großen Netzwerks zu verwenden.

Payment Methods Overview

Alle unterstützten Zahlungsmethoden.

Upsells & Downsells

Käufe mit einem Klick und gespeicherten Karten.

Testing Process

Testdaten für jede Zahlungsmethode.

Subscriptions

Wiederkehrende Abrechnung mit Karten.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Unterstützte Karten-Netzwerke

Globale Netzwerke

Regionale Netzwerke

Konfiguration

3D-Secure-Authentifizierung

Wann 3DS ausgelöst wird

3DS erzwingen

Umgang mit Authentifizierungsfehlern

Beim Checkout vs. bei der Verlängerung

Gespeicherte Zahlungsmethoden

Tokenized

PCI Compliant

Customer-Scoped

Gespeicherte Karten aktivieren

Käufe mit einem Klick

Testen

Sicherheit und Compliance

Best Practices

Fehlerbehebung

Verwandte Seiten

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

​Unterstützte Karten-Netzwerke

​Globale Netzwerke

​Regionale Netzwerke

​Konfiguration

​3D-Secure-Authentifizierung

​Wann 3DS ausgelöst wird

​3DS erzwingen

​Umgang mit Authentifizierungsfehlern

​Beim Checkout vs. bei der Verlängerung

​Gespeicherte Zahlungsmethoden

Tokenized

PCI Compliant

Customer-Scoped

​Gespeicherte Karten aktivieren

​Käufe mit einem Klick

​Testen

​Sicherheit und Compliance

​Best Practices

​Fehlerbehebung

​Verwandte Seiten

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

Unterstützte Karten-Netzwerke

Globale Netzwerke

Regionale Netzwerke

Konfiguration

3D-Secure-Authentifizierung

Wann 3DS ausgelöst wird

3DS erzwingen

Umgang mit Authentifizierungsfehlern

Beim Checkout vs. bei der Verlängerung

Gespeicherte Zahlungsmethoden

Gespeicherte Karten aktivieren

Käufe mit einem Klick

Testen

Sicherheit und Compliance

Best Practices

Fehlerbehebung

Verwandte Seiten