Uw systeem moet een verzoek sturen naar de Payment Pages dat zowel een 3-D Secure geauthenticeerde betaling verwerkt als de Abonnementsmodule opdracht geeft toekomstige betalingen te plannen. Dit kan worden bereikt in een enkele POST naar de Payment Pages.
Configuratie
Het volgende voorbeeld laat zien hoe een abonnementsbetaling wordt verwerkt door een POST uit te voeren naar de Payment Pages:
<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.
Specificatie veld
Veld | Formaat | Beschrijving | |
credentialsonfile | Numeriek (1) |
Dien de waarde "1" in om aan te geven dat de in het oorspronkelijke verzoek verstrekte referenties worden opgeslagen voor volgende abonnementsbetalingen. Opmerking: Visa en Mastercard hebben bepaald dat u toestemming van de kaarthouder moet krijgen voordat u kaartgegevens opslaat voor toekomstig gebruik. Klik hier voor meer informatie. Als uw systeem er niet in slaagt deze waarde in het verzoek in te voeren, zal ons systeem automatisch proberen het verzoek te markeren met de juiste credentialsonfile waarde. |
|
currencyiso3a | Alpha (3) |
De Munt toegewezen aan elke betaling in de abonnementsreeks. Klik hier voor een volledige lijst van beschikbare munteenheden. |
|
mainamount | Numeriek (14) | Het bedrag dat met regelmatige tussenpozen moet worden betaald, in hoofdeenheden (€10 wordt ingediend als 10,00). Deze waarde moet groter zijn dan nul. (Maximale lengte kan variëren afhankelijk van uw acquiring bank - Neem contact op met uw bank voor meer informatie) | |
subscriptionbegindate | Datum JJJJ-MM-DD |
Dit veld verwijst naar het tijdstip waarop de eerste geautomatiseerde betaling zal worden verwerkt. Vanaf dat moment gebruiken we de gegevens die in de velden subscriptionunit en subscriptionfrequency velden om de abonnementsbetalingen op regelmatige tijdstippen automatisch te verwerken.
bijv. Als een abonnementsaanvraag wordt ingediend op 5 januari 2018 het interval is 1 MONTH (subscriptionfrequency = 1 en subscriptionunit = MONTH) en subscriptionbegindate is 2018-01-08, de eerste automatische betaling wordt verwerkt op 8 januari 2018, en alle volgende betalingen worden verwerkt op de 8e van elke maand. Als u de subscriptionbegindatezullen we de subscriptionunit en subscriptionfrequency velden hierboven om automatisch de eerste automatische betaling te plannen. Maandabonnementen die aan het einde van de maand worden ingepland, worden op de 28e dag verwerkt. Als de datum van de eerste automatische betaling de 29e, 30e of 31e dag is, worden alle volgende betalingen in de daaropvolgende maanden op de 28e dag verwerkt. Dit is om problemen te voorkomen met abonnementsbetalingen in maanden die minder dagen hebben dan andere. |
|
subscriptionfinalnumber | Numeriek (5) |
Dit wordt gebruikt om het aantal te verwerken betalingen in de loop van het abonnement in te stellen: Bij het verwerken van een 3-D Secure geauthenticeerde betaling, waarbij een abonnement is gepland: Als subscriptionnumber = 1 Let op: Als de subscriptionfinalnumber waarde "0" is, zal de Abonnementsmodule voor onbepaalde tijd betalingen plannen totdat de gebruiker het abonnement handmatig op Inactief zet. |
|
subscriptionfrequency | Numeriek (11) |
In combinatie met eenheid bepaalt de frequentie hoe vaak betalingen worden verwerkt. bijv. Voor een betaling om de 7 dagen: subscriptionfrequency = 7 en subscriptionunit = DAY bijv. Voor een betaling om de 2 maanden: subscriptionfrequency = 2 en subscriptionunit = MONTH |
|
subscriptionnumber | Numeriek (5) |
|
|
subscriptiontype | Alpha (11) |
Dit veld geeft het type abonnement aan dat moet worden verwerkt. Uw systeem kan deze twee waarden indienen:
*Installaties worden ondersteund voor winkeliers met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, moet u contact opnemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat u verder gaat. |
|
subscriptionunit | Alfa (5) |
Dit veld vertegenwoordigt de tijdseenheid tussen elk abonnement. Dit kan ofwel "DAY" of "MONTH" zijn. Opmerking: Dit veld moet absoluut in HOOFDLETTERS ("DAY" of "MONTH") bij de gateway worden ingediend. |