View Source

Die Lösung ermöglicht es Händlern, Kundenzahlungsinformationen (mit Zustimmung) für zukünftige Transaktionen zu speichern. Das reduziert den Aufwand beim Bezahlvorgang und verbessert die Konversionsraten.

Es gibt zwei Anwendungsfälle, die die Speicherung von Anmeldeinformationen erfordern:

Ungeplante, vom Kunden initiierte Transaktionen (CITs): CITs entstehen, wenn Kunden eine Zahlung beim Bezahlvorgang aktiv autorisieren. Um den Prozess für wiederkehrende Kunden zu optimieren, können Sie Zahlungsanmeldeinformationen (mit Zustimmung) sicher speichern und so schnellere „One-Click“-Transaktionen für zukünftige Einkäufe ermöglichen.
Ungeplante, vom Händler initiierte Transaktionen (MITs): MITs entstehen, wenn Sie eine Zahlung ohne direkte Beteiligung des Kunden initiieren. Sie können eine ungeplante MIT basierend auf einer ausdrücklichen vorherigen Autorisierung des Kunden zur Speicherung und Verwendung seiner Anmeldeinformationen initiieren.

Implementierungsablauf

Sie können ungeplante CITs und MITs mit in drei einfachen Schritten einrichten:

Erste Transaktion mit CIT/MIT-Absicht
Anmeldedaten sicher speichern
Nachfolgende Transaktionen

Ungeplante CITs

1. Erste Transaktion

Richten Sie die Absicht für eine ungeplante CIT ein, indem Sie die folgenden Informationen im Objekt credentialOnFile in der Zahlungsanforderung angeben:

"credentialOnFile": {
  "type": "UNSCHEDULED",
  "initialPayment": true
  "unscheduled": {
      "subType": "CIT"
  }
}

2. Speichern der Anmeldedaten

Speichern Sie die Anmeldedaten je nach Integrationsart sicher, sobald die Zahlungsbestätigung für die erste Transaktion erfolgreich war:

Integrationsart Aktion

Gehostete Formulare – Gehostete Zahlungsseite oder 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": "534525242342",
      ......
      ......
    }
  }
}

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

Senden Sie die nachfolgende Zahlungsanforderung mit Anforderungsparametern je nach Ihrer Integrationsart

Integrationsart Zahlungsparameter

Gehostete Formulare – Hosted Payment Page oder zahlartenspezifische Formulare

Übergeben Sie das Objekt credentialOnFile wie folgt:

{
  ...
  "credentialOnFile": {
      "type": "UNSCHEDULED",
      "initialPayment": false,
      "unscheduled": {
          "subType": "CIT"
      }
  }
}

Übergeben Sie die Pseudo-Kartennummer im Objekt prefillInfo und die zuvor in der Antwort der ersten Transaktion zurückgegebene schemeReferenceId für einen schnelleren Bezahlvorgang.

{
  ...
  "paymentMethods": {
    "type": "CARD",
    "card": {
      "prefillInfo": {
          "number": "01234567890124444",
          "cardholderName": "John Doe",
          "expiryDate": "01.01.2028",
          .....
          .....
      },
      "schemeReferenceId": "534525242342"
    }
  }
}

Direkte Integration

Übermitteln Sie das Objekt credentialOnFile wie folgt:

{
  ...
  "credentialOnFile": {
      "type": "UNSCHEDULED",
      "initialPayment": false,
      "unscheduled": {
          "subType": "CIT"
      }
  }
}

Übergeben Sie die gespeicherten Anmeldeinformationen oder die Pseudokartennummer im Objekt paymentMethods.card und die zuvor in der Antwort der ersten Transaktion zurückgegebene schemeReferenceId:

"paymentMethods": {
  "type": "CARD",
  "card": {
    "number": "5555555555554444",
    "cardholderName": "John Doe",
    "expiryDate": "01.01.2028",
    "securityCode": "123"
    .....
    .....
  }
}

Verwenden SIe den Customer Vault anstatt prefillInfo, wenn Sie über gehostete Formulare integriert sind, um ein besseres Kundenerlebnis und einen geringeren Integrationsaufwand zu erzielen.

Ungeplante MITs

1. Erste Transaktion

Richten Sie die Absicht für einen ungeplanten MIT ein, indem Sie folgende Informationen im Objekt credentialOnFile übergeben:

{
  ...
  "credentialOnFile": {
    "type": "UNSCHEDULED",
    "initialPayment": true,
    "unscheduled": {
    "subType": "MIT"
    }
  }
}

2. Speichern der Anmeldedaten

Speichern Sie die Anmeldedaten je nach Integrationsart sicher, sobald die Zahlungsbestätigung für die erste Transaktion erfolgreich war:

Integrationsart Aktion

Gehostete Formulare – Hosted Payment Page oder zahlartenspezifische 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": "534525242342",
      ......
      ......
    }
  }
}

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 MITs:

{
  ...
  "credentialOnFile": {
    "type": "UNSCHEDULED",
    "initialPayment": false,
    "unscheduled": {
        "subType": "MIT"
    }
  }
}

Ü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": {
      "number": "5555555555554444", // clear card number or pseudo card number
      "cardHolderName": "John Doe",
      "expiryDate": "202506",
      "securityCode": "123",
      "schemeReferenceId": "534525242342"
      .....
      .....
    }
  }
}