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 om 3-D Secure te gebruiken bij het verwerken 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.
AUTH verzoek
Voorbeeld
Om een AUTH verzoek met succes te verwerken, moet u de onderstaande specificatie volgen:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"currencyiso3a": "GBP",
"expirydate": "12/2020",
"orderreference": "My_Order_123",
"pan": "4111111111111111",
"requesttypedescriptions": ["AUTH"],
"securitycode": "123",
"sitereference": "test_site12345"
}
strequest = securetrading.Request()
strequest.update(auth)
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(
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingfirstname' => 'Joe',
'billinglastname' => 'Bloggs',
'currencyiso3a' => 'GBP',
'expirydate' => '12/2020',
'orderreference' => 'My_Order_123',
'pan' => '4111111111111111',
'requesttypedescriptions' => array('AUTH'),
'securitycode' => '123',
'sitereference' => 'test_site12345'
);
$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": [{
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"currencyiso3a": "GBP",
"expirydate": "12/2020",
"orderreference": "My_Order_123",
"pan": "4111111111111111",
"requesttypedescriptions": ["AUTH"],
"securitycode": "123",
"sitereference": "test_site12345"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingfirstname":"Joe",
"billinglastname":"Bloggs",
"currencyiso3a":"GBP",
"expirydate":"12/2020",
"orderreference":"My_Order_123",
"pan":"4111111111111111",
"requesttypedescriptions":["AUTH"],
"securitycode":"123",
"sitereference":"test_site12345"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<name>
<first>Joe</first>
<last>Bloggs</last>
</name>
<payment>
<expirydate>12/2020</expirydate>
<pan>4111111111111111</pan>
<securitycode>123</securitycode>
</payment>
</billing>
<merchant>
<orderreference>My_Order_123</orderreference>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>test_site12345</sitereference>
</operation>
</request>
</requestblock>
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
De volgende velden hebben betrekking op het soort verzoek dat wordt ingediend:
Veld | Formaat | Beschrijving | |
accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) |
Het type rekening dat moet worden gebruikt:
|
|
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 . |
|
credentialsonfile XPath: /operation/credentialsonfile |
Numeriek (1) |
De toegestane waarden voor dit veld zijn 0, 1 en 2.
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. |
|
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:
Aan het gebruik van deze functionaliteit zijn voorwaarden verbonden. Klik hier voor meer informatie. |
|
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".
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. |
|
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. | |
requesttypedescriptions XPath: /@type |
Alpha (20) | U moet "AUTH" invoeren, zoals in het verzoekvoorbeeld. | |
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: 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. |
|
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. |
De volgende velden bevatten de betalingsgegevens van de klant:
Veld | Formaat | Beschrijving | |
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) | |
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. |
|
expirydate XPath: /billing/payment/expirydate |
Datum MM/JJJJ | De op de kaart gedrukte vervaldatum. | |
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. | |
paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). | |
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. |
De volgende velden hebben betrekking op uw accountconfiguratie en laten u toe aangepaste unieke referenties voor uw aanvraag te configureren:
Veld | Formaat | Beschrijving | |
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:
|
|
merchantemail XPath: /merchant/email |
E-mail (255) | Het e-mailadres van de handelaar. Maximale lengte van 255 (maximaal 64 tekens voor het "@"-symbool). | |
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). | |
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). |
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 | |
billingpremise XPath: /billing/premise |
Alfanumeriek, inclusief symbolen (25) |
Het huisnummer of de eerste regel van het factuuradres van de klant. | |
billingstreet XPath: /billing/street |
Alfanumeriek, inclusief symbolen (127) |
De straat die is ingevoerd voor het factuuradres van de klant. | |
billingtown XPath: /billing/town |
Alfanumeriek, inclusief symbolen (127) |
De ingevoerde stad voor het factuuradres van de klant. | |
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:
|
|
billingcountryiso2a XPath: /billing/country |
Alpha (2) |
Het land voor het factuuradres van de klant. Dit moet in ISO2A-formaat zijn. |
|
billingpostcode XPath: /billing/postcode |
Alfanumeriek (25) |
De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend. |
|
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). | |
billingtelephonetype XPath: /billing/telephone/@type |
Char (1) |
Het type telefoonnummer. De beschikbare opties zijn:
|
|
billingtelephone XPath: /billing/telephone |
Alfanumeriek, inclusief symbolen (20) |
Telefoonnummer van de klant. Geldige tekens:
|
|
billingprefixname XPath: /billing/name/prefix |
Alfanumeriek, inclusief symbolen (25) |
Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.). | |
billingfirstname XPath: /billing/name/first |
Alfanumeriek, inclusief symbolen (127) |
De klant Voornaam facturatie. Vereist voor handelaren in kansspelen. |
|
billingmiddlename XPath: /billing/name/middle |
Alfanumeriek, inclusief symbolen (127) |
De middelste factureringsnaam of -namen van de klant. | |
billinglastname XPath: /billing/name/last |
Alfanumeriek, inclusief symbolen (127) |
De klant Achternaam facturatie. Vereist voor handelaren in kansspelen. |
|
billingsuffixname XPath: /billing/name/suffix |
Alfanumeriek, inclusief symbolen (25) |
Het achtervoegsel van de factureringsnaam van de klant (bv. Bsc). |
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 | |
customerpremise XPath: /customer/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam of het nummer van het huis van de klant. | |
customerstreet XPath: /customer/street |
Alfanumeriek, inclusief symbolen (127) |
De straatnaam van de klant. | |
customertown XPath: /customer/town |
Alfanumeriek, inclusief symbolen (127) |
De stad van de klant. | |
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:
|
|
customercountryiso2a XPath: /customer/country |
Alpha (2) |
Het land van de klant. Dit moet in ISO2A-formaat zijn. |
|
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. |
|
customeremail XPath: /customer/email |
E-mail (255) | Het e-mailadres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-symbool). | |
customertelephonetype XPath: /customer/telephone/@type |
Char (1) |
Het type telefoonnummer. De beschikbare opties zijn:
|
|
customertelephone XPath: /customer/telephone |
Alfanumeriek, inclusief symbolen (20) |
Telefoonnummer van de klant. Geldige tekens:
|
|
customerprefixname XPath: /customer/name/prefix |
Alfanumeriek, inclusief symbolen (25) |
De prefixnaam van de klant (bijv. De heer, Juffrouw, Dr.). | |
customerfirstname XPath: /customer/name/first |
Alfanumeriek, inclusief symbolen (127) |
De voornaam van de klant. | |
customermiddlename XPath: /customer/name/middle |
Alfanumeriek, inclusief symbolen (127) |
De middelste naam of namen van de klant. | |
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. |
|
customersuffixname XPath: /customer/name/suffix |
Alfanumeriek, inclusief symbolen (25) |
De achtervoegselnaam van de klant (bv. Bsc). | |
customerforwardedip XPath: /customer/forwardedip |
IP-adres (39) | Door de klant doorgestuurd IP-adres, zoals verstrekt door een proxyserver, indien beschikbaar. | |
customerip XPath: /customer/ip |
IP-adres (39) | Het IP-adres van de klant. |
De volgende velden bevatten de afwikkeling details:
Veld | Formaat | Beschrijving | |
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. | |
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". |
AUTH antwoord
Het volgende is een voorbeeld van een AUTH antwoord dat aangeeft dat het verzoek met succes werd verwerkt.
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'MOTO',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST36',
u 'baseamount': u '1050',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'Test Issuer',
u 'issuercountryiso2a': u 'US',
u 'livestatus': u '0',
u 'maskedpan': u '411111######1111',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'operatorname': u 'webservices@example.com',
u 'orderreference': u 'My_Order_123',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '2',
u 'settleduedate': u '2016-12-07',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'tid': u '27882788',
u 'transactionreference': u '23-9-80001',
u 'transactionstartedtimestamp': u '2016-12-07 11:32:44'
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(28) {
["accounttypedescription"] => string(4) "MOTO"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST31"
["baseamount"] => string(4) "1050"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["issuer"] => string(26) "Test Issuer"
["issuercountryiso2a"] => string(2) "US"
["livestatus"] => string(1) "0"
["merchantcountryiso2a"] => string(2) "GB"
["maskedpan"] => string(16) "411111######1111"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(8) "00000000"
["operatorname"] => string(23) "webservices@example.com"
["orderreference"] => string(12) "My_Order_123"
["paymenttypedescription"] => string(4) "VISA"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "2"
["settleduedate"] => string(10) "2016-12-09"
["settlestatus"] => string(1) "0"
["splitfinalnumber"] => string(1) "1"
["tid"] => string(8) "27882788"
["transactionreference"] => string(10) "72-9-80003"
["transactionstartedtimestamp"] => string(19) "2016-12-09 09:52:19"
}
}
}
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription":"MOTO",
"acquirerresponsecode":"00",
"authcode":"TEST96",
"baseamount":"1050",
"currencyiso3a":"GBP",
"dccenabled":"0",
"errorcode":"0",
"errormessage":"Ok",
"issuer":"Test Issuer",
"issuercountryiso2a":"US",
"livestatus":"0",
"maskedpan":"411111######1111",
"merchantcountryiso2a":"GB",
"merchantname":"Test Merchant",
"merchantnumber":"00000000",
"operatorname":"webservices@example.com",
"orderreference":"My_Order_123",
"paymenttypedescription":"VISA",
"requesttypedescription":"AUTH",
"securityresponseaddress":"0",
"securityresponsepostcode":"0",
"securityresponsesecuritycode":"2",
"settleduedate":"2016-12-07",
"settlestatus":"0",
"splitfinalnumber":"1",
"tid":"27882788",
"transactionreference":"23-9-80006",
"transactionstartedtimestamp":"2016-12-07 15:08:47"
}],
"secrand":"zO9"
}
<responseblock version="3.67">
<requestreference>A3579dkvx</requestreference>
<response type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>TEST96</authcode>
<billing>
<amount currencycode="GBP">1050</amount>
<dcc enabled="0"/>
<payment type="VISA">
<issuer>Test Issuer</issuer>
<issuercountry>ZZ</issuercountry>
<pan>411111######1111</pan>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>0</live>
<merchant>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>00000000</merchantnumber>
<operatorname>webservices@example.com</operatorname>
<orderreference>MyOrder123</orderreference>
<tid>27882788</tid>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<authmethod>PRE</authmethod>
<splitfinalnumber>1</splitfinalnumber>
</operation>
<security>
<address>2</address>
<postcode>2</postcode>
<securitycode>2</securitycode>
</security>
<settlement>
<settleduedate>2012-10-08</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<timestamp>2012-10-08 12:46:02</timestamp>
<transactionreference>23-9-80006</transactionreference>
</response>
<secrand>hYWFMkiiAZ0wKHFZ</secrand>
</responseblock>
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.
De volgende velden hebben betrekking op het soort verzoek dat wordt ingediend:
Veld | Formaat | Beschrijving | |
accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) |
Het type rekening dat moet worden gebruikt:
|
|
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. |
|
credentialsonfile XPath: /operation/credentialsonfile |
Numeriek (1) |
De toegestane waarden voor dit veld zijn 0, 1 en 2.
Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
|
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:
Dit veld wordt geretourneerd indien het door de overnemende bank wordt verstrekt, anders wordt het niet geretourneerd. |
|
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. |
|
requesttypedescription XPath: /@type |
Alpha (20) | "AUTH" wordt in het antwoord teruggezonden. | |
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: |
De volgende velden bevatten de factureringsgegevens van de klant:
Veld | Formaat | Beschrijving | |
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) | |
currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare munteenheden. |
|
dccenabled XPath: /billing/dcc/@enabled |
Numeriek (1) |
Geeft aan of uw account is geconfigureerd voor DCC: 1= Ja 0 = Nee |
|
issuer XPath: /billing/payment/issuer |
Alfanumeriek (255) | De uitgever van de kaart van de klant. | |
issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Het land voor de uitgever van de kaart van de klant. |
|
maskedpan XPath: /billing/payment/pan |
Alfanumeriek, inclusief "#" (12-19) |
Als tokenisedpayment wordt niet teruggestuurd: Als tokenisedpayment wordt teruggestuurd met waarde 1: |
|
paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). | |
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. |
|
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. |
|
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. |
|
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. |
De volgende velden hebben betrekking op uw accountconfiguratie:
Veld | Formaat | Beschrijving | |
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:
Dit veld wordt teruggestuurd als het naar de wervende bank wordt gestuurd. |
|
merchantnumber XPath: /merchant/merchantnumber |
Alfanumeriek (32) | Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank. | |
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) | ||
operatorname XPath: /merchant/operatorname |
Alfanumeriek (255) | De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. | |
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. |
|
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. |
De volgende velden bevatten de afwikkeling details:
Veld | Formaat | Beschrijving | |
settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de transactie zal worden afgewikkeld. | |
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. |
Naast de response object, worden in het antwoord ook twee extra velden geretourneerd:
Veld | Formaat | Beschrijving | |
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:
Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
|
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. |
|
acquirerresponsemessage XPath: /acquirerresponsemessage |
Alfanumeriek (255) | ||
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. |
|
errorcode XPath: /error/code |
Numeriek (1-5) |
De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
Klik hier voor een volledige lijst van errorcode en berichtwaarden. |
|
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. |
|
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. |
|
livestatus XPath: /live |
Numeriek (1) |
|
|
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. |
|
securityresponseaddress XPath: /security/address |
Numeriek (1) | Het resultaat van AVS en beveiligingscodecontroles. | |
securityresponsepostcode XPath: /security/postcode |
Numeriek (1) | ||
securityresponsesecuritycode XPath: /security/securitycode |
Numeriek (1) | ||
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. | |
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 | |
|
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. |
|
secrand | Alfanumeriek (16) | Willekeurige tekenreeks, teruggegeven in de respons van niet-API-gebaseerde bibliotheken ontwikkeld door Trust Payments. |