AUTH

De volgende documentatie legt uit hoe u handmatig een AUTH verzoek indient via onze Webservices API.

Als u reeds e-commerce betalingen verwerkt met behulp van onze JavaScript Library (met behulp van 3-D Secure v2), hoeft u het hier beschreven AUTH verzoek niet langer handmatig uit te voeren (aangezien de JavaScript Library het autorisatie automatisch zal uitvoeren).

 

Vereisten

  De volgende inhoud gaat ervan uit dat u de noodzakelijke PCI-certificering hebt verkregen om gevoelige kaarthoudergegevens te verwerken en in te dienen in het verzoek aan onze Webservices API.

Als u niet zeker bent, neem dan contact op met ons Support Team voor hulp.

Alle bedrijven binnen de EER (Europese Economische Ruimte) zijn verplicht 3-D Secure te gebruiken bij de verwerking van e-commercetransacties, als onderdeel van het PSD2 -mandaat.

Handelaren die e-commercetransacties verwerken MOETEN 3DS-verificatie ondersteunen. Klik hier voor meer informatie.

De volgende inhoud mag alleen worden gebruikt door merchants die Mail Order Telephone Order (MOTO) betalingen verwerken of andere workflows die zijn vrijgesteld van het PSD2 mandaat.

  ECOM (e-commerce) Maestro-transacties vereisen de implementatie van 3-D Secure om succesvol te kunnen worden verwerkt.

Om 3-D Secure uit te voeren, moet u onze JavaScript Library gebruiken. Klik hier om te beginnen.

Om fraude te verminderen heeft Visa alle in het Verenigd Koninkrijk gevestigde handelaren met een Klant Categorie Code (MCC) van 6012 verplicht zijn extra velden mee te sturen in AUTH en ACCOUNTCHECK verzoeken.

Als deze velden niet worden ingevuld, kan de transactie niet succesvol worden verwerkt, met een "60025" errorcode die in het antwoord terugkomt.

Klik hier voor meer informatie.

 

AUTH verzoek

Voorbeeld

Om een AUTH verzoek met succes te verwerken, moet u de onderstaande specificatie volgen:

Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"sitereference": "test_site12345",
"requesttypedescriptions": ["AUTH"],
"accounttypedescription": "MOTO",
"currencyiso3a": "GBP",
"baseamount": "1050",
"orderreference": "My_Order_123",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

  Wanneer u het AUTH verzoek test, moet u ervoor zorgen dat u uw test indient sitereference. Dit zorgt ervoor dat transacties worden verwerkt naar onze testbank en dat er geen geld van eigenaar wisselt. Wanneer u gaan leven, moet je je test site referentie omruilen voor je live site referentie.

Klik hier voor test kaartnummers die u kunt gebruiken in AUTH verzoeken tijdens het testen.

 

Specificatie veld

Operatie

De volgende velden hebben betrekking op het soort verzoek dat wordt ingediend:

  Veld Formaat Beschrijving
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20)

Het type rekening dat moet worden gebruikt:

  • "ECOM" - E-commerce
  • "MOTOMail Order Telefoon Order
  • "RECUR" - Terugkerende transacties
X3-EN.png authmethod
XPath: /operation/authmethod
Alpha (11)

Auth-methoden worden gebruikt om aan te geven hoe een transactie door de kaartuitgever moet worden verwerkt. Elke authmethod heeft andere eisen. Klik op de volgende links voor meer informatie:

  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 .

X2-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numeriek (1) De toegestane waarden voor dit veld zijn 0, 1 en 2.
  • "0" - Komt niet in aanmerking voor CoF, of is niet van plan de referenties op een later tijdstip opnieuw te gebruiken.
  • "1" - Kaarthoudergegevens gemarkeerd als beschikbaar voor toekomstig gebruik.
  • "2" - Betaling met gebruik van eerder opgeslagen inloggegevens.

Dit is vereist voor transacties waarbij de merchant gebruik maakt van Gevevens in Bestand (CoF). Als de transactie niet in aanmerking komt voor CoF, of als u de referenties niet wilt gebruiken voor toekomstige transacties, kunt u dit veld weglaten.

X3-EN.png cryptocurrencyindicator
XPath: /operation/cryptocurrencyindicator
Numeriek (1)

Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:

  • 1 - Transactie is gemarkeerd als aankoop van cryptocurrency.
  • 0 - Transactie is niet gemarkeerd als aankoop van cryptocurrency.

