3DS API Veldspecificatie

U moet in dit veld "THREEDLOOKUP" invullen.

U moet in dit veld "ECOM" (e-commerce) invullen.

Het bedrag van de transactie in basiseenheden, zonder komma of decimaalteken, dus €10 wordt ingediend als 1000. Deze waarde moet groter zijn dan nul. (De maximumlengte kan variëren afhankelijk van uw wervende bank - Neem contact op met uw bank voor meer informatie)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

De op de kaart gedrukte vervaldatum.

Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.

Identificeert uw site op het Trust Payments systeem.

Als u uw sitereferentie niet kent, neem dan contact op met ons Support Team.

Voer een van de volgende ondersteunde waarden in:

• "APP- Betaling via een mobiele app.
• "WAP" - Voor browsergebaseerde betalingen.

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.

Voer een van de volgende ondersteunde waarden in:

• "AMEX"
• "DELTA"
• "ELECTRON"
• "MAESTRO"
• "MASTERCARD"
• "MASTERCARDDEBIT"
• "PURCHASING"
• "VISA"

1

Geeft aan of een transactie gemarkeerd is als schuldaflossing:

• 1 - Transactie is gemarkeerd als schuldaflossing.
• 0 - Transactie is niet gemarkeerd als schuldaflossing.

• Als de foutcode "0" is, is de transactie geslaagd.
• Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Een van de volgende waarden kan worden teruggegeven:

• "AMEX"
• "DELTA"
• "ELECTRON"
• "MAESTRO"
• "MASTERCARD"
• "MASTERCARDDEBIT"
• "PURCHASING"
• "VISA"

Dit veld wordt geretourneerd tijdens 3-D Secure versie 2-authenticatie. Dit kan genegeerd worden, omdat u uw eigen threednotificationurl definieert om te gebruiken in stap 2.

Versie van 3-D Secure die wordt gebruikt om de betaling te verifiëren. (bijv. "2.2.0").

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

URL waarnaar uw 3D-server een HTTPS POST verzendt als onderdeel van komende stap 2 (Methode URL). Deze URL wordt verstrekt door de ACS.

Als threedmethodurl niet wordt geretourneerd, maar threedversion wordt geretourneerd met waarde 2.2.0 of hoger, ga dan naar stap 3 (3-D Query).

U moet in dit veld "THREEDQUERY" invullen.

De exacte inhoud van het HTTP-accept-headerveld zoals ontvangen van de user-agent van de kaarthouder.

Als u een Trust Payments (UK/FCA) acquiring account gebruikt, geef dan een van de volgende waarden op:

• "456896" - Visa
• "271708" - Mastercard
• "10000000232" - American Express

Als u een Trust Payments (Malta) acquiring account gebruikt, geef dan een van de volgende waarden op:

• "408912" - Visa
• "529786" - Mastercard
• "10000000232" - American Express

Waarde die de bitdiepte van het kleurenpalet voor de weergave van beelden weergeeft, in bits per pixel.

Geaccepteerde waarden:

• 1
• 4
• 8
• 15
• 16
• 24
• 32
• 48

Of de browser van de klant al dan niet Java kan uitvoeren.

Geaccepteerde waarden: true, false.

Of de browser van de klant al dan niet JavaScript kan uitvoeren.

Geaccepteerde waarden: true, false.

Waarde die de browsertaal weergeeft zoals gedefinieerd in IETF BCP47.

Totale hoogte van het scherm van de klant in pixels.

Vereist voor Visa Secure Data Field Mandate.

Totale breedte van het scherm van de klant in pixels.

Vereist voor Visa Secure Data Field Mandate.

Tijdzoneverschil in minuten tussen UTC en de lokale tijd van de browser van de klant.

Merk op dat de offset positief is als de lokale tijdzone achter UTC ligt en negatief als deze ervoor ligt.

bijv. Als UTC -5 uur: 300 of +300

bijv. Als UTC +5 uur: -300

Unieke identificatiecode die de kaartgegevens van de klant vertegenwoordigt in het systeem van Trust Payment. Deze is 15 minuten geldig vanaf het moment dat het antwoord op THREEDLOOKUP is teruggestuurd.

Dit wordt u teruggegeven in het antwoord op THREEDLOOKUP (stap 1).

challengewindowsize
XPath: /customer/challengewindowsize

Dimensie van het pop-upvenster voor step-up authenticatie-uitdaging.

Geaccepteerde waarden:

• 01 - Voor 250x400
• 02 - Voor 390x400
• 03 - Voor 500x600
• 04 - Voor 600x400
• 05 - Voor volledig scherm

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

Het IP-adres van de klant.

Vereist voor Visa Secure Data Field Mandate.

Voer een van de volgende ondersteunde waarden in:

• "AMEX"
• "DELTA"
• "ELECTRON"
• "MAESTRO"
• "MASTERCARD"
• "MASTERCARDDEBIT"
• "PURCHASING"
• "VISA"

Identificeert uw site op het Trust Payments systeem.

Als u uw sitereferentie niet kent, neem dan contact op met ons Support Team.

