TRANSACTIONQUERY

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.
Lees dit artikel voor meer informatie.

Als u informatie wilt opvragen over verzoeken en transacties die u eerder hebt ingediend, kunt u een TRANSACTIONQUERY verzoek indienen.

 

Procesoverzicht

Uw systeem zal een TRANSACTIONQUERY verzoek moeten indienen bij Trust Payments. Trust Payments zal dan een antwoord terugsturen met de gevraagde informatie, als er een overeenstemmend verzoek is gevonden.

U kunt bijvoorbeeld informatie opvragen over alle transacties die zijn verwerkt op uw sitereferentie tussen 18.00 en 21.00 uur, of nagaan of een transactie al dan niet is afgewikkeld.

 

Filters

Het verzoek op TRANSACTIONQUERY bestaat voornamelijk uit filters. Beschouw filters als zoekcriteria; het antwoord dat wordt teruggestuurd zal informatie bevatten die voldoet aan de opgegeven filters.

Bijvoorbeeld een filter met orderreference "100100" geeft details van alle overeenkomende verzoeken met die referentie (als die bestaan en zijn verwerkt op uw site referentie).

En het specificeren van een starttimestamp en endtimestamp geeft details over alle verzoeken die op uw rekening zijn verwerkt tussen de gespecificeerde tijden.

  In een enkel antwoord kunnen meerdere records worden teruggestuurd

Wij raden u aan zo specifiek mogelijk te zijn in uw verzoek, door zoveel filters in te voeren als nodig, om te voorkomen dat het antwoord een te groot aantal records terugstuurt.

U kunt ook meerdere waarden opgeven voor elk gegeven filter. U kunt bijvoorbeeld een filter opgeven voor transactionreference waarden "23-9-1" en "23-9-2", en alle verzoeken die met deze waarden overeenkomen, worden in het antwoord teruggestuurd. (We geven hieronder een voorbeeld van dit geval)

 

TRANSACTIONQUERY verzoek

Om het verzoek TRANSACTIONQUERY met succes te kunnen verwerken, moet u ten minste één geldig filter indienen.

 

Voorbeeld aanvraag

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)

query = {
"requesttypedescriptions": ["TRANSACTIONQUERY"],
"filter":{
"sitereference": [{"value":"test_site12345"}],
"currencyiso3a": [{"value":"GBP"}],
"transactionreference": [{"value":"72-9-80005"},{"value":"72-9-80006"}]
}
}

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

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

 

Specificatie veld

In de volgende tabel staan alle velden die u in het filter kunt opnemen bij het verwerken van een TRANSACTIONQUERY verzoek.

  Hoewel geen van de volgende filtervelden verplicht is, moet ten minste één filter worden ingediend om het verzoek met succes te kunnen verwerken. Daarom zijn de meeste velden hieronder als voorwaardelijk gemarkeerd.

Een uitzondering op dit gedrag is de sitereference filter, dat niet alleen kan worden ingediend; het moet vergezeld gaan van ten minste één ander filter. Deze beperking wordt opgelegd om de belasting van onze servers te verminderen.

  Veld Formaat Beschrijving
X2-EN.png accounttypedescription
XPath: /filter/accounttypedescription
Alpha (20) De bron van de transactie.
  • Voor een e-commerce AUTH Request moet de waarde "ECOM" zijn.
  • Voor Mail Order Telephone Order (MOTO) aanvragen moet de waarde "MOTO" zijn.
  • Voor een terugkerende transactie moet de waarde "RECUR" zijn.
X2-EN.png billingemail
XPath: /filter/billingemail
E-mail (255)

Het E-mailadres facturatie adres van de klant.

Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-symbool).

X2-EN.png billingfirstname
XPath: /filter/billingfirstname
Alfanumeriek, inclusief symbolen (127) De klant Voornaam facturatie.
X2-EN.png billinglastname
XPath: /filter/billinglastname
Alfanumeriek, inclusief symbolen (127) De klant Achternaam facturatie.
X2-EN.png billingpostcode
XPath: /filter/billingpostcode
Alfanumeriek, inclusief symbolen (25) De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend.
X2-EN.png billingpremise
XPath: /filter/billingpremise
Alfanumeriek, inclusief symbolen (20) Het nummer of de naam van het gebouw van het factuuradres van de klant.
X2-EN.png billingstreet
XPath: /filter/billingstreet
Alfanumeriek, inclusief symbolen (20) De straatnaam van het factuuradres van de klant.
X2-EN.png completiontimestamp
XPath: /filter/completiontimestamp
Datum Tijd JJJJ-MM-DD HH:MM:SS Dit is het geval wanneer een pre-auth van een betaalautomaat zonder geld dat momenteel gepland is voor afwikkeling wordt bijgewerkt om afwikkeling mogelijk te maken, door een verzoek tot voltooiing uit te voeren.
X2-EN.png currencyiso3a
XPath: /filter/currencyiso3a
Alpha (3)

