Wiederkehrende Zahlungen, auch Abonnementzahlungen genannt, werden einem Kunden in regelmäßigen Abständen automatisch in Rechnung gestellt.

Implementierungsablauf

Mit Computop können Sie wiederkehrende Zahlungen in nur drei einfachen Schritten einrichten und abrechnen:

  1. Erste Transaktion mit wiederkehrender Absicht
  2. Anmeldedaten sicher speichern
  3. Folgende wiederkehrende Transaktionen

1. Erste Transaktion

Richten Sie die Absicht für eine wiederkehrende Zahlung ein, indem Sie die folgenden Informationen im Objekt credentialOnFile übergeben: 

{
  ...
  "credentialOnFile": {
    "type": "RECURRING",
    "initialPayment": true,
    "recurring": {
      "frequency": "DAILY", // "WEEKLY"/"MONTHLY"/"YEARLY"
      "startDate": "2025-01-01",
      "expiryDate": "2025-12-01",
      "useCase": "FIXED", // "FLEXIBLE_AMOUNT"/"FLEXIBLE_FREQUENCY"
    }
  }
}


Parameterübersicht

ParameterWerteBeschreibung
frequencyDAILY/MONTHLY/WEEKLY/YEARLYAbrechnungsintervall
startDateYYYY-MMM-DDDatum der ersten Abbuchung
expiryDateYYYY-MMM-DDKündigungsdatum
useCaseFIXED/FLEXIBLE_AMOUNT/FLEXIBLE_FREQUENCY
  • FIXED: Gleicher Betrag/gleiches Intervall. Z. B. Abonnements für SaaS-Produkte
  • FLEXIBLE_AMOUNT: Unterschiedliche Gebühren. Z. B. verbrauchsabhängige Nebenkostenabrechnung
  • FLEXIBLE_FREQUENCY: Anpassbare Intervalle. Z. B. Abonnements mit der Möglichkeit, die Abrechnungsintervalle im Laufe der Zeit zu ändern.


2. Speicherung der Anmeldedaten

Nach Erhalt der erfolgreichen Zahlungsbestätigung für die erste Transaktion werden die Anmeldedaten je nach Integrationsart sicher gespeichert:

IntegrationsartAktion

Gehostete Formulare – Gehostete Zahlungsseite or Kreditkarten Gehostete Formulare

Rufen Sie die pseudoCardNumber ab, indem Sie Zahlungsdetails per Payment ID abrufen aufrufen und speichern sie. 

{
  ...
  "paymentMethods": {
    "type": "CARD",
    "card": {
      "cardholderName": "John Doe",
      "pseudoCardNumber": "01234567890124444",
      "first6Digits": 555555,
      "last4Digits": 4444,
      "expiryDate": "01.01.2028",
      "schemeReferenceId": "4234234234",
      ......
      ......
    }
  }
}


Direkte Integration

Speichern Sie entweder:

  • sicher eindeutige Kartendaten, die Sie bereits während des Zahlungsvorgangs haben.
  • die in der Zahlungsantwort erhaltene pseudoCardNumber, falls Sie den Dienst aktiviert haben.

3. Nachfolgende Transaktionen

Nachfolgende Transaktionen für einen ungeplanten MIT sollten immer über die direkte Integration gesendet werden.

  • Übergeben Sie die folgenden Daten im Objekt credentialOnFile für nachfolgende wiederkehrende Transaktionen: 

    {
  ...
  "credentialOnFile": {
    "type": "RECURRING",
    "initialPayment": false,
    "recurring": {
      "frequency": "daily", // "weekly"/"monthly"/"yearly"
      "startDate": "2025-01-01",
      "expiryDate": "2025-12-01",
      "useCase": "FIXED", // "FLEXIBLE_AMOUNT"/"FLEXIBLE_FREQUENCY"
    }
  }
}


  • Übergeben Sie zusätzlich zu den obigen Daten die gespeicherten Anmeldeinformationen und die schemeReferenceId, die zuvor in der Antwort der ersten Transaktion zurückgegeben wurden: 

    {
  ...
  "paymentMethods": {
    "type": "CARD",
    "card": {
      "expiryDate": "202506",
      "cardHolderName": "John Doe",
      "securityCode": "123",
      "number": "5555555555554444", // clear card number or pseudo card number
      "schemeReferenceId": "4234234234"
      .....
      .....
    }
  }
}




  • No labels