Geeft aan of de 3DS-methode met succes is voltooid.

Geaccepteerde waarden:

• Y - Dien Y in indien stap 2 (Methode URL) met succes is voltooid.
• N - Dien N in als threedmethodurl en threednotificationurl waren in THREEDLOOKUP maar stap 2 (Methode URL) werd overgeslagen.
• U - Dien U in als threedmethodurl niet geretourneerd in THREEDLOOKUP.

Universeel unieke transactie-identificatie die door de 3DS-server wordt toegekend om een enkele transactie te identificeren.

Dit wordt u teruggegeven in het antwoord op THREEDLOOKUP (stap 1).

255

Het adres E-mailadres facturatie . Dit kan dan worden gebruikt voor correspondentie met de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken).

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

127

De Voornaam facturatie.

Vereist voor Visa Secure Data Field Mandate.

127

De Achternaam facturatie.

Vereist voor Visa Secure Data Field Mandate.

20

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

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

25

127

25

25

127

127

127

De provincie die is ingevoerd voor het factuuradres.

Dit wordt weergegeven als "State code (eg. NY)” op pagina's met "us_US" locale.

Voor Amerikaanse adressen wordt de staat in dit veld ingevuld.

Geldige formaten:

• Voorkeur: Staatcode van twee tekens, bijvoorbeeld "NY".
• Volledige naam van de staat (geen afkortingen), bijvoorbeeld "New York".

25

2

1

• H = Thuis
• M = Mobiel
• W = Werk

Landcode gekoppeld aan uw account.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte informatie moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

4

Wordt gebruikt om het type goederen en diensten te classificeren dat door je bedrijf wordt aangeboden.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte informatie moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

Naam gekoppeld aan uw account op Trust Payments.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte informatie moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte informatie moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.

Volledig gekwalificeerde URL van de 3DS Requestor website of customer care site. Dit gegevenselement verschaft aanvullende informatie aan het ontvangende 3-D Secure systeem indien zich een probleem voordoet en dient contactinformatie te verschaffen.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De requestor id prefix "TRU93918", gevolgd door "_", en dan de Merchant id (MID).
Voorbeeld: "TRU93918_9991111111"

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte Merchant id (MID) moet overeenstemmen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

In onze testomgeving moet uw systeem de requestor id prefix "11111111" gevolgd door "*", en dan de Merchant id (MID).

Voorbeeld: "11111111*9991111111"

In een live omgeving zou dit de Visa Bank id (BID) van de acquirer zijn, gevolgd door "*" en dan de MID die door de acquirer van de merchant wordt verstrekt.

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De verstrekte Merchant id (MID) moet overeenstemmen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

Trust Payments 3DS toegewezen Requestor-naam voor Mastercard, in het volgende formaat:

3DS Servernaam+"_"+Naam verkoper

bijv. "TrustPayments_Merchantname"

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De opgegeven handelsnaam moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

Naam verkoper die je definieert.

bijv. "Test Merchant1 Ltd"

Als deze niet wordt opgegeven, gebruiken we standaard de gegevens die in onze records zijn opgeslagen. Anders kunt u dit veld indienen om deze waarde per verzoek op te heffen.

De opgegeven handelsnaam moet overeenkomen met de informatie die wordt gebruikt om de rekening bij Visa en Mastercard te registreren voor 3-D Secure authenticatie.

1

Geeft aan of een transactie gemarkeerd is als schuldaflossing:

• 1 - Transactie is gemarkeerd als schuldaflossing.
• 0 - Transactie is niet gemarkeerd als schuldaflossing.

De registratiestatus van de betaalkaart:

• Y - De kaart van de klant is geregistreerd.
• N - De kaart van de klant is niet geregistreerd.
• U - Kan niet vaststellen of de kaart geregistreerd is.
• B - De authenticatieregel van de handelaar wordt geactiveerd om de authenticatie in dit gebruik te omzeilen.

• Als de foutcode "0" is, is de transactie geslaagd.
• Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Het land voor de uitgever van de kaart van de klant.
Dit zal in ISO2A formaat zijn.

Klik hier voor een volledige lijst van landcodes.

• 0 - Transactie verwerkt met een testrekening.
• 1 - Transactie verwerkt met een live rekening.

Het veld maskedpan veld vertegenwoordigt het unieke tokennummer van de klant dat wordt gebruikt om de transactie uit te voeren. De waarde van maskedpan veld wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.

Dit is de Klant Categorie Code (MCC) geassocieerd met de account zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Dit is het land van de handelaar dat aan de rekening is gekoppeld, zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Dit is de Naam verkoper geassocieerd met de account zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Dit is het aan de rekening gekoppelde handelaarsnummer zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Een van de volgende waarden kan worden teruggegeven:

• "AMEX"
• "DELTA"
• "ELECTRON"
• "MAESTRO"
• "MASTERCARD"
• "MASTERCARDDEBIT"
• "PURCHASING"
• "VISA"