Aan het gebruik van deze functionaliteit zijn voorwaarden verbonden. Klik hier voor meer informatie.

X2-EN.png initiationreason
XPath: /operation/initiationreason
Char (1)

Dit is vereist bij de verwerking van een Merchant Initiated Transaction (MIT).

Hiermee kunt u een reden toewijzen voor een Merchant Initiated Transaction (MIT).

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)

Klik hier voor meer informatie over de verschillende initiationreason waarden.

Let op: U moet ervoor zorgen dat de initiationreason in het verzoek correct de reden voor de nieuwe betaling weergeeft.

X3-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alfanumeriek
en koppeltekens (25)
Hiermee kunt u de transactionreference van een eerder verzoek. De belangrijkste gegevens zijn geërfd van dit verzoek.
X1-EN.png requesttypedescriptions
XPath: /@type
Alpha (20) U moet "AUTH" invoeren, zoals in het verzoekvoorbeeld.
X2-EN.png scaexemptionindicator
XPath: /operation/scaexemptionindicator
Numeriek (1)

Vereist indien een transactie wordt gemarkeerd als vrijgesteld van EMV 3DS. Klik hier voor meer informatie.

Geef een van de volgende waarden op:
1 - Lage waarde
2 - Analyse van transactierisico's
3 - Vertrouwde handelaar
4 - Beveiligde zakelijke betaling
5 - Gedelegeerde authenticatie

De scaexemptionindicator veld mag alleen worden ingediend in een AUTH verzoek. Indiening van de scaexemptionindicator veld wordt niet ondersteund wanneer naar een bovengeschikte transactie wordt verwezen. Indien niet aan deze voorwaarden wordt voldaan, wordt de vrijstelling niet toegepast.

X1-EN.png sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)

Identificeert uw site op het Trust Payments systeem.

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

Betaling

De volgende velden bevatten de betalingsgegevens van de klant:

  Veld Formaat Beschrijving
X1-EN.png baseamount
XPath: /billing/amount
Numeriek (13) 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)
X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

Indien de Munt in een ondergeschikt verzoek wordt ingediend, moet deze dezelfde waarde hebben als de bovengeschikte transactie.

X1-EN.png expirydate
XPath: /billing/payment/expirydate
Datum MM/JJJJ De op de kaart gedrukte vervaldatum.
X1-EN.png pan
XPath: /billing/payment/pan
Numeriek (12-19) Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.
X3-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X3-EN.png securitycode
XPath: /billing/payment/securitycode
Numeriek (3-4) Dit is de 3-cijferige beveiligingscode die op de achterkant van de kaart staat.

(Voor AMEX kaarten is dit een 4-cijferige code op de voorkant van de kaart)

Dit veld is niet strikt vereist door Trust Payments, maar het wordt sterk aanbevolen voor de verwerking van de veiligheidscodecontroles.

Bovendien kunnen sommige banken de betaling weigeren als de beveiligingscode niet aanwezig is.

Handelaar

De volgende velden hebben betrekking op uw accountconfiguratie en laten u toe aangepaste unieke referenties voor uw aanvraag te configureren:

  Veld Formaat Beschrijving
X3-EN.png chargedescription
XPath: /merchant/chargedescription
Alfanumeriek, inclusief
symbolen (25)

Dit is een beschrijving van de betaling die op het bankafschrift van de klant verschijnt.

Dit wordt ondersteund voor handelaren met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, dient u contact op te nemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat u verder gaat.

De specificatie van dit veld is afhankelijk van uw wervende bank.

Klik hier voor meer informatie.

 Geldige tekens:

  • Hoofdletters/kleine letters A-Z
  • Cijfers 0-9
  • Ruimtes
  • Interpunctie: + - _ . @ ( )
X3-EN.png merchantemail
XPath: /merchant/email
E-mail (255) Het e-mailadres van de handelaar. Maximale lengte van 255 (maximaal 64 tekens voor het "@"-symbool).
X3-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. Standaard is dit de gebruikersnaam van de Web Services in het verzoek. Dit kan worden overschreven met een aangepaste waarde door dit veld door te geven in het verzoek (optioneel).
X3-EN.png orderreference
XPath: /merchant/orderreference
Alfanumeriek, inclusief
symbolen (25)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.
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Opmerking: Dit kan op een later tijdstip worden bijgewerkt (alleen als de transactie in behandeling is afwikkeling).

Facturering

