JSON Web Token

  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 Gecodeerd
{
"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"
}

  De baseamount veld getoond in de payload Bovenstaand voorbeeld bevat een waarde in basiseenheden. Dit betekent dat de waarde zonder het decimaalteken, dus £10,50 zou worden opgegeven 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 punt).

 

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 de signature geretourneerde waarde 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:

  1. Base64URL decoderen JWT header
  2. Base64URL decoderen JWT payload
  3. De handtekening opnieuw genereren door de header, de payload en ze ondertekenen met uw secret.
    (zoals hierboven uitgelegd)

 

De payload

Wij bieden een parsingprogramma om de gegevens uit payload velden te halen als onderdeel van de controle van de velden van het betalingsantwoord:

(Kotlin)

val response: PaymentTransactionManager.Response = paymentTransactionManager.executeSession(paymentSession)

//Every JWT returned from the SDK should be verified before further usage.
for (jwt in response.responseJwtList) {
if (!verifyJwtIntegrity(jwt)) {
throw SecurityException("JWT verification failed!")
}
}

val parsedResponse = ResponseParser.parse(response.responseJwtList)

//process parsed response

 

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.
  • We raden ten zeerste af om verdere betalingen met deze kaart uit te voeren, omdat de klant de verificatie niet heeft doorstaan, wat wijst op een verhoogd frauderisico.
  • In plaats daarvan adviseren wij de klant een foutmelding te geven dat de betaling niet is voltooid, en alternatieve betaalmethoden aan te bieden.
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
X1-EN.png JWT Payload  

 

X1-EN.png 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.

X1-EN.png iss Alfanumeriek (255) Uw JWT-gebruikersnaam.
X1-EN.png Payload Object    
X1-EN.png   accounttypedescription Alfanumeriek (20) De ingediende waarde is "ECOM" (vertegenwoordigt een e-commerce transactie).
X3-EN.png   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 .

X3-EN.png   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.
X1-EN.png   billingfirstname Alfanumeriek (127)

De Voornaam facturatie.

Vereist voor Visa Secure Data Field Mandate.

Vereist voor handelaren in kansspelen.

X3-EN.png   billingmiddlename Alfanumeriek (127) De facturatie middelste naam.
X1-EN.png   billinglastname Alfanumeriek (127)

De Achternaam facturatie.

Vereist voor Visa Secure Data Field Mandate.

Vereist voor handelaren in kansspelen.

X3-EN.png   billingsuffixname Alfanumeriek (25) De naam van het achtervoegsel voor facturering.
X3-EN.png   billingpremise Alfanumeriek (25)

Het huisnummer of de eerste regel van het factuuradres.

X3-EN.png   billingstreet Alfanumeriek (127)

Het huisnummer of de eerste regel van het factuuradres.

X3-EN.png   billingtown Alfanumeriek (127)

De stad die is ingevoerd voor het factuuradres.

X3-EN.png   billingcounty Alfanumeriek (127) Provincie facturatie.

Opmerking: Indien ingediend, billingcountryiso2a is vereist.

X3-EN.png   billingpostcode Alfanumeriek (25)

De Postcode facturatie of postcode moet geldig zijn voor de billingcountryiso2a ingediend.

X2-EN.png

  billingcountryiso2a iso2a Land facturatie in iso2a formaat.

Verplicht als billingcounty is ingediend.

Anders, optioneel.

X2-EN.png   billingemail E-mail (255)

E-mailadres facturatie adres.

Vereist voor Visa Secure Data Field Mandate wanneer billingtelephone niet is voorzien.

X2-EN.png   billingtelephone Alfanumeriek, inclusief
symbolen (20)

Telefoonnummer voor facturering. Geldige tekens:

  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )

Vereist voor Visa Secure Data Field Mandate wanneer billingemail niet is voorzien.

X3-EN.png   billingtelephonetype Char (1) Type facturering telefoonnummer:
  • "H" - Thuis
  • "M" - Mobiel
  • "W" - Werk