De transactie Munt.

Klik hier voor een volledige lijst van Munt codes.

X2-EN.png customerip
XPath: /filter/customerip
IP-adres (39) Het IP-adres van de klant.
X2-EN.png endtimestamp
XPath: /filter/endtimestamp
Datum Tijd JJJJ-MM-DD HH:MM:SS Alleen verzoeken die vóór de opgegeven tijdstempel zijn verwerkt, worden geretourneerd.

(In tegenstelling tot andere filters kunt u slechts één endtimestamp in een verzoek)

X2-EN.png orderreference
XPath: /filter/orderreference
Alfanumeriek, inclusief symbolen (25) Uniek referentienummer verstrekt door de handelaar voor het verzoek.
X2-EN.png pan
XPath: /filter/pan
Numeriek (12-19) Dit is het kaartnummer dat op de voorkant van de kaart van de klant staat.
X2-EN.png parenttransactionreference
XPath: /filter/parenttransactionreference
Alfanumeriek, inclusief koppeltekens (25) Unieke referentie van het bovengeschikte verzoek.
X2-EN.png paymenttypedescription
XPath: /filter/paymenttypedescription
Alpha (20) Het type kaart van de klant (bijv. "VISA" of "MASTERCARD").
X2-EN.png requesttypedescription
XPath: /filter/requesttypedescription
Alpha (20)

De Verzoektype die bij de transactie hoort. Bijvoorbeeld "AUTH" of "REFUND".

Klik hier voor een volledige lijst van soorten verzoeken.

X3-EN.png sitereference
XPath: /filter/sitereference
Alfa (50)

De sitereferentie die de transactie heeft verwerkt.

De sitereference filter moet worden ingediend met ten minste één ander filter, anders wordt een foutmelding gegeven.

X2-EN.png starttimestamp
XPath: /filter/starttimestamp
Datum Tijd JJJJ-MM-DD HH:MM:SS Alleen verzoeken die na de opgegeven tijdstempel zijn verwerkt, worden geretourneerd.

(In tegenstelling tot andere filters kunt u slechts één starttimestamp in een verzoek)

X2-EN.png transactionreference
XPath: /filter/transactionreference
Alfanumeriek, inclusief koppeltekens (25) De unieke referentie in verband met de transactie, toegewezen door Trust Payments.

Alleen de bovenstaande filters kunnen worden ingediend. Als een opgegeven filter niet exact overeenkomt met een van de hierboven ondersteunde waarden, wordt het niet gebruikt om de zoekopdracht uit te voeren. Daarom is het belangrijk dat u ervoor zorgt dat alle filters correct zijn gespeld en dat u uw oplossing grondig test om te garanderen dat de verwachte records worden geretourneerd.

 

TRANSACTIONQUERY antwoord

Als u met succes een TRANSACTIONQUERY verzoek hebt ingediend, krijgt u een antwoord terug dat verdeeld is in afzonderlijke records.

Elke record zal een wisselend aantal antwoordvelden bevatten, die afhangen van de Verzoektype die in de record is aangegeven. Als de record bijvoorbeeld een requesttypedescription van "AUTH", dan moet u verwijzen naar de veldspecificatie in de autorisatie.

Bovendien bevat het antwoord een veld genaamd found, die het aantal records aangeeft dat overeenkomt met de in het verzoek gespecificeerde filters. Als found de waarde "0" heeft, zijn er geen records gevonden met de door u opgegeven filters.

