Wiederkehrende Zahlungen (MIT)

Wiederkehrende Zahlungen ermöglichen es Ihnen, Kunden nach einem Zeitplan zu belasten, ohne deren aktive Beteiligung. Dies ist ein Merchant Initiated Transaction (MIT)-Ablauf.

So funktioniert es

Der Ablauf für wiederkehrende Zahlungen besteht aus zwei Phasen:

Erste Zahlung — Der Kunde authentifiziert sich und bezahlt, wodurch er die Erlaubnis für zukünftige Belastungen erteilt
Nachfolgende Zahlungen — Sie belasten die gespeicherte Karte des Kunden ohne dessen Interaktion

Phase 1: Erste Zahlung

Erstellen Sie eine Bestellung mit recurring_type: "first" und einem schedule_type:

POST /v1/orders/

{
  "merchant_order_id": "first-recurring",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "first",
      "schedule_type": "scheduled"
    }
  ]
}

Zeitplantypen

Typ	Beschreibung
`scheduled`	Fester Zeitplan (z. B. monatliches Abonnement)
`unscheduled`	Variabler Zeitpunkt (z. B. Aufladung bei niedrigem Guthaben)

Nach erfolgreicher Zahlung speichern Sie den vault_token und/oder die first_transaction_id aus der Antwort.

Phase 2: Nachfolgende wiederkehrende Zahlung

Belasten Sie den Kunden mit dem gespeicherten Token:

POST /v1/orders/

{
  "merchant_order_id": "recurring-order",
  "currency": "EUR",
  "amount": 995,
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "recurring",
      "vault_token": "{vault_token}"
    }
  ]
}

Wiederkehrende Zahlungen geben keine payment_url in der Antwort zurück, da keine Kundeninteraktion erforderlich ist. Die Zahlung wird sofort verarbeitet.

Sie können entweder vault_token oder first_transaction_id verwenden, um auf die gespeicherte Karte zu verweisen.

Token-Gültigkeit

Wiederkehrende Token haben eine maximale Gültigkeit von 1 Jahr. Nach Ablauf müssen Sie eine neue erste Zahlung einleiten, um einen neuen Token zu erhalten.

Stellen Sie sicher, dass Ihr System den Token-Ablauf ordnungsgemäß behandelt. Richten Sie einen Prozess ein, um Kunden erneut zu authentifizieren, bevor ihre Token ablaufen.

Wiederkehrend vs. Ein-Klick

Merkmal	Wiederkehrend (MIT)	Ein-Klick (CIT)
Initiiert von	Händler	Kunde
Kunde anwesend	Nein	Ja
Anwendungsfall	Abonnements, geplante Abrechnungen	Schneller Checkout für wiederkehrende Kunden
`schedule_type` erforderlich	Ja	Nein
`payment_url` zurückgegeben	Nein	Ja