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. Click here for a full list.
Feldspezifikation
| Feld | Format | Beschreibung | |
| 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 versuchen, die Anfrage mit dem richtigen credentialsonfile Wert zu kennzeichnen. |
|
| 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. |
|
| 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) | |
| 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. |
|
| 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 Anmerkung: Wenn der subscriptionfinalnumber Wert "0" ist, plant Abonnementmodul die Zahlungen auf unbestimmte Zeit, bis der Benutzer das Abonnement manuell auf "Inaktiv" setzt. |
|
| 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" sein. Hinweis: Dieses Feld muss unbedingt in GROSSBUCHSTABEN an das Gateway übermittelt werden ("DAY" oder "MONTH"). |