De volgende velden bevatten de factureringsgegevens van de klant:

Als een ingediend factureringsveld langer is dan de maximaal toegestane lengte (zoals aangegeven in de onderstaande tabel), wordt een veldfout geretourneerd (errorcode 30000).

  Veld Formaat Beschrijving
X3-EN.png billingpremise
XPath: /billing/premise
Alfanumeriek, inclusief
symbolen (25)
Het huisnummer of de eerste regel van het factuuradres van de klant.
X3-EN.png billingstreet
XPath: /billing/street
Alfanumeriek, inclusief
symbolen (127)
De straat die is ingevoerd voor het factuuradres van de klant.
X3-EN.png billingtown
XPath: /billing/town
Alfanumeriek, inclusief
symbolen (127)
De ingevoerde stad voor het factuuradres van de klant.
X3-EN.png billingcounty
XPath: /billing/county
Alfanumeriek, inclusief
symbolen (127)
De county ingevoerd voor het factuuradres van de klant. Voor adressen in de VS zou de staat in dit veld worden ingevuld. Geldige formaten:
  • Bij voorkeur: Code van twee karakters voor de staat, bijv. "NY".
  • Volledige naam van de staat, b.v. "New York".
X3-EN.png billingcountryiso2a
XPath: /billing/country
Alpha (2)

Het land voor het factuuradres van de klant. Dit moet in ISO2A-formaat zijn.

Klik hier voor een volledige lijst van landcodes.

X3-EN.png billingpostcode
XPath: /billing/postcode
Alfanumeriek (25)

De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend.

X3-EN.png billingemail
XPath: /billing/email
E-mail (255) Het E-mailadres facturatie adres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken).
X3-EN.png billingtelephonetype
XPath: /billing/telephone/@type
Char (1) Het type telefoonnummer. De beschikbare opties zijn:
  • H = Thuis
  • M = Mobiel
  • W = Werk
X3-EN.png billingtelephone
XPath: /billing/telephone
Alfanumeriek, inclusief
symbolen (20)
Telefoonnummer van de klant. Geldige tekens:
  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X3-EN.png billingprefixname
XPath: /billing/name/prefix
Alfanumeriek, inclusief
symbolen (25)
Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.).
X2-EN.png billingfirstname
XPath: /billing/name/first
Alfanumeriek, inclusief
symbolen (127)

De klant Voornaam facturatie.

Vereist voor handelaren in kansspelen.

X3-EN.png billingmiddlename
XPath: /billing/name/middle
Alfanumeriek, inclusief
symbolen (127)
De middelste factureringsnaam of -namen van de klant.
X2-EN.png billinglastname
XPath: /billing/name/last
Alfanumeriek, inclusief
symbolen (127)

De klant Achternaam facturatie.

Vereist voor handelaren in kansspelen.

X3-EN.png billingsuffixname
XPath: /billing/name/suffix
Alfanumeriek, inclusief
symbolen (25)
Het achtervoegsel van de factureringsnaam van de klant (bv. Bsc).
Klant en levering

De volgende velden bevatten de leveringsgegevens van de klant:

Als een ingediend klantveld langer is dan de maximaal toegestane lengte (zoals gedocumenteerd in de onderstaande tabel), wordt een veldfout geretourneerd (errorcode 30000).

  Veld Formaat Beschrijving
X3-EN.png customerpremise
XPath: /customer/premise
Alfanumeriek, inclusief
symbolen (25)
De naam of het nummer van het huis van de klant.
X3-EN.png customerstreet
XPath: /customer/street
Alfanumeriek, inclusief
symbolen (127)
De straatnaam van de klant.
X3-EN.png customertown
XPath: /customer/town
Alfanumeriek, inclusief
symbolen (127)
De stad van de klant.
X3-EN.png customercounty
XPath: /customer/county
Alfanumeriek, inclusief
symbolen (127)
De provincie van de klant. Voor adressen in de VS kan de staat in dit veld worden ingevuld. Geldige formaten:
  • Voorkeur: 2 karakters staatscode, bijv. "NY".
  • Volledige naam van de staat, b.v. "New York".
X3-EN.png customercountryiso2a
XPath: /customer/country
Alpha (2)

Het land van de klant. Dit moet in ISO2A-formaat zijn.

Klik hier voor een volledige lijst van landcodes.

X2-EN.png customerpostcode
XPath: /customer/postcode
Alfanumeriek (25)

De leveringspostcode of postcode. Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend.

Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.

