1. Introductie

Deze lijst bevat alle relevante 3-D Secure V2-parameters en is opgesplitst in drie secties:

2. Verplichte parameters

Als je onze Nexi Payengine Hosted Payment Page-pagina gebruiktwe, verzorgen wij deze parameters voor je. Als je transacties via DirectLink, verwerkt, zul je deze parameters handmatig aan je verzoek moeten toevoegen.

Parameter
browserAcceptHeader

Accept-headers browser.

Exacte inhoud van de HTTP
accept-headers zoals die van de
browser van de kaarthouder naar
de merchant verzonden werden.

browserColorDepth

Kleurdiepte scherm browser.

Waarde die de bitdiepte aanduidt van het kleurenpalet dat afbeeldingen weergeeft, in bits per pixel. Verkregen van de browser van de kaarthouder door middel van de kleurdiepteeigenschap.

browserJavaEnabled

Java ingeschakeld browser.

Boolean die aanduidt of de browser van de kaarthouder Java kan uitvoeren. Waarde wordt
teruggezonden vanuit de eigenschap "navigator
javaEnabled".

browserLanguage

Taal browser.

Waarde die de taal van de browser aanduidt zoals
gedefinieerd wordt in IETF BCP47. Teruggezonden vanuit de eigenschap "navigatortaal".

(Voorbeeld: en, fr, en-US, fr-ca) Maakt geen onderscheid tussen hoofdletters en kleine letters.

browserScreenHeight

Schermhoogte browser.

Totale hoogte van het scherm van
de kaarthouder in pixels. Waarde
wordt teruggezonden vanuit de
eigenschap "schermhoogte".

browserScreenWidth

Schermbreedte browser.

Totale breedte van het scherm van de kaarthouder in pixels. Waarde wordt teruggezonden vanuit de eigenschap "schermbreedte".

browserTimeZone

Tijdzone browser.

Tijdsverschil tussen UTC-tijd en de lokale tijd van de browser van de kaarthouder, in minuten.

browserUserAgent

Useragent browser.

Exacte inhoud van de HTTP useragent header.

ACCEPTURL

De URL van de webpagina die aan de klant wordt getoond als de betaling werd geautoriseerd (of wacht op autorisatie).

DECLINEURL

