Je hebt een gebruikersaccount nodig met de rol "Webservices JWT" om het token aan te maken. Het token moet worden aangemaakt en ondertekend op uw server.
Als deze gebruikersaccount nog niet is aangemaakt, vraag er dan een aan voor uw site(s) door contact op te nemen met ons Support Team.
De jwt veld dat in het formulier wordt verzonden, moet de vorm hebben van een JSON Web Token (JWT), dat bestaat uit gecodeerde gegevens.
JSON Web Tokens zijn een open, industriestandaard RFC 7519 methode voor het veilig verzenden van gegevens tussen twee partijen.
We raden aan de bibliotheken te gebruiken die te vinden zijn op https://jwt.io om de JWT te genereren.
De jwt-aanmaak moet worden uitgevoerd op uw backendserver om de blootstelling van gevoelige details (d.w.z. JWT-ondertekeningsgeheim) te vermijden.
In zijn compacte vorm bestaat JWT uit drie delen, gescheiden door punten ("."), namelijk:
<header>.<payload>.<signature>
Het genereren van de header
De header bestaat uit twee delen:
- alg - Het gebruikte ondertekeningsalgoritme (wij ondersteunen "HS256", "HS384" en "HS512").
- typ - Het type van het token, dat "JWT" is.
Deze moeten Base64URL gecodeerd zijn om het eerste deel van het JWT te vormen. Voorbeeld:
- Header - {“alg”:”HS256″,”typ”:”JWT”}
- Encoded - eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
Belangrijk: Ingezonden gegevens moeten Base64Url gecodeerd zijn, in plaats van standaard Base64.
Het genereren van de payload
Gelieve bij het indienen van velden in de payload onderstaande aanbevelingen te volgen:
- De payload moet bevatten alle velden die u de klant niet wilt laten wijzigen (bijvoorbeeld het transactiebedrag).
- De payload mag niet bevatten alle velden die de klant mag wijzigen tijdens het afrekenen (bijvoorbeeld zijn adres of contactgegevens).
Deze velden worden dan Base64URL gecodeerd om het tweede deel van het JWT te vormen. Voorbeeld:
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":1050,
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
"requesttypedescriptions":["THREEDQUERY","AUTH"]
},
"iat":1559033849,
"iss":"jwt.user"
}
eyJwYXlsb2FkIjp7ImFjY291bnR0eXBlZGVzY3JpcHRpb24iOiJFQ09NIiwiYmFzZWFtb3VudCI6IjEwNTAiLCJjdXJyZW5jeWlzbzNhIjoiR0JQIiwic2l0ZXJlZmVyZW5jZSI6InRlc3Rfc2l0ZTEyMzQ1IiwidGVybXVybCI6Imh0dHBzOi8vcGF5bWVudHMuc2VjdXJldHJhZGluZy5uZXQvcHJvY2Vzcy9wYXltZW50cy9tb2JpbGVzZGtsaXN0ZW5lciIsInJlcXVlc3R0eXBlZGVzY3JpcHRpb25zIjpbIlRIUkVFRFFVRVJZIiwiQVVUSCJdfSwiaWF0IjoxNTU5MDMzODQ5LCJpc3MiOiJqd3QudXNlciJ9
De baseamount veld getoond in de payload Bovenstaand voorbeeld bevat een waarde die wordt opgegeven in basiseenheden. Dit betekent dat de waarde zonder decimaalteken wordt weergegeven, dus £10,50 wordt weergegeven als 1050.
Wij staan u toe om in plaats daarvan de mainamount hier, indien gewenst. In dit geval wordt de waarde opgegeven in hoofdeenheden (£10,50 zou worden opgegeven als 10,50 - let op de decimale komma).
Het genereren van de signature
Het laatste deel van het teken is de signature. De signature wordt gebruikt om ervoor te zorgen dat het token niet is gewijzigd door de klant voordat het verzonden formulier Trust Payments bereikt.
De signature wordt gemaakt door de gecodeerde header, de gecodeerde payload, a "secret" en het algoritme gespecificeerd in het header, en dan ondertekenen.
De “secret” is een geheime wachtwoordzin (in tekenreeksformaat) die je moet gebruiken om de JWT te ondertekenen. Dit moet afgesproken met ons Support Team voorafgaand aan de verwerking van verzoeken aan ons systeem.
Bij het opslaan van de waarde van de "secret" op uw systeem, moet u ervoor zorgen dat u dit op een veilige manier doet.
De waarde van de “secret” mag niet worden opgeslagen in platte tekst in de app zelf.
Voorbeeld - Als u het HMAC SHA256-algoritme wilt gebruiken, is het signature zou op de volgende manier worden gecreëerd:
HMACSHA256(
base64UrlEncode(header) + "." +
base64UrlEncode(payload),
secret)
De laatste stap is ervoor te zorgen dat de signature is Base64URL gecodeerd.
Het ondertekenen van tokens met een private sleutel wordt niet ondersteund.
Volledig JWT-voorbeeld
Het resultaat is drie Base64URL-strings, gescheiden door punten ("."):
Als we de header, de payload en de signature van bovenstaande voorbeelden, zou u uitkomen op het volgende JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJqd3QudXNlciIsImlhdCI6MTU5NDY0NzI2OCwicGF5bG9hZCI6eyJiYXNlYW1vdW50IjoxMDUwLCJjdXJyZW5jeWlzbzNhIjoiR0JQIiwic2l0ZXJlZmVyZW5jZSI6InRlc3Rfc2l0ZTEyMzQ1IiwiYWNjb3VudHR5cGVkZXNjcmlwdGlvbiI6IkVDT00ifX0.A6gAnUq2NCSlIiLOcDyzhuo4E8Bm5oPWSKbkjOKKHhc
Het volledige token kan dan worden opgenomen bij het initialiseren van de bibliotheek.
Controleer de JWT-handtekening van het antwoord
Het resultaat van het verwerkte verzoek wordt teruggestuurd in de vorm van een nieuw JWT. Het volgende is een voorbeeld van een door Trust Payments geretourneerd antwoord:
(Antwoord JWT)
"jwt":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE1OTQ2NDcyNjgsInBheWxvYWQiOnsicmVxdWVzdHJlZmVyZW5jZSI6Ilc1Ni11YWN3bTU0ayIsInZlcnNpb24iOiIxLjAwIiwiand0IjoiZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SnBjM01pT2lKcWQzUXVkWE5sY2lJc0ltbGhkQ0k2TVRVNU5EWTBOekkyT0N3aWNHRjViRzloWkNJNmV5SmlZWE5sWVcxdmRXNTBJam94TURVd0xDSmpkWEp5Wlc1amVXbHpiek5oSWpvaVIwSlFJaXdpYzJsMFpYSmxabVZ5Wlc1alpTSTZJblJsYzNSZmMybDBaVEV5TXpRMUlpd2lZV05qYjNWdWRIUjVjR1ZrWlhOamNtbHdkR2x2YmlJNklrVkRUMDBpZlgwLkE2Z0FuVXEyTkNTbElpTE9jRHl6aHVvNEU4Qm01b1BXU0tia2pPS0tIaGMiLCJyZXNwb25zZSI6W3siYXV0aG1ldGhvZCI6IkZJTkFMIiwidHJhbnNhY3Rpb25zdGFydGVkdGltZXN0YW1wIjoiMjAyMC0wNy0xMyAxMzozNDoyOCIsImN1c3RvbWVyb3V0cHV0IjoiUkVTVUxUIiwibGl2ZXN0YXR1cyI6IjAiLCJtZXJjaGFudG5hbWUiOiJNZXJjaGFudCBuYW1lIiwic3BsaXRmaW5hbG51bWJlciI6IjEiLCJkY2NlbmFibGVkIjoiMCIsInNldHRsZWR1ZWRhdGUiOiIyMDIwLTA3LTEzIiwiZXJyb3Jjb2RlIjoiMCIsImNhdnYiOiJZMkZ5WkdsdVlXeGpiMjF0WlhKalpXRjFkR2c9IiwibWVyY2hhbnRudW1iZXIiOiIwMDAwMDAwMCIsIm1lcmNoYW50Y291bnRyeWlzbzJhIjoiR0IiLCJzdGF0dXMiOiJZIiwidHJhbnNhY3Rpb25yZWZlcmVuY2UiOiIxLTItMzQ1Njc5IiwidGhyZWVkdmVyc2lvbiI6IjIuMS4wIiwicGF5bWVudHR5cGVkZXNjcmlwdGlvbiI6Ik1BU1RFUkNBUkQiLCJiYXNlYW1vdW50IjoiMTA1MCIsImVjaSI6IjAyIiwiYWNjb3VudHR5cGVkZXNjcmlwdGlvbiI6IkVDT00iLCJ0aWQiOiIyNzg4Mjc4OCIsImFjcXVpcmVycmVzcG9uc2Vjb2RlIjoiMDAiLCJyZXF1ZXN0dHlwZWRlc2NyaXB0aW9uIjoiQVVUSCIsInNlY3VyaXR5cmVzcG9uc2VzZWN1cml0eWNvZGUiOiIyIiwiY3VycmVuY3lpc28zYSI6IkdCUCIsImF1dGhjb2RlIjoiVEVTVDk1IiwiZXJyb3JtZXNzYWdlIjoiT2siLCJpc3N1ZXJjb3VudHJ5aXNvMmEiOiJaWiIsIm1hc2tlZHBhbiI6IjUyMDAwMCMjIyMjIzEwMDUiLCJzZWN1cml0eXJlc3BvbnNlcG9zdGNvZGUiOiIwIiwiZW5yb2xsZWQiOiJZIiwic2VjdXJpdHlyZXNwb25zZWFkZHJlc3MiOiIwIiwib3BlcmF0b3JuYW1lIjoiand0LnVzZXIiLCJzZXR0bGVzdGF0dXMiOiIwIn1dLCJzZWNyYW5kIjoiZGdjNlFKOEk1In0sImF1ZCI6Imp3dC51c2VyIn0.XE-vjH2RWS7KLItZx6fa0G_A6mcmBAgxdMylP7IAt9w"
Als er een fout is opgetreden, kunnen wij het antwoord mogelijk niet coderen, waardoor het antwoord mogelijk slechts een errorcode en errormessage.
In dit scenario raden wij aan de klant te vragen de betaling opnieuw te proberen.
bijv. errorcode 50000, errormessage "Time-out".
Om het volledige antwoord te bekijken, moet u het teruggestuurde JWT decoderen.
We raden aan de bibliotheken te gebruiken die te vinden zijn op https://jwt.io om de JWT te decoderen.
Het antwoord JWT bestaat uit drie delen, gescheiden door punten ("."), in het volgende formaat:
Header.Payload.Signature
Voordat u het antwoord kunt vertrouwen, moet u controleren of de geretourneerde handtekening overeenkomt met de verwachte waarde. Zo niet, dan kan deze door een onbevoegde partij zijn gewijzigd.
De signature is gehashed met SHA-256, en kan dus niet gedecodeerd worden. Dit betekent dat om de signature correct is, moet uw systeem het opnieuw berekenen met behulp van de header en payload teruggestuurd.
Mits u dezelfde secret tijdens dit proces, de herberekende signature moet overeenkomen met die in het antwoord JWT. Samengevat:
- Base64URL decoderen JWT header
- Base64URL decoderen JWT payload
- De handtekening opnieuw genereren door de header, de payload en ze ondertekenen met uw secret.
(zoals hierboven uitgelegd)
Antwoordvelden
Nadat u het antwoord hebt ontvangen, raden wij u aan de onderstaande informatie door te nemen wanneer u de betalingssessie van de klant behandelt:
Transactiereferentie
De transactionreference is een unieke identificatiecode voor de transactie. U moet deze referentie vastleggen om op een later tijdstip query's of andere acties op deze transactie uit te voeren.
Referentie bestelling
De orderreference is een aangepaste identificatiecode voor de transactie die we aanbevelen in de JWT payload van elke transactie. Als uw systeem is geconfigureerd om orderreference waarden aan uw transacties, die u kunt gebruiken om ervoor te zorgen dat u het juiste antwoord controleert na een betaling.
Verzoektype
U moet de requesttypedescription teruggestuurd in het antwoord. Alleen waarden van "AUTH" geven de autorisatie van een betaling aan. Klik hier voor een volledige lijst van verschillende verzoektypes die door Trust Payments worden ondersteund.
Foutcode
U moet de errorcode teruggestuurd om het resultaat van de transactie te bepalen:
| Foutcode | Beschrijving | Vereiste acties |
| 0 | Succesvolle transactie. | Geen enkele. |
| 30000 | Geeft aan dat er ongeldige gegevens zijn ingediend binnen de payload van het JWT. | Controleer de velden die in de payload van het JWT voldoen aan onze specificatie. |
| 60010 60034 99999 |
Dit kan het gevolg zijn van een communicatieprobleem met een bank of een derde partij. | Wij raden u aan de klant te informeren over het probleem en contact met u op te nemen om het probleem op te vragen. U moet contact opnemen met ons Support Team en een kopie verstrekken van het gehele ingediende verzoek en het teruggestuurde antwoord, en wij zullen contact opnemen met de relevante partijen om de status van het verzoek vast te stellen. Zorg er in het belang van de veiligheid voor dat u gevoelige veldwaarden, zoals kaartgegevens, weglaat of maskeert. |
| 60022 | De klant werd om authenticatie gevraagd, maar slaagde niet in dit deel van het proces, wat betekent dat de transactie niet werd geautoriseerd. | Geef de klant een alternatief betalingsmiddel en laat hem opnieuw proberen. |
| 70000 | autorisatie voor de betaling werd geprobeerd, maar werd geweigerd door de uitgevende bank. | |
| Andere | Klik hier voor een volledige lijst van errorcode waarden die kunnen worden teruggegeven. | Hangt af van de errorcode teruggestuurd. |
Status betaling (settlestatus)
U moet de settlestatus in het antwoord:
| Status betaling (settlestatus) | Beschrijving | Vereiste acties |
| 0 | In afwachting van automatische afwikkeling. | Geen enkele. |
| 1 | In afwachting van handmatige afwikkeling (overschrijft fraude / dubbele controles, indien ingeschakeld). | |
| 2 | Betaling toegestaan maar opgeschort op het Trust Payments systeem. | Onderzoek de transactie handmatig om de reden te bepalen waarom de betaling is opgeschort. Als je verder kunt gaan, kun je de transactie bijwerken om afwikkeling toe te staan. |
| 3 | Betaling geannuleerd. | Kijk naar de errorcode om de reden vast te stellen waarom de betaling niet werd voltooid. |
3-D ingeschreven
De enrolled veld informeert u of de kaart van de klant is ingeschreven op 3-D Secure:
| 3-D ingeschreven | Beschrijving | Vereiste acties |
| Y | De kaart van de klant is geregistreerd. | Afgehandeld door de Mobile SDK. |
| N | De kaart van de klant is niet geregistreerd. | |
| U | Kan niet bepalen of de kaart geregistreerd is. | |
| B | Merchant authentication rule wordt geactiveerd om de authenticatie in dit use case te omzeilen. |
3-D status
De status veld laat u weten of de klant met succes is geauthenticeerd tijdens het 3-D Secure proces:
| 3-D status | Beschrijving | Vereiste acties |
| Y | De klant is succesvol geverifieerd. | Geen. De Mobile SDK zal deze gevallen automatisch afhandelen. |
| A | Authenticatie geprobeerd maar niet voltooid. | |
| U | Authenticatie kon niet worden uitgevoerd. | |
| C | Uitdaging vereist voor authenticatie. | |
| N | De klant was niet geverifieerd. De betaling zal niet worden verwerkt. |
|
| R | Authenticatie werd geweigerd. De betaling zal niet worden verwerkt. |
3-D versie
De version veld specificeert de versie van 3-D Secure die voor de betaling wordt gebruikt. De waarde begint met "1.x.x" voor 3-D Secure v1, of "2.x.x" voor 3-D Secure v2.
JWT-veldspecificatie
| Veld | Formaat | Beschrijving | ||
| JWT Payload |
|
|||
| iat | Numeriek (17) |
Tijd in seconden sinds Unix epoch (gegenereerd met UTC). Klik hier voor meer informatie. Het JWT is 1 uur geldig vanaf het tijdstip dat in het iat. |
||
| iss | Alfanumeriek (255) | Uw JWT-gebruikersnaam. | ||
| Payload Object | ||||
| accounttypedescription | Alfanumeriek (20) | De ingediende waarde is "ECOM" (vertegenwoordigt een e-commerce transactie). | ||
| authmethod | Alfanumeriek (5) |
Ondersteunde waarden zijn: De inhoud van authmethod hebben geen invloed op de afwikkeling status van de transactie. afwikkeling status kan worden gecontroleerd met behulp van settlestatus en settleduedate. Klik hier voor meer informatie over het proces afwikkeling . |
||
| billingprefixname | Alfanumeriek (25) | Het voorvoegsel voor de factuurnaam, uit de volgende lijst: De heer, De heren, Juffrouw, Dr., Mw, Prof., Eerw., Dhr., Heer, Dame & Mx. | ||
| billingfirstname | Alfanumeriek (127) |
De Voornaam facturatie. Vereist voor Visa Secure Data Field Mandate. Vereist voor handelaren in kansspelen. |
||
| billingmiddlename | Alfanumeriek (127) | De facturatie middelste naam. | ||
| billinglastname | Alfanumeriek (127) |
De Achternaam facturatie. Vereist voor Visa Secure Data Field Mandate. Vereist voor handelaren in kansspelen. |
||
| billingsuffixname | Alfanumeriek (25) | De naam van het achtervoegsel voor facturering. | ||
| billingpremise | Alfanumeriek (25) |
Het huisnummer of de eerste regel van het factuuradres. |
||
| billingstreet | Alfanumeriek (127) |
Het huisnummer of de eerste regel van het factuuradres. |
||
| billingtown | Alfanumeriek (127) |
De stad die is ingevoerd voor het factuuradres. |
||
| billingcounty | Alfanumeriek (127) |
Provincie facturatie.
Opmerking: Indien ingediend, billingcountryiso2a is vereist. |
||
| billingpostcode | Alfanumeriek (25) |
De Postcode facturatie of postcode moet geldig zijn voor de billingcountryiso2a ingediend. |
||
|
|
billingcountryiso2a | iso2a |
Land facturatie in iso2a formaat.
Verplicht als billingcounty is ingediend. Anders, optioneel. |
|
| billingemail | E-mail (255) |
E-mailadres facturatie adres. Vereist voor Visa Secure Data Field Mandate wanneer billingtelephone niet is voorzien. |
||
| billingtelephone |
Alfanumeriek, inclusief symbolen (20) |
Telefoonnummer voor facturering. Geldige tekens:
Vereist voor Visa Secure Data Field Mandate wanneer billingemail niet is voorzien. |
||
| billingtelephonetype | Char (1) |
Type facturering telefoonnummer:
|
||
| credentialsonfile | Numeriek (1) |
De volgende waarden kunnen worden ingediend:
Dit is vereist voor Visa en Mastercard transacties waarbij de merchant gebruik maakt van de CoF functie. Als de transactie niet in aanmerking komt voor CoF, of als je de referenties niet wilt gebruiken voor toekomstige transacties, kun je dit veld weglaten. Visa en Mastercard hebben bepaald dat u toestemming van de kaarthouder moet krijgen voordat u kaartgegevens opslaat voor toekomstig gebruik.
|
||
| customerprefixname | Alfanumeriek (25) | Leveringsnaam. | ||
| customerfirstname | Alfanumeriek (127) | |||
| customermiddlename | Alfanumeriek (127) | |||
| customerlastname | Alfanumeriek (127) | |||
| customersuffixname | Alfanumeriek (25) | |||
| customerpremise | Alfanumeriek (25) |
Leveringsadres. De leveringspostcode of postcode moet geldig zijn voor de customercountryiso2a ingediend. |
||
| customerstreet | Alfanumeriek (127) | |||
| customertown | Alfanumeriek (127) | |||
| customercounty | Alfanumeriek (127) | |||
| customercountryiso2a | iso2a | |||
| customerpostcode | Alfanumeriek (25) | |||
| customeremail | E-mail (255) | E-mailadres van de bezorger. | ||
| customertelephone | Alfanumeriek (20) |
Telefoonnummer aflevering. Geldige tekens:
|
||
| customertelephonetype | Char (1) |
Type levering telefoonnummer:
|
||
| customfield1 | Alfanumeriek (100) |
Met deze velden kunnen aangepaste gegevens worden ingediend en opgeslagen in Trust Payments' records. Deze gegevens kunnen later worden opgevraagd door het uitvoeren van een CSV Transactie downloaden.
Gebruiksvoorbeeld: U vindt het misschien nuttig voor afstemming om het verkoopbedrag en de fooi afzonderlijk in twee van deze aangepaste velden op te nemen, zoals baseamount/mainamount velden zijn het totaal van beide. |
||
| customfield2 | ||||
| customfield3 | ||||
| customfield4 | ||||
| customfield5 | ||||
| currencyiso3a | iso3a |
De Munt waarin de transactie werd verwerkt. |
||
| baseamount | Numeriek (13) |
Ofwel baseamount of mainamount moet worden opgenomen (niet allebei).
Het bedrag van de transactie in basiseenheden (zonder zonder decimalen). Bijvoorbeeld £10.50 wordt ingediend als een geheel getal 1050 |
||
| mainamount | Numeriek (14) |
Ofwel baseamount of mainamount moet worden opgenomen (niet allebei).
Het bedrag van de transactie in hoofdeenheden. |
||
|
|
initiationreason | Char (1) |
Dit is vereist bij het verwerken van een Merchant Initiated Transaction (MIT). Hiermee kunt u een reden voor de transactie toewijzen. Niet indienen bij het verwerken van een door de klant geïnitieerde transactie (CIT). De toegestane waarden voor dit veld zijn "A", "C", "D", "S" en "X".
Zie Visa's eigen documentatie voor meer informatie. |
|
| locale | Ongedefinieerd |
Standaard worden het afrekeningsformulier en eventuele foutmeldingen weergegeven in het Brits Engels. Maar dit gedrag kan worden omzeild door het volgende in te voeren locale waarden in de payload:
|
||
| operatorname | Alfanumeriek (255) | De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. Dit is optioneel. Indien weggelaten, wordt de waarde van de alias geregistreerd, die ofwel uw site referentie of Web Services gebruikersnaam zal zijn, afhankelijk van uw configuratie. | ||
| orderreference |
Alfanumeriek (25)
Zie beschrijving rechts voor verdere details |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. Wij raden u ten zeerste aan een orderreference voor elke transactie. Aanbevolen lengte 25 tekens of minder (exacte lengte afhankelijk van de wervende bank). Niet-naleving van deze eis kan ertoe leiden dat de tekst in de transactie wordt ingekort. |
||
| parenttransactionreference | Alfanumeriek, inclusief koppeltekens (25) | Hiermee kunt u de transactionreference van een eerder verzoek. De belangrijkste details zijn overgenomen van dit verzoek. | ||
| requesttypedescriptions | Lijst |
De te verwerken verzoektypes. Belangrijk: U moet ervoor zorgen dat "THREEDQUERY" in deze lijst wordt opgegeven wanneer u transacties uitvoert, om ervoor te zorgen dat 3-D Secure wordt verwerkt. Dit is vereist door het PSD2 mandaat. Klik hier voor meer informatie over ondersteunde verzoektypes. |
||
|
|
scaexemptionindicator | Numeriek (1) |
Gebruikt om de aard van 3-D Secure authenticatie te beïnvloeden in scenario's waar dit is toegestaan. Opmerking: Alleen ondersteund door bepaalde acquirerende banken. Neem contact op met het Support Team voor meer informatie. Geef een van de volgende waarden op wanneer u een transactie vrijstelt van authenticatie:
Neem contact op met uw verwerver om na te gaan of u vrijstellingen mag toepassen voordat u dat probeert. U kunt ook een van de volgende waarden invoeren om te vragen dat step up (uitdaging) authenticatie wordt uitgevoerd:
|
|
| settleduedate | Datum JJJJ-MM-DD |
Hier kunt u instellen op welke dag in de toekomst uw transactie moet worden afgewikkeld. Dit moet in het formaat zijn: JJJJ-MM-DD. |
||
| settlestatus | Numeriek (3) |
Een numerieke waarde die wordt gebruikt om de instructie afwikkeling te definiëren.
|
||
| sitereference | Alfanumeriek (50) | Unieke referentie die uw Trust Payments site identificeert. | ||
| subscriptionbegindate | Datum JJJJ-MM-DD |
Optioneel bij het plannen van abonnementen. Dit veld verwijst naar het tijdstip waarop de eerste geautomatiseerd betaling zal worden verwerkt. Vanaf dat moment gebruiken wij de gegevens die in de subscriptionunit en subscriptionfrequency velden om de abonnementsbetalingen op regelmatige tijdstippen automatisch te verwerken, bv. 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 subscriptionbegindate, zullen we de subscriptionunit en subscriptionfrequency velden hierboven om de eerste automatische betaling automatisch te plannen. |
||
| subscriptionfinalnumber | Numeriek (5) |
Vereist bij het plannen van abonnementen. Dit wordt gebruikt om het aantal te verwerken betalingen in de loop van het abonnement in te stellen:
Opmerking: Als de waarde "0" is, zal de Abonnementsmodule betalingen voor onbepaalde tijd plannen totdat de gebruiker het abonnement handmatig op Inactief zet. |
||
| subscriptionfrequency | Numeriek (11) |
Vereist bij het plannen van abonnementen. In combinatie met eenheid bepaalt de frequentie hoe vaak de betalingen worden verwerkt, bijvoorbeeld voor een betaling om de 7 dagen: subscriptionfrequency = 7 en subscriptionunit = DAY bijvoorbeeld voor een betaling om de 2 maanden: subscriptionfrequency = 2 en subscriptionunit = MONTH |
||
| subscriptionnumber | Numeriek (5) |
Optioneel bij het plannen van abonnementen. Tenzij anders vermeld, beginnen abonnementen met subscriptionnumber = 1. De subscriptionnumber wordt automatisch verhoogd bij elke volgende abonnementsbetaling totdat het de waarde van de subscriptionfinalnumber veld, wanneer geen verdere betalingen zullen worden geprobeerd. Een voltooid abonnement wordt weergegeven door een subscriptionnumber die hoger is dan de overeenkomstige subscriptionfinalnumber. |
||
| subscriptiontype | Alpha (11) |
Vereist bij het plannen van abonnementen. 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) |
Vereist bij het plannen van abonnementen. 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. |
||
| threedbypasspaymenttypes | Lijst | Om te voldoen aan PSD2, moet u 3-D Secure verificatie uitvoeren bij alle ondersteunde e-commercetransacties met kaarten. Dit wordt bereikt door ervoor te zorgen dat THREEDQUERY is opgenomen in de requesttypedescriptions lijst in de JWT payload. Uw oplossing kan echter te maken krijgen met omstandigheden waarin 3-D Secure niet vereist / ondersteund wordt door uw wervende bank. Door betalingstypen te specificeren in de threedbypasspaymenttypes lijst wordt 3-D Secure authenticatie niet uitgevoerd voor de bovengenoemde betalingswijzen. | ||
| transactionactive | Numeriek (1) |
Optioneel bij het plannen van abonnementen. De abonnementsstatus."0" - Inactief: Schort toekomstige betalingen op totdat deze handmatig worden opgeheven. "1" - Actief: Plannen van abonnementsbetalingen onmiddellijk, waarbij fraude en dubbele controles worden omzeild (indien ingeschakeld). "2" - In afwachting (standaard): Plannen van abonnementsbetalingen nadat de AUTH is betaald (settlestatus "100"). |
||
| termurl | URL (1024) |
Vereist voor 3-D Secure authenticatie. Deze URL wordt gebruikt om de kaartuitgever te instrueren waarheen de browser van de klant moet worden gestuurd nadat hij is geverifieerd op de ACS van de kaartuitgever. U moet de volgende URL in dit veld invoeren wanneer u 3-D Secure uitvoert: https://payments.securetrading.net/process/payments/mobilesdklistener |
||