X3-EN.png customeremail
XPath: /customer/email
E-mail (255) Het e-mailadres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-symbool).
X3-EN.png customertelephonetype
XPath: /customer/telephone/@type
Char (1) Het type telefoonnummer. De beschikbare opties zijn:
  • H = Thuis
  • M = Mobiel
  • W = Werk
X3-EN.png customertelephone
XPath: /customer/telephone
Alfanumeriek, inclusief
symbolen (20)
Telefoonnummer van de klant. Geldige tekens:
  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X3-EN.png customerprefixname
XPath: /customer/name/prefix
Alfanumeriek, inclusief
symbolen (25)
De prefixnaam van de klant (bijv. De heer, Juffrouw, Dr.).
X3-EN.png customerfirstname
XPath: /customer/name/first
Alfanumeriek, inclusief
symbolen (127)
De voornaam van de klant.
X3-EN.png customermiddlename
XPath: /customer/name/middle
Alfanumeriek, inclusief
symbolen (127)
De middelste naam of namen van de klant.
X2-EN.png customerlastname
XPath: /customer/name/last
Alfanumeriek, inclusief
symbolen (127)

De achternaam van de klant.

Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.

X3-EN.png customersuffixname
XPath: /customer/name/suffix
Alfanumeriek, inclusief
symbolen (25)
De achtervoegselnaam van de klant (bv. Bsc).
X3-EN.png customerforwardedip
XPath: /customer/forwardedip
IP-adres (39) Door de klant doorgestuurd IP-adres, zoals verstrekt door een proxyserver, indien beschikbaar.
X3-EN.png customerip
XPath: /customer/ip
IP-adres (39) Het IP-adres van de klant.
Afwikkeling

De volgende velden bevatten de afwikkeling details:

  Veld Formaat Beschrijving
X3-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD U kunt dit veld in het verzoek opnemen om de datum te specificeren waarop u uw transactie wilt laten afwikkelen. Dit moet binnen 7 dagen na de datum autorisatie zijn.
X3-EN.png settlestatus
XPath: /settlement/settlestatus
Numeriek (3) Een numerieke waarde die wordt gebruikt om de instructie afwikkeling te definiëren. Als u hier geen waarde opgeeft, wordt de settlestatus staat standaard op "0".

Klik voor meer informatie over het proces afwikkeling .

 

AUTH antwoord

Het volgende is een voorbeeld van een AUTH antwoord dat aangeeft dat het verzoek met succes werd verwerkt.

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionstartedtimestamp': u '2016-12-07 11:32:44',
u 'livestatus': u '0',
u 'issuer': u 'Test Issuer',
u 'splitfinalnumber': u '1',
u 'dccenabled': u '0',
u 'settleduedate': u '2016-12-07',
u 'errorcode': u '0',
u 'orderreference': u 'My_Order_123',
u 'tid': u '27882788',
u 'merchantnumber': u '00000000',
u 'merchantcountryiso2a': u 'GB',
u 'transactionreference': u '23-9-80001',
u 'merchantname': u 'Test Merchant',
u 'paymenttypedescription': u 'VISA',
u 'baseamount': u '1050',
u 'accounttypedescription': u 'MOTO',
u 'acquirerresponsecode': u '00',
u 'requesttypedescription': u 'AUTH',
u 'securityresponsesecuritycode': u '2',
u 'currencyiso3a': u 'GBP',
u 'authcode': u 'TEST36',
u 'errormessage': u 'Ok',
u 'operatorname': u 'webservices@example.com',
u 'securityresponsepostcode': u '0',
u 'maskedpan': u '411111######1111',
u 'securityresponseaddress': u '0',
u 'issuercountryiso2a': u 'US',
u 'settlestatus': u '0'
}]
}

 

Wanneer u een AUTH antwoord ontvangt, moet u de veldwaarden controleren, om er zeker van te zijn dat het verzoek met succes werd verwerkt.

Klik hier voor aanbevolen uit te voeren controles.

 

Operatie

De volgende velden hebben betrekking op het soort verzoek dat wordt ingediend:

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Het type rekening dat moet worden gebruikt:
  • "ECOM" - E-commerce.
  • "MOTOMail Order Telefoon Order
  • "RECUR" - Terugkerende transacties
X2-EN.png authmethod
XPath: /operation/authmethod
Alpha (11)

