Kredit- & Debitkarten

​

Unterstützte Karten-Netzwerke

​

Globale Netzwerke

​

Regionale Netzwerke

​

Konfiguration

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

​

3D Secure Authentifizierung

​

Wann 3DS ausgelöst wird

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

​

3DS erzwingen

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

​

Umgang mit Authentifizierungsfehlern

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

​

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 und Abonnement Dunning.

​

Gespeicherte Zahlungsmethoden

​

Gespeicherte Karten aktivieren

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

// 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

​

Sicherheit & Compliance

​

Beste Praktiken

​

Fehlersuche

​

Verwandte Seiten