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
#!/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
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => 'webservices@example.com',
'password' => 'Password1^',
);
$requestData = array(
'requesttypedescriptions' => array('TRANSACTIONQUERY'),
'filter' => array(
'sitereference' => array(array('value' => 'test_site12345')),
'currencyiso3a' => array(array('value' => 'GBP')),
'transactionreference' => array(array('value' => '72-9-80005'),array('value' => '72-9-80006'))
)
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias": "webservices@example.com",
"version": "1.00",
"request": [{
"requesttypedescriptions": ["TRANSACTIONQUERY"],
"filter":{
"sitereference": [{"value":"test_site12345"}],
"currencyiso3a": [{"value":"GBP"}],
"transactionreference": [{"value":"72-9-80005"},{"value":"72-9-80006"}]
}
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"requesttypedescriptions":["TRANSACTIONQUERY"],
"filter":{
"sitereference":[{"value":"test_site12345"}],
"currencyiso3a":[{"value":"GBP"}],
"transactionreference":[{"value":"72-9-80005"},{"value":"72-9-80006"}]
}
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="TRANSACTIONQUERY">
<filter>
<sitereference>test_site12345</sitereference>
<currencyiso3a>GBP</currencyiso3a>
<transactionreference>72-9-80005</transactionreference>
<transactionreference>72-9-80006</transactionreference>
</filter>
</request>
</requestblock>
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 | |
accounttypedescription XPath: /filter/accounttypedescription |
Alpha (20) |
De bron van de transactie.
|
|
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). |
|
billingfirstname XPath: /filter/billingfirstname |
Alfanumeriek, inclusief symbolen (127) | De klant Voornaam facturatie. | |
billinglastname XPath: /filter/billinglastname |
Alfanumeriek, inclusief symbolen (127) | De klant Achternaam facturatie. | |
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. | |
billingpremise XPath: /filter/billingpremise |
Alfanumeriek, inclusief symbolen (20) | Het nummer of de naam van het gebouw van het factuuradres van de klant. | |
billingstreet XPath: /filter/billingstreet |
Alfanumeriek, inclusief symbolen (20) | De straatnaam van het factuuradres van de klant. | |
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. | |
currencyiso3a XPath: /filter/currencyiso3a |
Alpha (3) |
De transactie Munt. Klik hier voor een volledige lijst van Munt codes. |
|
customerip XPath: /filter/customerip |
IP-adres (39) | Het IP-adres van de klant. | |
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) |
|
orderreference XPath: /filter/orderreference |
Alfanumeriek, inclusief symbolen (25) | Uniek referentienummer verstrekt door de handelaar voor het verzoek. | |
pan XPath: /filter/pan |
Numeriek (12-19) | Dit is het kaartnummer dat op de voorkant van de kaart van de klant staat. | |
parenttransactionreference XPath: /filter/parenttransactionreference |
Alfanumeriek, inclusief koppeltekens (25) | Unieke referentie van het bovengeschikte verzoek. | |
paymenttypedescription XPath: /filter/paymenttypedescription |
Alpha (20) | Het type kaart van de klant (bijv. "VISA" of "MASTERCARD"). | |
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. |
|
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. |
|
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) |
|
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"):
{
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'
}]
}
array(3) {
["requestreference"] => string(9) "W72-pg3q2he9"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(6) {
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["found"] => string(1) "2"
["records"] => array(2) {
[0] => array(37) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST22"
["baseamount"] => string(4) "1050"
["cavv"] => string(27) "dHJ1c3RwYXltZW50c2F1dGhlbnQ"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["eci"] => string(2) "05"
["enrolled"] => string(1) "Y"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["expirydate"] => string(7) "10/2022"
["fraudrating"] => string(1) "0"
["interface"] => string(14) "PASS-JSON-JSON"
["issuer"] => string(26) "SecureTrading Test Issuer1"
["issuercountryiso2a"] => string(2) "US"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "411111######1111"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["operatorname"] => string(23) "webservices@example.com"
["paymenttypedescription"] => string(4) "VISA"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "2"
["settlebaseamount"] => string(4) "1050"
["settleduedate"] => string(10) "2019-12-17"
["settlestatus"] => string(1) "0"
["sitereference"] => string(14) "test_site12345"
["splitfinalnumber"] => string(1) "1"
["status"] => string(1) "Y"
["threedversion"] => string(5) "2.2.0"
["tid"] => string(8) "27882788"
["transactionreference"] => string(10) "72-9-80005"
["transactionstartedtimestamp"] => string(19) "2019-12-17 09:35:03"
}
[1] => array(37) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST03"
["baseamount"] => string(4) "1050"
["cavv"] => string(27) "dHJ1c3RwYXltZW50c2F1dGhlbnR"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["eci"] => string(2) "05"
["enrolled"] => string(1) "Y"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["expirydate"] => string(7) "10/2022"
["fraudrating"] => string(1) "0"
["interface"] => string(14) "PASS-JSON-JSON"
["issuer"] => string(26) "SecureTrading Test Issuer1"
["issuercountryiso2a"] => string(2) "US"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "411111######1111"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["operatorname"] => string(23) "webservices@example.com"
["paymenttypedescription"] => string(4) "VISA"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "2"
["settlebaseamount"] => string(4) "1050"
["settleduedate"] => string(10) "2019-12-17"
["settlestatus"] => string(1) "0"
["sitereference"] => string(14) "test_site12345"
["splitfinalnumber"] => string(1) "1"
["status"] => string(1) "Y"
["threedversion"] => string(5) "2.2.0"
["tid"] => string(8) "27882788"
["transactionreference"] => string(10) "72-9-80006"
["transactionstartedtimestamp"] => string(19) "2019-12-17 09:35:10"
}
}
["requesttypedescription"] => string(16) "TRANSACTIONQUERY"
["transactionstartedtimestamp"] => string(19) "2019-12-17 09:36:21"
}
}
}
{"requestreference":"W72-pg3q2he9",
"version":"1.00",
"response":[{
"errorcode":"0",
"errormessage":"Ok",
"found":"2",
"records":[{
"accounttypedescription":"ECOM",
"acquirerresponsecode":"00",
"authcode":"TEST22",
"baseamount":"1050",
"cavv":"dHJ1c3RwYXltZW50c2F1dGhlbnQ",
"currencyiso3a":"GBP",
"dccenabled":"0",
"debtrepayment":"0",
"eci":"05",
"enrolled":"Y",
"errorcode":"0",
"errormessage":"Ok",
"expirydate":"10\/2022",
"fraudrating":"0",
"interface":"PASS-JSON-JSON",
"issuer":"SecureTrading Test Issuer1",
"issuercountryiso2a":"US",
"livestatus":"0",
"maskedpan":"411111######1111",
"merchantcountryiso2a":"GB",
"merchantname":"Test Merchant",
"operatorname":"webservices@example.com",
"paymenttypedescription":"VISA",
"requesttypedescription":"AUTH",
"securityresponseaddress":"0",
"securityresponsepostcode":"0",
"securityresponsesecuritycode":"2",
"settlebaseamount":"1050",
"settleduedate":"2019-12-17",
"settlestatus":"0",
"sitereference":"test_site12345",
"splitfinalnumber":"1",
"status":"Y",
"threedversion":"2.2.0",
"tid":"27882788",
"transactionreference":"72-9-80005",
"transactionstartedtimestamp":"2019-12-17 09:35:03"
},
{
"accounttypedescription":"ECOM",
"acquirerresponsecode":"00",
"authcode":"TEST03",
"baseamount":"1050",
"cavv":"dHJ1c3RwYXltZW50c2F1dGhlbnR",
"currencyiso3a":"GBP",
"dccenabled":"0",
"debtrepayment":"0",
"eci":"05",
"enrolled":"Y",
"errorcode":"0",
"errormessage":"Ok",
"expirydate":"10\/2022",
"fraudrating":"0",
"interface":"PASS-JSON-JSON",
"issuer":"SecureTrading Test Issuer1",
"issuercountryiso2a":"US",
"livestatus":"0",
"maskedpan":"411111######1111",
"merchantcountryiso2a":"GB",
"merchantname":"Test Merchant",
"operatorname":"webservices@example.com",
"paymenttypedescription":"VISA",
"requesttypedescription":"AUTH",
"securityresponseaddress":"0",
"securityresponsepostcode":"0",
"securityresponsesecuritycode":"2",
"settlebaseamount":"1050",
"settleduedate":"2019-12-17",
"settlestatus":"0",
"sitereference":"test_site12345",
"splitfinalnumber":"1",
"status":"Y",
"threedversion":"2.2.0",
"tid":"27882788",
"transactionreference":"72-9-80006",
"transactionstartedtimestamp":"2019-12-17 09:35:10"
}],
"requesttypedescription":"TRANSACTIONQUERY",
"transactionstartedtimestamp":"2019-12-17 09:36:21"
}],
"secrand":"uISZfw8wKWR"
}
<responseblock version="3.67">
<requestreference>Xv18xwv52</requestreference>
<response type="TRANSACTIONQUERY">
<error>
<code>0</code>
<message>Ok</message>
</error>
<found>2</found>
<record type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>TEST35</authcode>
<billing>
<amount currencycode="GBP">1050</amount>
<dcc enabled="0"/>
<payment type="VISA">
<expirydate>10/2022</expirydate>
<issuer>SecureTrading Test Issuer1</issuer>
<issuercountry>US</issuercountry>
<pan>411111######1111</pan>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<fraud>
<rating>0</rating>
</fraud>
<live>0</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<operatorname>webservices@example.com</operatorname>
<tid>27882788</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<interface>CERT-XML-XML</interface>
<sitereference>test_site12345</sitereference>
<splitfinalnumber>1</splitfinalnumber>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>2</securitycode>
</security>
<settlement>
<settlebaseamount>1050</settlebaseamount>
<settleduedate>2019-12-17</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<cavv>dHJ1c3RwYXltZW50c2F1dGhlbnQ</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<threedversion>2.2.0</threedversion>
</threedsecure>
<timestamp>2019-12-17 09:17:58</timestamp>
<transactionreference>72-9-80005</transactionreference>
</record>
<record type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>TEST06</authcode>
<billing>
<amount currencycode="GBP">1050</amount>
<dcc enabled="0"/>
<payment type="VISA">
<expirydate>10/2022</expirydate>
<issuer>SecureTrading Test Issuer1</issuer>
<issuercountry>US</issuercountry>
<pan>411111######1111</pan>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<fraud>
<rating>0</rating>
</fraud>
<live>0</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<operatorname>webservices@example.com</operatorname>
<tid>27882788</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<interface>CERT-XML-XML</interface>
<sitereference>test_site12345</sitereference>
<splitfinalnumber>1</splitfinalnumber>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>2</securitycode>
</security>
<settlement>
<settlebaseamount>1050</settlebaseamount>
<settleduedate>2019-12-17</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<cavv>dHJ1c3RwYXltZW50c2F1dGhlbnR</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<threedversion>2.2.0</threedversion>
</threedsecure>
<timestamp>2019-12-17 09:19:00</timestamp>
<transactionreference>72-9-80006</transactionreference>
</record>
<timestamp>2019-12-17 09:19:00</timestamp>
</response>
<secrand>IDBpVj</secrand>
</responseblock>
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 | |
accounttypedescription XPath: /record/operation/accounttypedescription |
Alpha (20) |
Het type rekening dat wordt gebruikt om het opgevraagde verzoek te verwerken:
|
|
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:
Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft. |
|
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. |
|
acquirerresponsemessage |
Alfanumeriek (255) | ||
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. |
|
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. |
|
baseamount XPath: /record/billing/amount |
Numeriek (13) | Het bedrag van de opgevraagde transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt geretourneerd als 1000. | |
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. |
|
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. |
|
billingemail XPath: /record/billing/email |
E-mail (255) |
Het E-mailadres facturatie adres van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
billingfirstname XPath: /record/billing/name/first |
Alfanumeriek, inclusief symbolen (127) |
De klant Voornaam facturatie. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
billinglastname XPath: /record/billing/name/last |
Alfanumeriek, inclusief symbolen (127) |
De klant Achternaam facturatie. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
billingtelephone XPath: /record/billing/telephone |
Alfanumeriek, inclusief symbolen (20) |
Het telefoonnummer van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
billingtelephonetype XPath: /record/billing/telephone/@type |
Char (1) |
Het type telefoonnummer. De beschikbare opties zijn:
Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. |
|
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. |
|
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. |
|
credentialsonfile XPath: /record/operation/credentialsonfile |
Numeriek (1) |
De toegestane waarden voor dit veld zijn 0, 1 en 2.
Wordt alleen geretourneerd wanneer een credentialsonfile waarde is toegekend aan het verzoek. |
|
currencyiso3a XPath: /record/billing/amount/@currencycode |
Alpha (3) |
De Munt van de opgevraagde transactie. Klik hier voor een volledige lijst van beschikbare munteenheden. |
|
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. |
|
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. |
|
customeremail XPath: /record/customer/email |
E-mail (255) |
Het e-mailadres van de klant voor aflevering. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
customerfirstname XPath: /record/customer/name/first |
Alfanumeriek, inclusief symbolen (127) |
De leverings voornaam van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
customerip XPath: /record/customer/ip |
IP-adres (39) | Het IP-adres van de klant. | |
customerlastname XPath: /record/customer/name/last |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
customermiddlename XPath: /record/customer/name/middle |
Alfanumeriek, inclusief symbolen (127) |
De middelste naam van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
customerpostcode XPath: /record/customer/postcode |
Alfanumeriek (25) |
De ingevoerde postcode van het afleveradres van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. |
|
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. |
|
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. |
|
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. |
|
customertelephone XPath: /record/customer/telephone |
Alfanumeriek, inclusief symbolen (20) |
Het telefoonnummer van de klant. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
customertelephonetype XPath: /record/customer/telephone/@type |
Char (1) |
Het type telefoonnummer. De beschikbare opties zijn:
Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. |
|
dccbaseamount XPath: /record/factuur/dcc/bedrag |
Numeriek (13) |
Voor DCC is dit het bedrag in de Munt van de verkoper. Dit wordt geretourneerd in basiseenheden, zonder komma's of decimalen, dus £10 wordt geretourneerd als 1000. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
dccenabled XPath: /record/billing/dcc/@enabled |
Numeriek (1) |
Geeft aan of uw account is geconfigureerd voor DCC: Alleen teruggestuurd voor kaarttransacties. |
|
dcccurrencyiso3a XPath: /record/factuur/dcc/bedrag/@valutacode |
Alpha (3) |
Voor DCC is dit de Munt van de verkoper in iso3a formaat. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
dccconversionrate XPath: /record/factuur/dcc/conversiesnelheid |
Numeriek (255) |
Voor DCC is dit de omrekeningskoers die wordt gebruikt om het bedrag op Munt van de klant te berekenen. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
dccratio XPath: /record/factuur/dcc/ratio |
Numeriek (255) |
Voor DCC is dit de verhouding tussen de bedragen in hoofdeenheden van zowel de handelaar Munt als de uiteindelijke Munt. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
debtrepayment XPath: /record/merchant/debtrepayment |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als schuldaflossing:
Klik hier voor meer informatie. Alleen teruggestuurd voor kaarttransacties. |
|
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. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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).
Klik hier voor een volledige lijst van errorcode en berichtwaarden. |
|
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. |
|
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. |
|
expirydate XPath: /record/billing/payment/expirydate |
Datum MM/JJJJ |
De op de kaart gedrukte vervaldatum. Alleen teruggestuurd voor kaarttransacties. |
|
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:
Klik hier voor meer informatie. Alleen teruggestuurd voor kaarttransacties. |
|
interface XPath: /record/operation/interface |
Alfanumeriek, inclusief symbolen (50) |
Vertegenwoordigt de interface via welke het opgevraagde verzoek werd verwerkt. De volgende zijn gangbare voorbeelden:
|
|
issuer XPath: /record/billing/payment/issuer |
Alfanumeriek (255) |
De uitgever van de kaart van de klant. Alleen teruggestuurd voor kaarttransacties. |
|
issuercountryiso2a XPath: /record/billing/payment/issuercountry |
Alpha (2) |
Het land voor de uitgever van de kaart van de klant. Klik hier voor een volledige lijst van landcodes. Alleen teruggestuurd voor kaarttransacties. |
|
livestatus XPath: /record/live |
Numeriek (1) |
|
|
maskedpan |
Alfanumeriek, inclusief "#" (12-19) |
Als tokenisedpayment wordt niet teruggestuurd: Als tokenisedpayment wordt teruggestuurd met waarde 1: Alleen teruggestuurd voor kaarttransacties. |
|
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) | ||
operatorname XPath: /record/merchant/operatorname |
Alfanumeriek (255) | De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. | |
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. |
|
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. |
|
paymenttypedescription XPath: /record/billing/payment/@type |
Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). | |
requesttypedescription XPath: /record/@type |
Alpha (20) | Het type verzoek dat in de record wordt teruggestuurd. | |
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. |
|
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: |
|
securityresponseaddress XPath: /record/security/address |
Numeriek (1) |
Het resultaat van AVS en beveiligingscodecontroles. Deze bevatten een van de volgende waarden:
Klik hier voor meer informatie. Deze velden worden teruggegeven indien ze beschikbaar zijn. |
|
securityresponsepostcode XPath: /record/security/postcode |
Numeriek (1) | ||
securityresponsesecuritycode XPath: /record/security/securitycode |
Numeriek (1) | ||
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. |
|
settleduedate XPath: /record/settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de opgevraagde transactie zal worden afgewikkeld. | |
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. |
|
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. |
|
sitereference XPath: /record/operation/sitereference |
Alfanumeriek & underscore (50) |
De sitereferentie via welke het opgevraagde verzoek is verwerkt. |
|
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. |
|
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. |
|
status XPath: /record/threedsecure/status |
Char (1) |
Geeft aan of de klant al dan niet op de ACS van de kaartuitgever werd geauthenticeerd. |
|
threedversion XPath: /record/threedsecure/version |
Numeriek (6) |
Versie van 3-D Secure die wordt gebruikt om de betaling te verifiëren. (bijv. "2.2.0") |
|
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. |
|
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. |
|
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. |
|
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. | |
transactionstartedtimestamp XPath: /record/timestamp |
Datum tijd JJJJ-MM-DD hh:mm:ss | Het tijdstip waarop de opgevraagde transactie werd verwerkt. | |
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:
Dit veld wordt teruggegeven indien het beschikbaar is. |
|
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. |
|
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. |