Hier is bijvoorbeeld een vereenvoudigd voorbeeld van de structuur van het antwoord, bestaande uit 2 records (beide zijn van het type "AUTH"):

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'W72-pg3q2he9',
u 'version': u '1.00',
u 'responses': [{
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'found': u '2',
u 'records': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST22',
u 'baseamount': u '1050',
u 'cavv': u 'dHJ1c3RwYXltZW50c2F1dGhlbnQ',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'expirydate': u '10/2022',
u 'fraudrating': u '0',
u 'interface': u 'PASS-JSON-JSON',
u 'issuer': u 'SecureTrading Test Issuer1',
u 'issuercountryiso2a': u 'US',
u 'livestatus': u '0',
u 'maskedpan': u '411111######1111',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '2',
u 'settlebaseamount': u '1050',
u 'settleduedate': u '2019-12-17',
u 'settlestatus': u '0',
u 'sitereference': u 'test_site12345',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '72-9-80005',
u 'transactionstartedtimestamp': u '2019-12-17 09:35:03'
}, {
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST03',
u 'baseamount': u '1050',
u 'cavv': u 'dHJ1c3RwYXltZW50c2F1dGhlbnR',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'expirydate': u '10/2022',
u 'fraudrating': u '0',
u 'interface': u 'PASS-JSON-JSON',
u 'issuer': u 'SecureTrading Test Issuer1',
u 'issuercountryiso2a': u 'US',
u 'livestatus': u '0',
u 'maskedpan': u '411111######1111',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '2',
u 'settlebaseamount': u '1050',
u 'settleduedate': u '2019-12-17',
u 'settlestatus': u '0',
u 'sitereference': u 'test_site12345',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '72-9-80006',
u 'transactionstartedtimestamp': u '2019-12-17 09:35:10'
}],
u 'requesttypedescription': u 'TRANSACTIONQUERY',
u 'transactionstartedtimestamp': u '2019-12-17 09:36:21'
}]
}

  Per antwoord kunnen maximaal 500 records worden teruggestuurd.

De found veld zal nooit een waarde hoger dan 500 opleveren, ook al voldoen meer dan 500 verzoeken aan de gespecificeerde criteria.

 

Fouten begrijpen

Zorg ervoor dat u de Foutcode (errorcode)s in het antwoord:

  • Op het hoogste niveau van de respons, samen met transactionstartedtimestamp en found, is er een errorcode. Dit geeft aan of het TRANSACTIONQUERY verzoek al dan niet succesvol was. Als de Foutcode hier niet "0" is, was het TRANSACTIONQUERY verzoek niet succesvol. U moet het probleem aanpakken en het opnieuw proberen.
  • Bovendien is elke record zullen hun eigen errorcode. Dit geeft aan of het verzoek in de record al dan niet succesvol was.
  • Voor een volledige lijst van foutcodes (errorcode) gebruikt door Trust Payments, klik hier.

 

Specificatie veld

In de volgende tabel staan alle velden die in een gegeven record.

Velden worden alleen geretourneerd als de gegevens beschikbaar zijn voor het opgevraagde verzoek.
Dit kan variëren afhankelijk van Verzoektype.

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /record/operation/accounttypedescription
Alpha (20) Het type rekening dat wordt gebruikt om het opgevraagde verzoek te verwerken:
  • "ECOM" - E-commerce.
  • "MOTOMail Order Telefoon Order
  • "RECUR" - Terugkerende transacties
X2-EN.png

acquireradvicecode
XPath: /record/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.

Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.

X2-EN.png

acquirerresponsecode
XPath: /record/acquirerresponsecode

Alfanumeriek (255)

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

Of deze velden worden teruggestuurd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.

X2-EN.png

acquirerresponsemessage
XPath: /record/acquirerresponsemessage

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

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

Wordt alleen geretourneerd indien de opgevraagde transactie werd geautoriseerd.

X2-EN.png authmethod
XPath: /record/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:

Wordt alleen geretourneerd wanneer een authmethod waarde aan het verzoek is toegekend.

X4-EN.png baseamount
XPath: /record/billing/amount
Numeriek (13) Het bedrag van de opgevraagde transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt ingediend als 1000.
X2-EN.png billingcountryiso2a
XPath: /record/billing/country
Alpha (2)

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

Klik hier voor een volledige lijst van landcodes.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingcounty
XPath: /record/billing/county
Alfanumeriek, inclusief
symbolen (127)

De county die is ingevoerd voor het factuuradres van de klant. Voor Amerikaanse adressen wordt de staat hier teruggegeven in een formaat van 2 tekens (bijv. "NY").

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingemail
XPath: /record/billing/email
E-mail (255)

Het E-mailadres facturatie adres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingfirstname
XPath: /record/billing/name/first
Alfanumeriek, inclusief
symbolen (127)

De klant Voornaam facturatie.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billinglastname
XPath: /record/billing/name/last
Alfanumeriek, inclusief
symbolen (127)

De klant Achternaam facturatie.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingmiddlename
XPath: /record/billing/name/middle
Alfanumeriek, inclusief
symbolen (127)