Dit is de toegewezen settlestatus waarde, in het geval dat de volgende betaling wordt verwerkt via de TRU Connect gateway, tenzij deze wordt overschreven in de AUTH. Klik hier voor meer informatie over settlestatus.

• Y - Klant geauthenticeerd. Dit antwoord bevat de informatie die nodig is om een transactie te verwerken. U kunt direct doorgaan naar stap 5 om het THREEDRESULT verzoek te verwerken.
• A - Authenticatie geprobeerd, maar kon niet worden voltooid. U kunt direct doorgaan naar stap 5 om het verzoek THREEDRESULT te verwerken, maar houd er rekening mee dat de aansprakelijkheidsdienst mogelijk niet beschikbaar is.
• U - Kan verificatie niet uitvoeren. Aansprakelijkheidsverschuiving zal niet van kracht zijn. Indien u ervoor kiest om door te gaan, ga dan naar stap 5 om het THREEDRESULT verzoek te verwerken.
• N - Authenticatie was niet succesvol. U moet niet doorgaan met de betaling.
• C - Uitdaging vereist voor authenticatie. Ga verder met stap 4 en voltooi de step-up authenticatie.
• R - Authenticatie is geweigerd. U moet niet doorgaan met de betaling.

Versie van 3-D Secure die wordt gebruikt om de betaling te verifiëren. (bijv. "2.2.0")

Bevat informatie over fouten die zijn geretourneerd tijdens het 3-D Secure proces.

Wordt alleen teruggegeven in geval van een fout

Bevat informatie over fouten die zijn geretourneerd tijdens het 3-D Secure proces.

Wordt alleen teruggegeven in geval van een fout

Wordt alleen teruggestuurd als de status C is (wat wijst op een uitdaging).

De browser van de klant moet naar deze URL worden omgeleid als onderdeel van stap 4 (step-up authenticatie).

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.

Wordt alleen teruggestuurd als de status C is (wat wijst op een uitdaging).

Bevat informatie over de uitdagende gebruikersinterface. Wordt doorgegeven aan de ACS als onderdeel van stap 4 (step-up authenticatie).

De waarde van de threedpayload is de creq die nodig is voor stap 4 (Uitdaging).

Identificeert uw site op het Trust Payments systeem.

Als u uw sitereferentie niet kent, neem dan contact op met ons Support Team.

Het bedrag van de transactie in basiseenheden zoals opgegeven in de aanvraag, zonder komma's of decimalen, dus €10 wordt opgegeven als 1000. (Maximale lengte kan variëren afhankelijk van uw overnemende bank - Neem contact op met uw bank voor meer informatie)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

1

Geeft aan of een transactie gemarkeerd is als schuldaflossing:

• 1 - Transactie is gemarkeerd als schuldaflossing.
• 0 - Transactie is niet gemarkeerd als schuldaflossing.

De registratiestatus van de betaalkaart:

• Y - De kaart van de klant is geregistreerd.
• N - De kaart van de klant is niet geregistreerd.
• U - Kan niet vaststellen of de kaart geregistreerd is.
• B - De authenticatieregel van de handelaar wordt geactiveerd om de authenticatie in dit gebruik te omzeilen.

• Als de foutcode "0" is, is de transactie geslaagd.
• Als de foutcode niet "0" is, is de transactie niet geslaagd.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

Het land voor de uitgever van de kaart van de klant.
Dit zal in ISO2A formaat zijn.

Klik hier voor een volledige lijst van landcodes.

• 0 - Transactie verwerkt met een testrekening.
• 1 - Transactie verwerkt met een live rekening.

Het veld maskedpan veld vertegenwoordigt het unieke tokennummer van de klant dat wordt gebruikt om de transactie uit te voeren. De waarde van maskedpan veld wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.

Dit is de Klant Categorie Code (MCC) geassocieerd met de account zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Dit is het land van de handelaar dat aan de rekening is gekoppeld, zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Dit is de Naam verkoper geassocieerd met de account zoals gedefinieerd in het verzoek.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

Een van de volgende waarden kan worden teruggegeven:

• "AMEX"
• "DELTA"
• "ELECTRON"
• "MAESTRO"
• "MASTERCARD"
• "MASTERCARDDEBIT"
• "PURCHASING"
• "VISA"

• Y - Klant heeft zich geverifieerd. U kunt doorgaan naar stap 6 (autorisatie) en een betaling verwerken met behulp van de velden die in dit antwoord worden geretourneerd.
• A - Authenticatie geprobeerd, maar kon niet worden voltooid. U kunt doorgaan naar stap 6 (autorisatie) en een betaling verwerken met behulp van de velden die in dit antwoord worden geretourneerd, maar houd er rekening mee dat de aansprakelijkheidsdienst mogelijk niet beschikbaar is.
• U - Kan geen verificatie uitvoeren. U kunt ervoor kiezen de betaling te verwerken, maar de aansprakelijkheidsverschuiving zal niet van kracht zijn.
• N - Authenticatie was niet succesvol. U moet niet doorgaan met de betaling.
• R - Authenticatie is geweigerd. U moet niet doorgaan met de betaling.

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.