X2-EN.png   credentialsonfile Numeriek (1)

De volgende waarden kunnen worden ingediend:

  • 0 - Komt niet in aanmerking voor Gevevens in Bestand (CoF), of is niet van plan om referenties op een later tijdstip opnieuw te gebruiken.
  • 1 - Kaarthoudergegevens gemarkeerd als beschikbaar voor toekomstig gebruik (vereist bij het plannen van een abonnement). De klant moet EMV 3DS ondergaan step-up authenticatie om de transactie te voltooien.
  • 2 - Betaling met behulp van eerder opgeslagen referenties.

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.
X3-EN.png   customerprefixname Alfanumeriek (25) Leveringsnaam.
X3-EN.png   customerfirstname Alfanumeriek (127)
X3-EN.png   customermiddlename Alfanumeriek (127)
X3-EN.png   customerlastname Alfanumeriek (127)
X3-EN.png   customersuffixname Alfanumeriek (25)
X3-EN.png   customerpremise Alfanumeriek (25)

Leveringsadres.

De leveringspostcode of postcode moet geldig zijn voor de customercountryiso2a ingediend.

X3-EN.png   customerstreet Alfanumeriek (127)
X3-EN.png   customertown Alfanumeriek (127)
X3-EN.png   customercounty Alfanumeriek (127)
X3-EN.png   customercountryiso2a iso2a
X3-EN.png   customerpostcode Alfanumeriek (25)
X3-EN.png   customeremail E-mail (255) E-mailadres van de bezorger.
X3-EN.png   customertelephone Alfanumeriek, inclusief
symbolen (20)

Telefoonnummer aflevering. Geldige tekens:

  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X3-EN.png   customertelephonetype Char (1) Type levering telefoonnummer:
  • "H" - Thuis
  • "M" - Mobiel
  • "W" - Werk
X3-EN.png   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
X1-EN.png   currencyiso3a iso3a

De Munt waarin de transactie werd verwerkt.

Klik hier voor meer informatie.

X1-EN.png   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 "1050".

  mainamount Numeriek (14) Ofwel baseamount of mainamount moet worden opgenomen (niet allebei).