De middelste factureringsnaam of -namen van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

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

De postcode die is ingevoerd voor het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingprefixname
XPath: /record/billing/name/prefix
Alfanumeriek, inclusief
symbolen (25)

Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.).

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingpremise
XPath: /record/billing/premise
Alfanumeriek, inclusief
symbolen (25)

Het huisnummer of de eerste regel van het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingstreet
XPath: /record/billing/street
Alfanumeriek, inclusief
symbolen (127)

De straat die is ingevoerd voor het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingsuffixname
XPath: /record/billing/name/suffix
Alfanumeriek, inclusief
symbolen (25)

Het achtervoegsel van de factureringsnaam van de klant (bv. Bsc).

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingtelephone
XPath: /record/billing/telephone
Alfanumeriek, inclusief
symbolen (20)

Het telefoonnummer van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingtelephonetype
XPath: /record/billing/telephone/@type
Char (1) Het type telefoonnummer. De beschikbare opties zijn:
  • H = Thuis
  • M = Mobiel
  • W = Werk

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png billingtown
XPath: /record/billing/town
Alfanumeriek, inclusief
symbolen (127)

De ingevoerde stad voor het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png cavv
XPath: /record/threedsecure/cavv
Alfanumeriek (56)

De unieke Cardholder Authentication Verification Value (CAVV) geassocieerd met de transactie.

Dit veld wordt teruggegeven indien het beschikbaar is.

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

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

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png credentialsonfile
XPath: /record/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.

Wordt alleen geretourneerd wanneer een credentialsonfile waarde is toegekend aan het verzoek.

X4-EN.png currencyiso3a
XPath: /record/billing/amount/@currencycode
Alpha (3)

De Munt van de opgevraagde transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

X2-EN.png customercountryiso2a
XPath: /record/customer/country
Alpha (2)

Het land voor het leveringsadres van de klant in ISO2A-formaat.

Klik hier voor een volledige lijst van landcodes.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customercounty
XPath: /record/customer/county
Alfanumeriek, inclusief
symbolen (127)

De county ingevoerd voor het leveringsadres van de klant. Voor Amerikaanse adressen wordt de staat hier teruggegeven in een formaat van 2 tekens (bijv. "NY").

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customeremail
XPath: /record/customer/email
E-mail (255)

Het e-mailadres van de klant voor aflevering.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customerfirstname
XPath: /record/customer/name/first
Alfanumeriek, inclusief
symbolen (127)

De leverings voornaam van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X4-EN.png customerip
XPath: /record/customer/ip
IP-adres (39) Het IP-adres van de klant.
X2-EN.png customerlastname
XPath: /record/customer/name/last
Alfanumeriek, inclusief
symbolen (127)

De achternaam van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customermiddlename
XPath: /record/customer/name/middle
Alfanumeriek, inclusief
symbolen (127)

De middelste naam van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

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

De ingevoerde postcode van het afleveradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customerprefixname
XPath: /record/customer/name/prefix
Alfanumeriek, inclusief
symbolen (25)

Het voorvoegsel van de leveringsnaam van de klant (bv. De heer, Juffrouw, Dr.).

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customerpremise
XPath: /record/customer/premise
Alfanumeriek, inclusief
symbolen (25)

Het huisnummer of de eerste regel van het afleveradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customerstreet
XPath: /record/customer/street
Alfanumeriek, inclusief
symbolen (127)

De ingevoerde straat voor het afleveradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customersuffixname
XPath: /record/customer/name/suffix
Alfanumeriek, inclusief
symbolen (25)

Het achtervoegsel van de leveringsnaam van de klant (bv. Bsc).

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customertelephone
XPath: /record/customer/telephone
Alfanumeriek, inclusief
symbolen (20)

Het telefoonnummer van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customertelephonetype
XPath: /record/customer/telephone/@type
Char (1) Het type telefoonnummer. De beschikbare opties zijn:
  • H = Thuis
  • M = Mobiel
  • W = Werk

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png customertown
XPath: /record/customer/town
Alfanumeriek, inclusief
symbolen (127)

De ingevoerde stad voor het leveringsadres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png dccenabled
XPath: /record/billing/dcc/@enabled
Numeriek (1)

Geeft aan of uw account is geconfigureerd voor DCC:
1= Ja
0 = Nee

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png debtrepayment
XPath: /record/merchant/debtrepayment
Numeriek (1)

