Ihr System muss eine Anfrage an Payment Pages senden, die sowohl eine 3-D Secure authentifizierte Zahlung verarbeitet als auch das Abonnementmodul anweist, zukünftige Zahlungen zu planen. Dies kann mit einem einzigen POST an die Payment Pages erreicht werden.
Konfiguration
Das folgende Beispiel zeigt, wie eine Abonnementzahlung durch einen POST an die Adresse Payment Pages verarbeitet wird:
<html>
<head>
</head>
<body>
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="10.00">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<input type="hidden" name="subscriptionunit" value="MONTH">
<input type="hidden" name="subscriptionfrequency" value="1">
<input type="hidden" name="subscriptionnumber" value="1">
<input type="hidden" name="subscriptionfinalnumber" value="12">
<input type="hidden" name="subscriptiontype" value="RECURRING">
<input type="hidden" name="credentialsonfile" value="1">
<input type="submit" value="Pay">
</form>
</body>
</html>
Replace <DOMAIN> with a supported domain. View full domain list.
Feldspezifikation
| Feld | Format | Beschreibung | |
| Erforderlich | 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 Mastercard , dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten für die zukünftige Verwendung speichern dürfen. Erfahren Sie mehr über Daten Hinterlegt. Wenn Ihr System diesen Wert nicht in der Anfrage übermittelt, wird unser System automatisch versuchen, die Anfrage mit dem richtigen credentialsonfile Wert zu kennzeichnen. |
| Erforderlich | currencyiso3a | Alpha (3) |
Die Währung , die jeder Zahlung in der Abonnementreihenfolge zugewiesen ist. |
| Erforderlich | mainamount | Numerisch (14) | Der in regelmäßigen Abständen zu zahlende Betrag in Haupteinheiten (€10 wird als 10,00 angegeben). Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - weitere Informationen erhalten Sie von Ihrer Bank) |
| Optional | subscriptionbegindate | Datum JJJJ-MM-TT |
Dieses Feld gibt an, wann die erste automatisierte Zahlung verarbeitet werden soll. Von da an verwenden wir die Daten, die in den Feldern subscriptionunit und subscriptionfrequency eingegebenen Daten, um die Abonnementzahlungen in regelmäßigen Abständen automatisch zu verarbeiten. Wenn z. B. ein Zeichnungsantrag am 5. Januar 2018 eingereicht wird das Intervall beträgt 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 nicht die subscriptionbegindateeingeben, verwenden wir die subscriptionunit und subscriptionfrequency Felder, um die erste automatische Zahlung automatisch 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. |
| Erforderlich | subscriptionfinalnumber | Numerisch (5) |
Hier wird die Anzahl der Zahlungen festgelegt, die während der Laufzeit des Abonnements verarbeitet werden sollen: Bei der Verarbeitung einer 3-D Secure authentifizierten Zahlung, bei der ein Abonnement geplant ist: Wenn subscriptionnumber = 1 Hinweis: Wenndie subscriptionfinalnumber Wert „0“ ist, plant die Abonnement-Engine Zahlungen auf unbestimmte Zeit, bis der Benutzer das Abonnement manuell auf„Inaktiv“ setzt. |
| Erforderlich | 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 |
| Erforderlich | subscriptionnumber | Numerisch (5) |
|
| Erforderlich | subscriptiontype | Alpha (11) |
Dieses Feld gibt die Art des zu bearbeitenden Abonnements an. Ihr System kann diese beiden Werte übermitteln:
*Ratenzahlungen werden für Händler mit einem Trust Payments unterstützt. Wenn Sie eine andere Acquiring-Bank nutzen, müssen Sie sich an unser Support-Team wenden , um zu überprüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren. |
| Erforderlich | subscriptionunit | Alpha (5) |
Dieses Feld gibt die Zeiteinheit zwischen den einzelnen Abonnements an. Dies kann entweder "DAY" oder "MONTH" sein. Hinweis: Dieses Feld muss unbedingt in GROSSBUCHSTABEN an das Gateway übermittelt werden ("DAY" oder "MONTH"). |
