Planen Sie ein Abonnement ohne sofortige Zahlung für JavaScript Library - mit Subscription Engine

Überblick über den Prozess

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. Klicken Sie hier für weitere Informationen. 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. z.B. In demselben Szenario wie oben, aber ohne Einreichung der subscriptionbegindate, die erste automatische Zahlung wird am 5. Februar 2018 (1 MONTH nach dem ursprünglichen Antrag) verarbeitet. Alle weiteren Zahlungen werden am 5. eines jeden Monats verarbeitet.   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 und subscriptionfinalnumber = 12 Es werden 11 Zahlungen insgesamt (Die erste ACCOUNTCHECK + 11 Abonnementzahlungen) (Die anfängliche ACCOUNTCHECK wird auf die endgültige Zahl angerechnet) 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)	Die ACCOUNTCHECK sollte immer mit dem Wert "1" beginnen, es sei denn, Sie nehmen ein früheres Abonnement wieder auf (wenn Sie z. B. ein zuvor gekündigtes Abonnement mit drei Zahlungen wieder aufnehmen, können Sie hier "4" eingeben, um es fortzusetzen). Diese Zahl wird bei jeder Abonnementzahlung erhöht. Mit dieser Funktion können Sie ein früheres Abonnement effektiv wieder aufnehmen, wobei die Anzahl der zuvor bearbeiteten Zahlungen beibehalten wird.
	subscriptiontype	Alpha (11)	Dieses Feld gibt die Art des zu bearbeitenden Abonnements an. Ihr System kann diese beiden Werte übermitteln: RECURRING wird verwendet, wenn der Kunde jedes Mal eine wiederkehrende Zahlung für ein neues Produkt/eine neue Dienstleistung vornimmt (z. B. ein Zeitschriftenabonnement). Bei den meisten Händlern ist die subscriptiontype sollte auf gesetzt werden "RECURRING". INSTALLMENT wird nur in bestimmten Fällen mit bestimmten Acquirern* verwendet. Es ist für den Fall gedacht, dass ein Kunde eine einzige Bestellung kauft und die Zahlung in mehreren Raten erfolgt (z. B. Zahlung von £100 pro Monat für eine Bestellung, bis diese vollständig bezahlt ist). *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 Portal anmelden und von dort aus Ihre geplanten Abonnements überwachen. Sie können die bereits abgewickelten Zahlungen einsehen und auch zukünftige Zahlungen, die in unserer Abonnement-Engine geplant wurden.
  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 Portal anmelden und von dort aus Ihre geplanten Abonnements 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 tun, indem Sie Portal verwenden oder eine Anfrage an TRANSACTIONUPDATE senden. 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 Abonnementmaschine 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 Portal verwenden oder eine Anfrage an TRANSACTIONUPDATE senden (Sie können ein Abonnement bei Bedarf zu einem späteren Zeitpunkt wieder aktivieren).