Geeft aan of de transactie is gemarkeerd als schuldaflossing:

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

Klik hier voor meer informatie.

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png eci
XPath: /record/threedsecure/eci
Alfanumeriek (2)

Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie.

Klik hier voor meer informatie over mogelijke ECI waarden.

X2-EN.png enrolled
XPath: /record/threedsecure/enrolled
Char (1)

Geeft aan of de kaart van de klant al dan niet is ingeschreven in een 3-D Secure regeling.

Klik hier voor meer informatie.

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

X2-EN.png expirydate
XPath: /record/billing/payment/expirydate
Datum MM/JJJJ

De op de kaart gedrukte vervaldatum.

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png fraudrating
XPath: /record/fraud/rating
Numeriek (2)

Dit veld heeft betrekking op onze interne fraudecontroles, zoals gedocumenteerd in dit artikel. Deze waarde vertegenwoordigt de momenteel toegewezen frauderating van de opgevraagde transactie.

Deze functie is opt-in. Indien niet ingeschakeld op uw sitereferentie, wordt altijd 0 teruggestuurd.

Als u zich heeft aangemeld:

  • -1 geeft aan dat er controles in behandeling zijn.
  • Hoe hoger de frauderating, hoe groter het aantal verdachte kenmerken dat door ons fraudesysteem is vastgesteld.
  • Standaard brengen wij u op de hoogte van transacties met een frauderating van 2 of hoger.
  • Standaard schorten wij alle transacties op die een frauderating van 5 of hoger hebben.

Klik hier voor meer informatie.

Alleen teruggestuurd voor kaarttransacties.

X4-EN.png interface
XPath: /record/operation/interface
Alfanumeriek, inclusief symbolen (50)

Vertegenwoordigt de interface via welke het opgevraagde verzoek werd verwerkt. De volgende zijn gangbare voorbeelden:

  • "JWT-JWT-JWT" - JavaScript Library of Mobile SDK.
  • "MYST" - MyST (bijvoorbeeld Refund, Virtuele terminal of Betalingsterminal).
  • "PASS-JSON-JSON" - Webservices API met behulp van JSON opmaak.
  • "PASS-XML-XML" - Webservices API met behulp van XML-opmaak.
X2-EN.png issuer
XPath: /record/billing/payment/issuer
Alfanumeriek (255)

De uitgever van de kaart van de klant.

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png issuercountryiso2a
XPath: /record/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.

Alleen teruggestuurd voor kaarttransacties.

X4-EN.png livestatus
XPath: /record/live
Numeriek (1)
  • 0 - De opgevraagde transactie is verwerkt met een testrekening.
  • 1 - De opgevraagde transactie is verwerkt met een live-rekening.
X2-EN.png

maskedpan
XPath: /record/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 opgevraagde 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.

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png merchantcategorycode
XPath: /record/merchant/merchantcategorycode
Alfanumeriek (255)

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

merchantcity
XPath: /record/merchant/merchantcity
Alfanumeriek (127)
merchantcountryiso2a
XPath: /record/merchant/merchantcountryiso2a
Alpha (2)
merchantname
XPath: /record/merchant/merchantname
Alfanumeriek (255)
merchantstatecode
XPath: /record/merchant/merchantstatecode
Alfanumeriek (127)
merchantzipcode
XPath: /record/merchant/merchantzipcode
Alfanumeriek (10)
X4-EN.png operatorname
XPath: /record/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: /record/merchant/orderreference
Alfanumeriek, inclusief
symbolen (25)

De unieke referentie bestelling voor het opgevraagde verzoek die is opgeslagen op het Trust Payments systeem.

Dit veld wordt teruggegeven indien het beschikbaar is.

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

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

Dit veld wordt teruggegeven indien het beschikbaar is.

X4-EN.png paymenttypedescription
XPath: /record/billing/payment/@type
Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X4-EN.png requesttypedescription
XPath: /record/@type
Alpha (20) Het type verzoek dat in de record wordt teruggestuurd.
X2-EN.png retrievalreferencenumber
XPath: /record/other/retrievalreferencenumber
Alfanumeriek (255)

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

Dit veld wordt geretourneerd indien beschikbaar. Dit hangt af van uw wervende bank. Neem contact op met uw bank voor meer informatie.

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

Wordt geretourneerd als de opgevraagde 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

X2-EN.png securityresponseaddress
XPath: /record/security/address
Numeriek (1)