Auth-methoden worden gebruikt om aan te geven hoe een transactie door de kaartuitgever moet worden verwerkt. Elke authmethod heeft andere eisen. Klik op de volgende links voor meer informatie:

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

X2-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numeriek (1) De toegestane waarden voor dit veld zijn 0, 1 en 2.
  • "0" - Komt niet in aanmerking voor CoF, of is niet van plan de referenties op een later tijdstip opnieuw te gebruiken.
  • "1" - Transactiegegevens gemarkeerd als beschikbaar voor toekomstig gebruik.
  • "2" - Betaling met gebruik van eerder opgeslagen inloggegevens.

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

X2-EN.png cryptocurrencyindicator
XPath: /operation/cryptocurrencyindicator
Numeriek (1)

Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:

  • 1 - Transactie is gemarkeerd als aankoop van cryptocurrency.
  • 0 - Transactie is niet gemarkeerd als aankoop van cryptocurrency.

Dit veld wordt geretourneerd indien het door de overnemende bank wordt verstrekt, anders wordt het niet geretourneerd.

X2-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alfanumeriek
en koppeltekens (25)

De transactionreference van een eerder verzoek, waarvan de belangrijkste details geërfd.

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

X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) "AUTH" wordt in het antwoord teruggezonden.
X2-EN.png scaexemptionindicator
XPath: /operation/scaexemptionindicator
Numeriek (1)

Geretourneerd indien transactie is gemarkeerd als vrijgesteld van EMV 3DS. Klik hier voor meer informatie.

De volgende waarden kunnen worden teruggezonden:
1 - Lage waarde
2 - Analyse van transactierisico's
3 - Vertrouwde handelaar
4 - Beveiligde zakelijke betaling
5 - Gedelegeerde authenticatie

Facturering

De volgende velden bevatten de factureringsgegevens van de klant:

  Veld Formaat Beschrijving
X4-EN.png baseamount
XPath: /billing/amount
Numeriek (13) 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)
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

X4-EN.png dccenabled
XPath: /billing/dcc/@enabled
Numeriek (1) Geeft aan of uw account is geconfigureerd voor DCC:
1= Ja
0 = Nee
X4-EN.png issuer
XPath: /billing/payment/issuer
Alfanumeriek (255) De uitgever van de kaart van de klant.
X4-EN.png issuercountryiso2a
XPath: /billing/payment/issuercountry
Alpha (2)

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.

X4-EN.png maskedpan
XPath: /billing/payment/pan
Alfanumeriek, inclusief "#" (12-19)

Als tokenisedpayment wordt niet teruggestuurd:
De maskedpan veld staat voor het kaartnummer van de klant.

Als tokenisedpayment wordt teruggestuurd met waarde 1:
De maskedpan staat voor 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.

X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X2-EN.png tokenisedpayment
XPath: /billing/payment/pan/@tokenised
Numeriek (1)

Als dit veld wordt teruggestuurd met waarde 1, betekent dit dat de transactie is verwerkt met gebruikmaking van een token.

Dit veld wordt geretourneerd als de betaling is verricht met een token.

X2-EN.png tokentype
XPath: /billing/payment/pan/@tokentype
Alfanumeriek (50)

Wordt gebruikt om het type token te identificeren dat voor deze betaling wordt gebruikt (bv. "VISATOKEN").

Dit veld wordt geretourneerd als de betaling is verricht met een token.

X2-EN.png walletdisplayname
XPath: /billing/payment/wallet/displayname
Alfanumeriek (255)

Dit bevat gewoonlijk de laatste vier cijfers van het kaartnummer van de klant (bv. "1111").

Dit veld wordt teruggegeven als de betaling met een portemonnee is verricht.

X2-EN.png walletsource
XPath: /billing/payment/wallet/source
Alfanumeriek (20)

Wordt gebruikt om het type portemonnee te identificeren dat voor deze betaling wordt gebruikt (bijv. "APPLEPAY").

Dit veld wordt teruggegeven als de betaling met een portemonnee is verricht.

Handelaar

De volgende velden hebben betrekking op uw accountconfiguratie:

  Veld Formaat Beschrijving
X2-EN.png chargedescription
XPath: /merchant/chargedescription
Alfanumeriek, inclusief
symbolen (25)

Dit is een beschrijving van de betaling die op het bankafschrift van de klant verschijnt.

Dit wordt ondersteund voor handelaren met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, dient u contact op te nemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat u verder gaat.

De specificatie van dit veld is afhankelijk van uw wervende bank.