De URL naar waar de klant wordt doorgestuurd wanneer het maximale aantal mislukte autorisatiepogingen is bereikt (standaard 10, maar kan worden gewijzigd op de pagina ‘Technical Information’ (Technische informatie), in de sectie ‘Payment retry’ (Betaalpogingen) van het tabblad ‘Global transaction parameters’ (Algemene transactieparameters).

EXCEPTIONURL

De URL van de webpagina die aan de klant wordt getoond als het resultaat van de betaling onzeker is.

LANGUAGE

De talen van de betaalpagina die momenteel worden aangeboden aan de koper (kaarthouder/rekeninghouder).

De standaardtaal wordt gebruikt als er geen taalwaarde of een ongeldige taalwaarde wordt verzonden:
en_US (Engels)

FLAG3D

Vaste waarde: "Y" Geeft ons systeem de opdracht om 3-D Secure-identificatie uit te voeren indien nodig.

CN

cardholderName

Naam van de kaarthouder (klant).

Mpi.carteBancaire.Usecase

Verplicht voor Carte Bancaire

Voor alle integratiemodi

Type betaling waarvoor een authenticatie wordt gevraagd

REMOTE_ADDR

Verplicht voor Carte Bancaire

Voor DirectLink-verzoken
browserIP.

IP-adres van de klant (alleen voor de
fraudedetectiemodule). Voor interfaces waarbij ons systeem de dialoog met de klant beheert (bv. e-Commerce) wordt het REMOTE_ADDR rechtstreeks door ons vastgelegd. Voor andere interfaces moet de merchant het IP-adres van de klant samen met de transactiedetails opsturen.

 

If you process transactions for Visa, make sure to add the following mandatory parameters as well:

For all integration modes:

Mpi.WorkPhone.countryCode + Mpi.WorkPhone.subscriber
or
Mpi.MobilePhone.countryCode + Mpi.MobilePhone.subscriber
or
Mpi.HomePhone.countryCode + Mpi.HomePhone.subscriber
or
EMAIL

For DirectLink requests: 

REMOTE_ADDR

3. Aanbevolen parameters

Parameter
ECOM_BILLTO_POSTAL_CITY

billAddrCity.

Stad op de factuur

ECOM_BILLTO_POSTAL_COUNTRYCODE

billAddrCountry.

Landcode op de factuur

ECOM_BILLTO_POSTAL_STREET_LINE1

billAddrLine1.

Factuuradres, eerste regel

ECOM_BILLTO_POSTAL_STREET_LINE2

billAddrLine2.

Factuuradres, tweede regel

ECOM_BILLTO_POSTAL_POSTALCODE

billAddrPostCode

Postcode op de factuur

EMAIL

email.

E-mailadres van de klant.

4. Optionele parameters

Verder kun je zoveel parameters als gewenst versturen. Hoe meer parameters je verstuurt, hoe groter de kans op een soepele verwerking.

Parameter
Mpi.threeDSRequestorChallengeIndicator

Gebruik deze parameter om vrijstellingen van 3DS aan te vragen.

Indicator identiteitsbevestiging merchant.

Geeft aan of er een identiteitsbevestiging aangevraagd werd voor deze transactie. Bijvoorbeeld:


Voor 01-PA heeft een merchant
mogelijk bedenkingen bij de transactie en kan hij een identiteitsbevestiging aanvragen.


Voor 02-NPA kan een identiteitsbevestiging nodig zijn
wanneer er een nieuwe kaart aan een portefeuille wordt toegevoegd.
Voor lokale/regionale mandaten
of voor andere variabelen.

 

Mpi.merchantFraudRate

Percentage handelaarsfraude (Merchant Fraud)

Het percentage handelaarsfraude in de EER (alle creditkaartfraude in de EER gedeeld door alle hoeveelheden creditcards in de EER) berekend volgens de technische reguleringsnormen voor PSD2 (Regulatory Technical Standards ofwel RTS).

Zorg ervoor dat je het percentage berekent volgens de regulering PSD2 RTS artikel 19, aangezien noch wij noch MasterCard de score zullen valideren.

Mpi.secureCorporatePayment

Veilige bedrijfsbetaling

Geeft aan dat specifiek daartoe bestemde betalingsprocessen en -procedures zijn gebruikt en dat mogelijk de uitzondering voor veilige bedrijfsbetalingen van toepassing is.
Verzend dit veld alleen met "J" als het verwerversuitzonderingsveld leeg is, aangezien
verwerversuitzondering en veilige betaling elkaar wederzijds uitsluiten.
De directoryserver (DS) zal de voorwaarden in de extensie echter niet valideren. De DS zal de gegevens doorsturen zoals deze zijn ontvangen.
Je kunt optioneel aangeven dat deze van toepassing zijn op de speciaal daartoe bestemde processen en protocollen volgens PSD2 RTS artikel 17, wat de uitgever toe zou kunnen staan de uitzondering voor veilige bedrijfsbetalingen te claimen.

Mpi.cardholderAccountChangeIndicator

Indicator aanpassing account kaarthouder*.

Hoeveel tijd er verstreken is sinds de informatie van het account van de kaarthouder bij de merchant het laatst aangepast werd, inclusief factuur- of verzendadres, nieuwe betalingsrekening of nieuwe gebruiker(s) toegevoegd.

Mpi.cardholderAccountDate

Datum account kaarthouder*.

Datum waarop de kaarthouder het account bij de merchant geopend heeft.

Mpi.cardholderAccountPasswordChange

Aanpassing wachtwoord account kaarthouder*.

Datum waarop het wachtwoord of account van de kaarthouder bij de merchant veranderd of gereset werd.

Mpi.cardholderAccountPasswordChangeIndicator

Indicator aanpassing wachtwoord account kaarthouder*.

Geeft aan hoeveel tijd er verstreken is sinds het wachtwoord of account van de kaarthouder bij de merchant veranderd of gereset werd.

Mpi.numberOfPurchaseWithAccountInTheLastSixMonths

Aantal aankopen account kaarthouder*

Aantal aankopen met dit account
van de kaarthouder tijdens de
afgelopen zes maanden.

Mpi.paymentAccountAge

Leeftijd betalingsrekening*

Datum waarop de betalingsrekening werd ingeschreven in het account van
de kaarthouder bij de merchant.

Mpi.paymentAccountAgeIndicator

Indicator leeftijd betalingsrekening kaarthouder*

Geeft aan hoe lang de betalingsrekening ingeschreven was in het account van de kaarthouder bij de merchant.

Mpi.provisionAttemptsInTheLast24Hours

Aantal pogingen toevoeging dag.

Aantal pogingen om een kaart toe
te voegen in de afgelopen 24 uur.

Mpi.shippingAddressUsage

Gebruik verzendadres.

Datum waarop het verzendadres
van deze transactie voor het eerst
gebruikt werd bij de merchant.

Mpi.shippingAddressWasFirstUsed

Indicator gebruik verzendadres.

Geeft aan wanneer het verzendadres van deze transactie voor het eerst gebruikt werd bij de merchant.

Mpi.shippingNameAndCardholderNameAreIdentical

Indicator naam verzender.

Geeft aan of de naam van de kaarthouder in het account dezelfde is als de naam van de verzender van deze transactie.

Mpi.suspiciousAccountActivityDetected

Verdachte activiteit account.

Geeft aan of de merchant verdachte activiteiten heeft waargenomen (waaronder eerdere fraude) in het account van de kaarthouder.

Mpi.transactionActivityInTheLast24Hours

Aantal transacties dag.

Aantal transacties (succesvol en
stopgezet) van dit account van de
kaarthouder bij de merchant voor
alle betalingsrekeningen in de
afgelopen 24 uur.

Mpi.transactionActivityLastYear

Aantal transacties jaar.

Aantal transacties (succesvol en
stopgezet) van dit account van de
kaarthouder bij de merchant voor alle betalingsrekeningen in het afgelopen jaar.

Mpi.challengeWindowSize

Grootte venster identiteitsbevestiging.

Afmetingen van het venster voor
identiteitsbevestiging dat aan de
kaarthouder getoond werd. De ACS zal reageren met content die zo geformatteerd is dat hij goed in dit venster weergegeven wordt voor de best mogelijke gebruikservaring. De vooraf geconfigureerde afmetingen zijn
breedte x hoogte in pixels van het venster dat weergegeven wordt in het browservenster van de kaarthouder.

Mpi.HomePhone.countryCode

Landcode vaste telefoon.

Landcode van een vaste telefoon

Mpi.HomePhone.subscriber

Vaste telefoon.

Vaste telefoon (zonder landcode)

Mpi.deliveryEmailAddress

E-mailadres levering.

Voor elektronische levering is dit het e-mailadres waar de koopwaar geleverd werd.

Mpi.deliveryTimeframe

Levertijd.

Geeft de levertijd van de koopwaar aan.

Mpi.giftCardAmount

Bedrag cadeaubon.

Het totale aankoopbedrag van
aankopen met prepaidkaart of
cadeaubon, in gehele eenheden
(bv. USD 123,45 wordt 123).

Mpi.giftCardCount

Aantal cadeaubonnen.

Totaal aantal aangekochte
prepaidkaarten of
cadeaubonnen/-codes.

Mpi.giftCardCurrency

Valuta cadeaubon.

De valutacode van de aangekochte prepaidkaart of cadeaubon zoals gedefinieerd in ISO 4217.

Mpi.preOrderDate

Datum vooruitbestelling.

De verwachte datum waarop de
koopwaar van een vooruitbestelling beschikbaar is.

Mpi.cardholderAccountAgeIndicator

Indicator leeftijd account kaarthouder*

Geeft aan hoe lang de kaarthouder
het account bij de merchant al heeft.

Mpi.cardholderAccountChange

Aanpassing account kaarthouder*

Datum waarop het account van
de kaarthouder het laatst aangepast werd, inclusief factuurof verzendadres, nieuwe betalingsrekening of nieuwe
gebruiker(s) toegevoegd.

Mpi.preOrderPurchaseIndicator

Indicator vooruitbestelling.

Geeft aan of de kaarthouder een
bestelling plaatst voor koopwaar
die in de toekomst beschikbaar is
of die een releasedatum heeft.

Mpi.reorderItemsIndicator

Indicator nabestelling items.

Geeft aan of de kaarthouder koopwaar die hij/zij al eens heeft besteld, nabestelt.

Mpi.shippingIndicator

Indicator verzending.

Geeft aan welke verzendmethode
er voor de transactie gekozenwerd. Merchants moeten kiezen voor de indicatiecode van de verzending die de  specifieke transactie van de kaarthouder, en niet hun algemene methodes, het best beschrijft.
Gebruik als er een of meerdere items in de aankoop zitten de indicatiecode voor fysieke goederen. Als alle goederen digitaal zijn, gebruik dan de indicatiecode die het duurste item beschrijft.

Mpi.MobilePhone.countryCode

Landcode mobiele telefoon.

Landcode van een mobiele telefoon

Mpi.MobilePhone.subscriber

Mobiele telefoon.

Mobiel telefoon (zonder landcode)

Mpi.threeDSRequestorAuthenticationData

Authenticatiegegevens merchant.

Gegevens die een specifiek authenticatieproces vastleggen
en ondersteunen. In de huidige versie van de specificatie wordt dit gegevenselement niet in detail gedefinieerd. De bedoeling is echter dat dit veld voor elke authenticatiemethode van een merchant de gegevens bevat die de ACS kan gebruiken om het authenticatieproces te verifiëren.
Bijvoorbeeld, voor methode:
02—kan het veld generische
authenticatiegegevens van de
merchant bevatten
03—kan het gegevenselement
informatie bevatten over de
verschaffer van de gefedereerde
ID en gerelateerde informatie
04—kan het gegevenselement de
FIDO-bevestigingsgegevens
bevatten (waaronder de
handtekening) Er wordt verwacht dat deze details opgenomen worden in de
toekomstige versies van de specificatie

Mpi.threeDSRequestorAuthenticationMethod

Authenticatiemethode merchant.

Systeem dat door de kaarthouder
gebruikt wordt om aan de merchant te authenticeren.

Mpi.threeDSRequestorAuthenticationTimestamp

Tijdstip authenticatie merchant.

Datum en tijdstip in UTC van de
authenticatie van de kaarthouder

Mpi.threeDSRequestorPriorAuthenticationData

Authenticatiegegevens vorige transactie merchant.

Gegevens die een specifiek
authenticatieproces vastleggen en ondersteunen. In de huidige
versie van de specificatie wordt
dit gegevenselement niet in detail
gedefinieerd. De bedoeling is echter dat deze velden voor elke authenticatiemethode van een merchant de gegevens bevatten die de ACS kan gebruiken om het authenticatieproces te verifiëren.

Mpi.threeDSRequestorPriorAuthenticationMethod

Authenticatiemethode vorige transactie merchant.

Systeem dat door de kaarthouder
gebruikt wordt om op voorhand aan de merchant te authenticeren.

Mpi.threeDSRequestorPriorAuthenticationTimestamp

Tijdstip authenticatie vorige transactie merchant.

Datum en tijdstip in UTC van de vorige authenticatie van de kaarthouder.

Mpi.threeDSRequestorPriorReference

Referentie vorige transactie merchant.

Dit gegevenselement biedt extra informatie aan de ACS om de beste manier te bepalen voor het afhandelen van een verzoek.

Mpi.transactionType

Transactiesoort.

Stelt de soort transactie vast die
geauthenticeerd wordt.

Mpi.WorkPhone.countryCode

Landcode werktelefoon.

Landcode van een werktelefoon

Mpi.WorkPhone.subscriber

Werktelefoon.

Telefoon die gebruikt wordt voor
werkdoeleinden (zonder landcode)

TP Om de opmaak van de pagina ‘order_A3DS’ te wijzigen, kunt u via deze parameter de naam of URL van een template versturen (ga naar e-Commerce: Dynamische sjabloon).
WIN3DS

Hoe de identificatiepagina aan de klant wordt getoond. Mogelijke waarden:

  • MAINW: om de identificatiepagina in het hoofdvenster weer te geven (standaardwaarde).
  • POPUP: om de identificatiepagina weer te geven in een pop-upvenster en nadien terug te keren naar het hoofdvenster.
  • POPIX: om de identificatiepagina weer te geven in een pop-upvenster en nadien in het pop-upvenster te blijven.
ADDRMATCH

addrMatch.

Geeft aan of het factuur- en verzendadres hetzelfde
zijn. 1=ja
0=nee

TRXDATE

purchaseDate.

Transactiedatum.

ECOM_SHIPTO_POSTAL_CITY

shipAddrCity.

Stad verzending

ECOM_SHIPTO_POSTAL_STREET_LINE1

shipAddrLine1.

Verzendadres, eerste regel

ECOM_SHIPTO_POSTAL_STREET_LINE2

shipAddrLine2.

Verzendadres, tweede regel.

ECOM_SHIPTO_POSTAL_POSTALCODE

shipAddrPostCode.

Postcode verzending

ECOM_SHIPTO_POSTAL_COUNTRYCODE shipAddrCountry.
Landcode verzending
Mpi.carteBancaire.AcquirerExemption

Verzoek om toepassing RTS Acquirer Transaction Risk Analysis uitzondering

Mpi.carteBancaire.MerchantScore

Jouw berekende score voor deze transactie

Mpi.carteBancaire.NumberOfItems

Aantal items in de huidige order

Mpi.carteBancaire.Usecase

Type betaling waarvoor een authenticatie wordt gevraagd