Überblick über den Prozess
Anforderung
Bei der Lektüre dieses Dokuments müssen Sie sich über drei verschiedene Arten von Anträgen im Klaren sein, die bearbeitet werden:
- Erstens, eine THREEDQUERY Anfrage verarbeitet wird, die zur Durchführung der 3-D Secure Authentifizierung verwendet wird.
- Zweitens, ein ACCOUNTCHECK Anfrage bearbeitet wird, wobei AVS und Sicherheitscode-Kontrollen durchgeführt werden. Diese fungiert als Muttergesellschaft für alle nachfolgenden automatischen Zahlungen in dieser Serie.
Account Checks werden von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren.
- Schließlich wird ein SUBSCRIPTION Anfrage verarbeitet, die dazu dient, unserer Abonnementmodul mitzuteilen, wann die nachfolgenden automatischen Zahlungen verarbeitet werden sollen.
Aktualisieren Sie das JWT payload
Sie müssen die payload innerhalb des JWT, um die oben beschriebenen Anfragen zu übermitteln und auch zusätzliche Felder zu enthalten, die für den Abonnementprozess spezifisch sind.
Die Transaktion
Wenn der Kunde tippt "Pay" auf Ihrem Bestellformular eingeben, wird der Kunde mit 3-D Secure authentifiziert. Daraufhin wird eine ACCOUNTCHECK verarbeitet und zukünftige Zahlungen werden in unserer Abonnementmodul geplant. Gelder werden nicht sofort auf dem Konto des Kunden reserviert werden. Die erste Zahlung wird zu einem späteren Zeitpunkt, in den in Ihrem Antrag angegebenen Abständen, automatisch von unserer Abonnementmodul verarbeitet. Alle Zahlungen werden automatisch von unserer Abonnementmodul verarbeitet. Die Anzahl der zu verarbeitenden Folgezahlungen wird in der JWT festgelegt.
Abonnement mit sofortiger Bezahlung
Wenn Sie möchten, dass die erste Zahlung sofort verarbeitet wird, klicken Sie hier, um eine Dokumentation über ein alternatives Verfahren zu erhalten, das dies unterstützt.
Konfiguration
Aktualisieren Sie das JWT
Sie müssen das JWT payload aktualisieren, damit es zusätzliche Felder mit den Informationen enthält, die für die Planung des Abonnements nach der ersten Anfrage erforderlich sind.
Beispiel
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencycode":"GBP",
"sitereference":"test_site12345",
"subscriptiontype":"RECURRING",
"subscriptionunit":"MONTH",
"subscriptionfrequency":"1",
"subscriptionnumber":"1",
"subscriptionfinalnumber":"12",
"subscriptionbegindate":"2020-01-01",
"credentialsonfile":"1",
"requesttypedescriptions":["THREEDQUERY","ACCOUNTCHECK","SUBSCRIPTION"]
},
"iat":"1567701632",
"iss":"jwt.user"
}
Feldspezifikation
Feld | Format | Beschreibung | |
baseamount | Numerisch (13) |
Der in regelmäßigen Abständen zu zahlende Betrag, in Basiseinheiten, ohne Komma oder Dezimalpunkt, so dass €10 als 1000 übermittelt wird. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - wenden Sie sich für weitere Informationen an Ihre Bank) Anmerkung: Auf der Website ACCOUNTCHECK werden keine Mittel reserviert. Die erste Zahlung wird entweder am angegebenen subscriptionbegindate oder nachdem das erste Intervall verstrichen ist (z. B. 1 MONTH oder 7 DAY). |
|
credentialsonfile | Numerisch (1) |
Übermitteln Sie den Wert "1", um anzugeben, dass die in der ersten Anfrage übermittelten Anmeldedaten für nachfolgende Abonnementzahlungen gespeichert werden. Hinweis: Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten für die zukünftige Verwendung speichern. Wenn Ihr System diesen Wert nicht in der Anfrage übermittelt, wird unser System automatisch Versuch um die Anfrage mit dem richtigen credentialsonfile Wert. Wenn Sie ein neues Abonnement mit zuvor gespeicherten Anmeldeinformationen bearbeiten, müssen Sie weiterhin credentialsonfile = 1, um anzugeben, dass die Anmeldeinformationen weiterhin für Zahlungen in dieser spezifischen Abonnementfolge gespeichert werden. |
|
currencyiso3a | Alpha (3) |
Die Währung , die jeder Zahlung in der Abonnementreihenfolge zugewiesen ist. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
|
requesttypedescriptions | Liste | Diese muss auf ["THREEDQUERY","ACCOUNTCHECK","SUBSCRIPTION"]. | |
subscriptionbegindate | Datum JJJJ-MM-TT |
Dieses Feld bezieht sich auf den Zeitpunkt der ersten automatisiert Die Zahlung wird bearbeitet. Von da an verwenden wir die Daten, die im Formular subscriptionunit und subscriptionfrequency Felder, um die Abonnementzahlungen in regelmäßigen Abständen automatisch zu verarbeiten.
Wenn z. B. ein Zeichnungsantrag am 5. Januar 2018 eingereicht wird das Intervall ist 1 MONTH (subscriptionfrequency = 1 und subscriptionunit = MONTH) und subscriptionbegindate ist 2018-01-08, die erste automatische Zahlung wird am 8. Januar 2018 verarbeitet, alle weiteren Zahlungen werden am 8. eines jeden Monats verarbeitet. Wenn Sie den Antrag nicht einreichen subscriptionbegindate, werden wir die subscriptionunit und subscriptionfrequency um automatisch die erste automatische Zahlung zu planen. Monatliche Abonnements, die am Ende des Monats vorgesehen sind, werden am 28. Tag bearbeitet. Wenn das Datum der ersten automatischen Zahlung der 29., 30. oder 31. Tag ist, werden alle weiteren Zahlungen in den folgenden Monaten am 28. Damit sollen Probleme bei Abonnementzahlungen in Monaten vermieden werden, die weniger Tage haben als andere. |
|
subscriptionfinalnumber | Numerisch (5) |
Hier wird die Anzahl der Zahlungen festgelegt, die während der Laufzeit des Abonnements verarbeitet werden sollen: Bei der Bearbeitung einer kombinierten ACCOUNTCHECK SUBSCRIPTION Anfrage: Wenn subscriptionnumber = 1 Anmerkung: Wenn die subscriptionfinalnumber Wert "0" ist, plant das Abonnementmodul Zahlungen auf unbestimmte Zeit, bis der Benutzer das Abonnement manuell auf Inaktiv. |
|
subscriptionfrequency | Numerisch (11) |
In Kombination mit der Einheit legt die Häufigkeit fest, wie häufig Zahlungen verarbeitet werden. z.B. für eine Zahlung alle 7 Tage: subscriptionfrequency = 7 und subscriptionunit = DAY z.B. für eine Zahlung alle 2 Monate: subscriptionfrequency = 2 und subscriptionunit = MONTH |
|
subscriptionnumber | Numerisch (5) |
|
|
subscriptiontype | Alpha (11) |
Dieses Feld gibt die Art des zu bearbeitenden Abonnements an. Ihr System kann diese beiden Werte übermitteln:
*Installationen werden von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren. |
|
subscriptionunit | Alpha (5) |
Dieses Feld gibt die Zeiteinheit zwischen den einzelnen Abonnements an. Dies kann entweder "DAY" oder "MONTH". Anmerkung: Dieses Feld muss unbedingt in GROSSBUCHSTABEN an das Gateway übermittelt werden ("DAY" oder "MONTH"). |
|
transactionactive | Numerisch (1) |
Der Status des Abonnements.
"0" - Inaktiv: Setzt zukünftige Zahlungen aus, bis sie manuell überschrieben werden. (Siehe Informationen zum Aktualisieren von Abonnements weiter unten) "1" - Aktiv: Plant Abonnementzahlungen sofort und umgeht Betrug und doppelte Prüfungen (falls aktiviert). "2" - Ausstehend (Standard): Plant Abonnementzahlungen innerhalb von 24 Stunden, vorausgesetzt, dass auf ACCOUNTCHECK kein Fehler aufgetreten ist. |
Umgang mit der Antwort
Der Inhalt der Antwort hängt davon ab, ob der Kunde einer strengeren Authentifizierung unterzogen wurde (so genannte "Step-up"-Authentifizierung):
-
Für die "Step-up"-Authentifizierung: Nachdem der Kunde die Bezahlsitzung abgeschlossen hat, erhalten Sie ein einzelnes Antwort-JWT, das aus den Antworten auf die Anfragen ACCOUNTCHECK und SUBSCRIPTION besteht.
-
Für die "reibungslose" Authentifizierung: Nachdem der Kunde den Bezahlvorgang abgeschlossen hat, erhalten Sie eine einzige JWT-Antwort, die aus den Antworten THREEDQUERY, ACCOUNTCHECK und SUBSCRIPTION besteht.
-
Bei der Überprüfung der Antwort THREEDQUERY :
- Wir empfehlen Ihnen, die auf der Seite Bearbeitung Ihrer ersten Transaktion beschriebenen Kontrollen durchzuführen.
-
Bei der Überprüfung der Antwort ACCOUNTCHECK :
- Es ist wichtig, dass diese Anfrage erfolgreich ist (prüfen Sie die errorcode ist "0"). Andernfalls wird unsere Abonnementmodul keine Zahlungen planen.
-
Bei der Überprüfung der Antwort SUBSCRIPTION :
- Es ist wichtig, dass diese Anfrage erfolgreich ist (prüfen Sie die errorcode ist "0"). Jede andere errorcode Werte zeigen an, dass das Abonnement nicht geplant wurde.
- Die abonnementspezifischen Felder (wie hier beschrieben) sollten die in der Anfrage angegebenen Werte wiedergeben. Diese geben vor, wie häufig automatische Zahlungen von Abonnementmodul verarbeitet werden sollen, welcher Betrag dem Kunden belastet wird und wann das Abonnement abgeschlossen wird.
Verwaltung des Abonnements
Beginn der automatisierten Zahlungen
Die erste automatische Zahlung wird wie folgt abgewickelt:
- Wenn subscriptionbegindate angegeben wurde, wird die erste automatische Zahlung an diesem Datum ausgeführt.
- Wenn subscriptionbegindate hat nicht angegeben wurde, wird die erste automatische Zahlung nach Ablauf des in der Anforderung angegebenen Intervalls verarbeitet (z. B. 1 MONTH oder 7 DAY).
Behalten Sie den Überblick über Ihre Abonnements
-
Sie können sich bei MyST anmelden und von dort aus Ihre geplanten Abonnements überwachen. Sie können die bereits abgewickelten Zahlungen einsehen und auch zukünftige Zahlungen, die in unserem Abonnementmodul geplant sind, einsehen.
Klicken Sie hier für weitere Informationen.
-
Sie können sich dafür entscheiden, Berichte per E-Mail oder URL-Benachrichtigungen zu erhalten, wenn automatische Abonnementzahlungen auf Ihrem Konto verarbeitet wurden.
Klicken Sie hier für weitere Informationen.
-
Sie können einen Antrag an TRANSACTIONQUERY stellen, die durch die transactionreference die im Abschnitt SUBSCRIPTION der ursprünglichen Antwort zurückgegeben wird. Die Antwort TRANSACTIONQUERY enthält Felder, die Informationen über künftige geplante Zahlungen enthalten.
Klicken Sie hier für weitere Informationen.
Aktualisierung des Abonnements
Sie können Aktualisierungen an aktiven Abonnements vornehmen, um Kundendaten zu ändern oder die Abonnementzahlungen zu stornieren/ändern. Es gibt zwei Möglichkeiten, dies zu tun:
-
Sie können sich bei MyST anmelden und Ihre geplanten Abonnements von dort aus verwalten.
Klicken Sie hier für weitere Informationen.
-
Sie können einen Antrag an TRANSACTIONUPDATE stellen, die durch die transactionreference im Abschnitt SUBSCRIPTION der ursprünglichen Antwort zurückgegeben.
Klicken Sie hier für weitere Informationen.
Beendigung des Abonnements
Die Abonnements können in einen dieser beiden Zustände übergehen:
Anzahl der überschrittenen Zahlungen
Sobald die subscriptionnumber übersteigt die subscriptionfinalnumber, wird unser Abonnementmodul die Verarbeitung von Abonnement-Zahlungen auf unbestimmte Zeit einstellen.
Wenn Sie keine weiteren Zahlungen von dem Kunden bearbeiten müssen, brauchen Sie keine weiteren Maßnahmen zu ergreifen.
Wenn Sie ein Abonnement fortsetzen/verlängern möchten, können Sie die subscriptionfinalnumber auf einen größeren Wert. Sie können dies über MyST tun oder eine Anfrage an TRANSACTIONUPDATE stellen. Nach Abschluss dieser Aktualisierung werden die Zahlungen wieder in ihren ursprünglichen Intervallen verarbeitet. Wenn Zahlungen versäumt wurden, während die Abonnementzahlungen nicht verarbeitet wurden, wird unsere Abonnement-Engine versäumte Zahlungen nachholen innerhalb von 24 Stunden.
Das Abonnement läuft auf unbestimmte Zeit
Wurde der ursprüngliche Antrag eingereicht mit subscriptionfinalnumber auf "0" eingestellt ist, werden wir die Zahlungen auf unbestimmte Zeit weiterführen, bis Sie das Abonnement manuell deaktivieren.
Wenn Sie das Abonnement deaktivieren möchten, können Sie dies tun, indem Sie die transactionactive Feld auf "0" setzen. Dazu können Sie MyST verwenden oder eine Anfrage an TRANSACTIONUPDATE senden (Sie können ein Abonnement bei Bedarf zu einem späteren Zeitpunkt wieder aktivieren).