Klik hier voor meer informatie.

 Geldige tekens:

  • Hoofdletters/kleine letters A-Z
  • Cijfers 0-9
  • Ruimtes
  • Interpunctie: + - _ . @ ( )

Dit veld wordt teruggestuurd als het naar de wervende bank wordt gestuurd.

X4-EN.png merchantnumber
XPath: /merchant/merchantnumber
Alfanumeriek (32) Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.
X2-EN.png merchantcategorycode
XPath: /merchant/merchantcategorycode
Alfanumeriek (255)

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

merchantcity
XPath: /merchant/merchantcity
Alfanumeriek (127)
merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha (2)
merchantname
XPath: /merchant/merchantname
Alfanumeriek (255)
merchantstatecode
XPath: /merchant/merchantstatecode
Alfanumeriek (127)
merchantzipcode
XPath: /merchant/merchantzipcode
Alfanumeriek (10)
X4-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X2-EN.png orderreference
XPath: /merchant/orderreference
Alfanumeriek, inclusief
symbolen (25)

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

Opmerking: Dit kan op een later tijdstip worden bijgewerkt (alleen als de transactie in behandeling is afwikkeling).

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

X4-EN.png tid
XPath: /merchant/tid
Alfanumeriek (255) De terminal ID die gebruikt wordt om de transactie te verwerken. Dit wordt gekoppeld aan uw handelaarsnummer wanneer wij uw rekening in onze systemen instellen.
Afwikkeling

De volgende velden bevatten de afwikkeling details:

  Veld Formaat Beschrijving
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numeriek (3)

Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven.

Klik hier voor een volledige lijst van settlestatus waarden.

Verrichtingsstatus

Naast de response object, worden in het antwoord ook twee extra velden geretourneerd:

  Veld Formaat Beschrijving
X2-EN.png acquireradvicecode
XPath: /acquireradvicecode
 Numeriek (1) Een numerieke waarde die wordt geretourneerd na een verzoek om herhaalde betaling en die aangeeft of verdere betalingen kunnen worden verwerkt.

In kaart brengen:

  • 0 - Geen actie vereist.
  • 1 - Nieuwe rekeninginformatie beschikbaar.
  • 2 - Kan op dit moment niet worden goedgekeurd.
  • 4 - Verwerk geen terugkerende transacties meer.
  • 8 - Betaling geblokkeerd door kaartsysteem.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.

X2-EN.png acquirerresponsecode
XPath: /acquirerresponsecode
Alfanumeriek (255)

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.

X2-EN.png acquirerresponsemessage
XPath: /acquirerresponsemessage
Alfanumeriek (255)
X2-EN.png authcode
XPath: /authcode
Alfanumeriek (255)

De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt.

Wordt alleen geretourneerd als de transactie is toegestaan.

X4-EN.png errorcode
XPath: /error/code
Numeriek (1-5) De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
  • 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.

X2-EN.png errordata
XPath: /error/data
Alfanumeriek (255)

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

Wordt alleen geretourneerd als er een fout is opgetreden.

X4-EN.png errormessage
XPath: /error/message
Alfanumeriek (255) Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X2-EN.png retrievalreferencenumber
XPath: /other/retrievalreferencenumber
Alfanumeriek (255)

Een ISO-term. Deze wordt gebruikt om te verwijzen naar de brontransactie.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.

X4-EN.png securityresponseaddress
XPath: /security/address
Numeriek (1) Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.

X4-EN.png securityresponsepostcode
XPath: /security/postcode
Numeriek (1)
X4-EN.png securityresponsesecuritycode
XPath: /security/securitycode
Numeriek (1)
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling uit te voeren of de transactie bij te werken.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.

 

Naast de response object, worden in het antwoord ook twee extra velden geretourneerd:

  Veld Formaat Beschrijving
X4-EN.png requestreference Alfanumeriek (25) Dit is een intern veld dat wordt gegenereerd door Trust Payments. Het moet niet gevalideerd worden. Als zich problemen voordoen met het verzoek, kan dit veld worden opgevraagd door Trust Payments support om de oorzaak te helpen vaststellen.
X4-EN.png secrand Alfanumeriek (16) Willekeurige tekenreeks, teruggegeven in de respons van niet-API-gebaseerde bibliotheken ontwikkeld door Trust Payments.
Was dit artikel nuttig?
0 van de 0 vonden dit nuttig
Hebt u meer vragen? Dien een verzoek in