Het bedrag van de transactie in hoofdeenheden.
Vermeld alleen de waarde van het bedrag en het decimaalteken (geen komma's).
Bijv. €10,99 wordt ingediend als 10.99.
Valuta's zoals Japanse Yen die geen decimaal nodig hebben, worden zonder decimaal weergegeven. Bijvoorbeeld 1000 Yen is 1000.

X2-EN.png

  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".

  • "A" - Herautorisatie
  • "C" - Onvoorziene betaling
  • "D" - Uitgestelde kosten
  • "S" - Opnieuw indienen
  • "X" - No-show (voor een hotelboeking)

Zie Visa's eigen documentatie voor meer informatie.

X3-EN.png   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:
  • ‘cy_GB’ Welsh (Verenigd Koninkrijk)
  • ‘da_DK’ Deens (Denemarken)
  • ‘de_DE’ Duits (Duitsland)
  • ‘en_US’ Engels (Verenigde Staten)
  • ‘en_GB’ Engels (Verenigd Koninkrijk)
  • ‘es_ES’ Spaans (Spanje)
  • ‘fr_FR’ Frans (Frankrijk)
  • ‘it_IT’ Italiaans (Italië)
  • ‘nl_NL’ Nederlands (Nederland)
  • ‘no_NO’ Noors (Noorwegen)
  • ‘sv_SE’ Zweeds (Zweden)
X3-EN.png   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.
X3-EN.png   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.

X3-EN.png   parenttransactionreference Alfanumeriek, inclusief koppeltekens (25) Hiermee kunt u de transactionreference van een eerder verzoek. De belangrijkste details zijn overgenomen van dit verzoek.
X1-EN.png   requesttypedescriptions Lijst

De te verwerken verzoektypes.
Om een 3-D Secure geverifieerde betaling te verwerken, dient u [“THREEDQUERY”,”AUTH”].

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.

X2-EN.png

  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:

  • 1 - Lage waarde
  • 2 - Transactierisicoanalyse
  • 3 - Vertrouwde handelaar
  • 4 - Beveiligde zakelijke betaling
  • 5 - Gedelegeerde 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:

  • 13 - Verzoek step-up authenticatie naar goeddunken van de kaartuitgever.
  • 14 - Verzoek step-up authenticatie wordt uitgevoerd.
X3-EN.png   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.
X3-EN.png   settlestatus Numeriek (3) Een numerieke waarde die wordt gebruikt om de instructie afwikkeling te definiëren.
  • "0" - Automatisch (standaard wanneer geen waarde is opgegeven)
  • "1" - Handmatig
  • "2" - Geschorst
X1-EN.png   sitereference Alfanumeriek (50) Unieke referentie die uw Trust Payments site identificeert.
X2-EN.png   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.
bijv. In hetzelfde scenario als hierboven, maar zonder het indienen van de subscriptionbegindate, zou de eerste geautomatiseerde betaling op 5 februari 2018 (1 MONTH na het oorspronkelijke verzoek) worden verwerkt. Alle volgende betalingen zullen op de 5e van elke maand worden verwerkt.

X2-EN.png   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:

  • Bij de verwerking van een gecombineerd AUTH SUBSCRIPTION verzoek:
    Als subscriptionnumber = 1

    en subscriptionfinalnumber = 12
    Er zijn in totaal 12 betalingen (de eerste AUTH + 11 abonnementsbetalingen).
  • Bij de verwerking van een gecombineerd ACCOUNTCHECK SUBSCRIPTION verzoek:
    Als subscriptionnumber = 1

    en subscriptionfinalnumber = 12
    Er zullen 11 betalingen in totaal (De eerste ACCOUNTCHECK + 11 abonnementsbetalingen)

    (De eerste ACCOUNTCHECK telt mee voor het uiteindelijke aantal)

Opmerking: Als de waarde "0" is, zal de Abonnementsmodule betalingen voor onbepaalde tijd plannen totdat de gebruiker het abonnement handmatig op Inactief zet.

X2-EN.png   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

X2-EN.png   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.

X2-EN.png   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:

  • RECURRING wordt gebruikt wanneer de klant een terugkerende betaling doet voor telkens een nieuw product/dienst (bijvoorbeeld een tijdschriftabonnement). Voor de meeste handelaren is de subscriptiontype moet worden ingesteld op "RECURRING".
  • INSTALLMENT wordt alleen gebruikt in bepaalde gevallen met bepaalde acquirers*. Het is bedoeld voor wanneer een klant een enkele bestelling koopt, waarbij de betaling in verschillende termijnen wordt geïnd (bijvoorbeeld 100 pond per maand betalen voor een bestelling totdat deze volledig is betaald).

*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.

X2-EN.png   subscriptionunit Alfa (5)

Vereist bij het plannen van abonnementen.


Dit veld vertegenwoordigt de tijdseenheid tussen elk abonnement. Dit kan zijn "DAY" of "MONTH".

Let op: Het is absoluut noodzakelijk dat dit veld in HOOFDLETTERS bij de gateway wordt ingediend ("DAY" of "MONTH").

X3-EN.png   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.
X2-EN.png   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").

X2-EN.png   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

X2-EN.png   walletsource Alfa (9)

Vereist voor Google Pay transacties.


Moet worden ingediend met "GOOGLEPAY".

X2-EN.png   wallettoken JSON-gecodeerde string

Vereist voor Google Pay transacties.


Uniek token verstrekt door Google om de kaartgegevens van de klant weer te geven.
Dit mag niet worden gewijzigd.

Was dit artikel nuttig?
0 van de 0 vonden dit nuttig
Hebt u meer vragen? Dien een verzoek in