Het resultaat van AVS en beveiligingscodecontroles. Deze bevatten een van de volgende waarden:

  • 0 - Acquirer heeft geen informatie gekregen die nodig is om deze controle uit te voeren.
  • 1 - De aankoper kan de verstrekte informatie niet controleren.
  • 2 - De door de klant verstrekte informatie komt overeen met de gegevens van de kaartuitgever.
  • 4 - De door de klant verstrekte informatie komt NIET overeen met de gegevens van de kaartuitgever.

Klik hier voor meer informatie.

Deze velden worden teruggegeven indien ze beschikbaar zijn.

X2-EN.png securityresponsepostcode
XPath: /record/security/postcode
Numeriek (1)
X2-EN.png securityresponsesecuritycode
XPath: /record/security/securitycode
Numeriek (1)
X4-EN.png settlebaseamount
XPath: /record/settlement/settlebaseamount
Numeriek (13)

De waarde van het te vereffenen bedrag. Het verrekende bedrag kan worden bijgewerkt om lager te zijn dan het oorspronkelijk toegestane bedrag met een TRANSACTIONUPDATE verzoek.

X4-EN.png settleduedate
XPath: /record/settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de opgevraagde transactie zal worden afgewikkeld.
X2-EN.png settledtimestamp
XPath: /record/settlement/settledtimestamp
Datum tijd JJJJ-MM-DD hh:mm:ss

De datum en tijd waarop de opgevraagde transactie is afgewikkeld.

Wordt alleen geretourneerd als de transactie is afgewikkeld.

X4-EN.png settlestatus
XPath: /record/settlement/settlestatus
Numeriek (3)

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

Klik hier voor een volledige lijst van settlestatus waarden.

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

De sitereferentie via welke het opgevraagde verzoek is verwerkt.

X2-EN.png splitfinalnumber
XPath: /operation/splitfinalnumber
Numeriek (2)

Totaal aantal toegestane splitsingen.

Als u geen Gesplitste zending uitvoert, wordt dit teruggestuurd als 1.

Klik hier voor meer informatie over Split shipment.

Alleen teruggestuurd voor kaarttransacties.

X2-EN.png stan
XPath: /record/other/stan
ISO 8583

Het STAN (System Trace Audit Number) dat bij de transactie hoort. Dit volgt de ISO 8583-norm.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png status
XPath: /record/threedsecure/status
Char (1)

Geeft aan of de klant al dan niet op de ACS van de kaartuitgever werd geauthenticeerd.

Klik hier voor meer informatie.

X2-EN.png threedversion
XPath: /record/threedsecure/version
Numeriek (6)

Versie van 3-D Secure gebruikt om de betaling te authenticeren. (bijv. "2.1.0")

X2-EN.png tid
XPath: /record/merchant/tid
Alfanumeriek (255)

De terminal ID die wordt gebruikt om de opgevraagde transactie te verwerken. Dit is gekoppeld aan uw handelaarsnummer toen wij uw rekening in onze systemen instelden.

Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.

X2-EN.png tokenisedpayment
XPath: /record/billing/payment/pan/@tokenised
Numeriek (1)

Als dit veld de waarde 1 heeft, betekent dit dat de opgevraagde transactie met een token is verwerkt.

Dit veld wordt teruggegeven indien het beschikbaar is.

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

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

Dit veld wordt teruggegeven indien het beschikbaar is.

X4-EN.png transactionreference
XPath: /record/transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de opgevraagde 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: /record/timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de opgevraagde transactie werd verwerkt.
X2-EN.png updatereason
XPath: /record/settlement/updatereason
Alfanumeriek (255)

De meest recente partij die een bijwerking van de geretourneerde transactie heeft uitgevoerd. Als de transactie nooit is bijgewerkt nadat het eerste verzoek was verzonden, wordt dit veld niet ingevuld. Bekende voorbeelden:

  • De gebruikersnaam van de gebruiker die de update heeft uitgevoerd.
  • "rulemanager" - De transactie werd bijgewerkt door onze Regelbeheer.
  • "securitypolicy" - De transactie is bijgewerkt volgens de veiligheidsbeleid op uw rekening.
  • "settle" - De transactie werd bijgewerkt door onze afwikkeling motor.
  • "duplicate" - De transactie werd beschouwd als een duplicaat en opgeschort door onze dubbele controles.

Dit veld wordt teruggegeven indien het beschikbaar is.

X2-EN.png walletdisplayname
XPath: /record/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 indien het beschikbaar is.

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

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

Dit veld wordt teruggegeven indien het beschikbaar is.

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