AUTH

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

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

Vereisten

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

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

Alle bedrijven binnen de EER (Europese Economische Ruimte) zijn verplicht 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.

Klik hier voor meer informatie.

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 = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["AUTH"],
  "accounttypedescription": "MOTO",
  "currencyiso3a": "GBP",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "billingfirstname": "Joe",
  "billinglastname": "Bloggs",
  "pan": "4111111111111111",
  "expirydate": "12/2020",
  "securitycode": "123"
}

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

<?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(
  'sitereference' => 'test_site12345', 
  'requesttypedescriptions' => array('AUTH'),
  'accounttypedescription' => 'MOTO',
  'currencyiso3a' => 'GBP',
  'baseamount' => '1050',
  'orderreference' => 'My_Order_123',
  'billingfirstname' => 'Joe',
  'billinglastname' => 'Bloggs',
  'pan' => '4111111111111111',
  'expirydate' => '12/2020',
  'securitycode' => '123'
);

$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": [{
    "currencyiso3a": "GBP",
    "requesttypedescriptions": ["AUTH"],
    "sitereference": "test_site12345",
    "baseamount": "1050",
    "orderreference": "My_Order_123",
    "billingfirstname": "Joe",
    "billinglastname": "Bloggs",
    "accounttypedescription": "MOTO",
    "pan": "4111111111111111",
    "expirydate": "12/2020",
    "securitycode": "123"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "currencyiso3a":"GBP",
    "requesttypedescriptions":["AUTH"],
    "sitereference":"test_site12345",
    "baseamount":"1050",
    "orderreference":"My_Order_123",
    "billingfirstname":"Joe",
    "billinglastname":"Bloggs",
    "accounttypedescription":"MOTO",
    "pan":"4111111111111111",
    "expirydate":"12/2020",
    "securitycode":"123"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="AUTH">
    <merchant>
      <orderreference>My_Order_123</orderreference>
    </merchant>
    <billing>
      <payment>
        <expirydate>12/2020</expirydate>
        <pan>4111111111111111</pan>
        <securitycode>123</securitycode>
      </payment>
      <amount currencycode="GBP">1050</amount>
      <name>
        <first>Joe</first>
        <last>Bloggs</last>
      </name>
    </billing>
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>MOTO</accounttypedescription>
    </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

Operatie

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: "ECOM" - E-commerce "MOTOMail Order Telefoon Order "RECUR" - Terugkerende transacties
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: PRE - Pre-autorisatie FINAL - Finale autorisatie INCREMENTAL - Incrementeel autorisatie SPLIT - Gesplitste zending 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. "0" - Komt niet in aanmerking voor CoF, of is niet van plan de referenties op een later tijdstip opnieuw te gebruiken. "1" - Kaarthoudergegevens gemarkeerd als beschikbaar voor toekomstig gebruik. "2" - Betaling met gebruik van eerder opgeslagen inloggegevens. Dit is vereist voor transacties waarbij de merchant gebruik maakt van Gevevens in Bestand (CoF). Als de transactie niet in aanmerking komt voor CoF, of als u de referenties niet wilt gebruiken voor toekomstige transacties, kunt u dit veld weglaten.
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator	Numeriek (1)	Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency: 1 - Transactie is gemarkeerd als aankoop van cryptocurrency. 0 - Transactie is niet gemarkeerd als aankoop van cryptocurrency. Aan het gebruik van deze functionaliteit zijn voorwaarden verbonden. Klik hier voor meer informatie.
initiationreason XPath: /operation/initiationreason	Char (1)	Dit is vereist bij de verwerking van een Merchant Initiated Transaction (MIT). Hiermee kunt u een reden toewijzen voor een Merchant Initiated Transaction (MIT). Niet indienen bij het verwerken van een door de klant geïnitieerde transactie (CIT). De toegestane waarden voor dit veld zijn "A", "C", "D", "S" en "X". "A" - Herautorisatie "C" - Onvoorziene betaling "D" - Uitgestelde kosten "S" - Opnieuw indienen "X" - No-show (voor een hotelboeking) Klik hier voor meer informatie over de verschillende initiationreason waarden. Let op: U moet ervoor zorgen dat de initiationreason in het verzoek correct de reden voor de nieuwe betaling weergeeft.
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: 1 - Lage waarde 2 - Analyse van transactierisico's 3 - Vertrouwde handelaar 4 - Beveiligde zakelijke betaling 5 - Gedelegeerde authenticatie De scaexemptionindicator veld mag alleen worden ingediend in een AUTH verzoek. Indiening van de scaexemptionindicator veld wordt niet ondersteund wanneer naar een bovengeschikte transactie wordt verwezen. Indien niet aan deze voorwaarden wordt voldaan, wordt de vrijstelling niet toegepast.
sitereference XPath: /operation/sitereference	Alfanumeriek & underscore (50)	Identificeert uw site op het Trust Payments systeem. Als u uw sitereferentie niet kent, neem dan contact op met ons Support Team.

Betaling

De volgende velden bevatten de betalingsgegevens van de klant:

Veld	Formaat	Beschrijving
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.

Handelaar

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: Hoofdletters/kleine letters A-Z Cijfers 0-9 Ruimtes Interpunctie: + - _ . @ ( )
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).

Facturering

De volgende velden bevatten de factureringsgegevens van de klant:

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

Veld	Formaat	Beschrijving
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: Bij voorkeur: Code van twee karakters voor de staat, bijv. "NY". Volledige naam van de staat, b.v. "New York".
billingcountryiso2a XPath: /billing/country	Alpha (2)	Het land voor het factuuradres van de klant. Dit moet in ISO2A-formaat zijn. Klik hier voor een volledige lijst van landcodes.
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: H = Thuis M = Mobiel W = Werk
billingtelephone XPath: /billing/telephone	Alfanumeriek, inclusief symbolen (20)	Telefoonnummer van de klant. Geldige tekens: Cijfers 0-9 Ruimtes Speciale 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).

Klant en levering

De volgende velden bevatten de leveringsgegevens van de klant:

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

Veld	Formaat	Beschrijving
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: Voorkeur: 2 karakters staatscode, bijv. "NY". Volledige naam van de staat, b.v. "New York".
customercountryiso2a XPath: /customer/country	Alpha (2)	Het land van de klant. Dit moet in ISO2A-formaat zijn. Klik hier voor een volledige lijst van landcodes.
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: H = Thuis M = Mobiel W = Werk
customertelephone XPath: /customer/telephone	Alfanumeriek, inclusief symbolen (20)	Telefoonnummer van de klant. Geldige tekens: Cijfers 0-9 Ruimtes Speciale 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.

Afwikkeling

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". Klik voor meer informatie over het proces afwikkeling .

AUTH antwoord

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

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

array(3) {
  ["requestreference"] => string(9) "A3579dkvx"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [0] => array(28) {
      ["transactionstartedtimestamp"] => string(19) "2016-12-09 09:52:19"
      ["livestatus"] => string(1) "0"
      ["issuer"] => string(26) "Test Issuer"
      ["splitfinalnumber"] => string(1) "1"
      ["dccenabled"] => string(1) "0"
      ["settleduedate"] => string(10) "2016-12-09"
      ["errorcode"] => string(1) "0"
      ["orderreference"] => string(12) "My_Order_123"
      ["tid"] => string(8) "27882788"
      ["merchantnumber"] => string(8) "00000000"
      ["securityresponsepostcode"] => string(1) "0"
      ["transactionreference"] => string(10) "72-9-80003"
      ["merchantname"] => string(13) "Test Merchant"
      ["paymenttypedescription"] => string(4) "VISA"
      ["baseamount"] => string(4) "1050"
      ["accounttypedescription"] => string(4) "MOTO"
      ["acquirerresponsecode"] => string(2) "00"
      ["requesttypedescription"] => string(4) "AUTH"
      ["securityresponsesecuritycode"] => string(1) "2"
      ["currencyiso3a"] => string(3) "GBP"
      ["authcode"] => string(6) "TEST31"
      ["errormessage"] => string(2) "Ok"
      ["operatorname"] => string(23) "webservices@example.com"
      ["merchantcountryiso2a"] => string(2) "GB"
      ["maskedpan"] => string(16) "411111######1111"
      ["securityresponseaddress"] => string(1) "0"
      ["issuercountryiso2a"] => string(2) "US"
      ["settlestatus"] => string(1) "0"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionstartedtimestamp":"2016-12-07 15:08:47",
    "livestatus":"0",
    "issuer":"Test Issuer",
    "splitfinalnumber":"1",
    "dccenabled":"0",
    "settleduedate":"2016-12-07",
    "errorcode":"0",
    "baseamount":"1050",
    "tid":"27882788",
    "merchantnumber":"00000000",
    "merchantcountryiso2a":"GB",
    "transactionreference":"23-9-80006",
    "merchantname":"Test Merchant",
    "paymenttypedescription":"VISA",
    "orderreference":"My_Order_123",
    "accounttypedescription":"MOTO",
    "acquirerresponsecode":"00",
    "requesttypedescription":"AUTH",
    "securityresponsesecuritycode":"2",
    "currencyiso3a":"GBP",
    "authcode":"TEST96",
    "errormessage":"Ok",
    "operatorname":"webservices@example.com",
    "securityresponsepostcode":"0",
    "maskedpan":"411111######1111",
    "securityresponseaddress":"0",
    "issuercountryiso2a":"US",
    "settlestatus":"0"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>A3579dkvx</requestreference>
  <response type="AUTH">
    <merchant>
      <merchantname>Test Merchant</merchantname>
      <orderreference>MyOrder123</orderreference>
      <tid>27882788</tid>
      <merchantnumber>00000000</merchantnumber>
      <merchantcountryiso2a>GB</merchantcountryiso2a>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <transactionreference>23-9-80006</transactionreference>
    <security>
      <postcode>2</postcode>
      <securitycode>2</securitycode>
      <address>2</address>
    </security>
    <billing>
      <amount currencycode="GBP">1050</amount>
      <payment type="VISA">
        <issuer>Test Issuer</issuer>
        <issuercountry>ZZ</issuercountry>
        <pan>411111######1111</pan>
      </payment>
      <dcc enabled="0"/>
    </billing>
    <authcode>TEST96</authcode>
    <timestamp>2012-10-08 12:46:02</timestamp>
    <settlement>
      <settleduedate>2012-10-08</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <live>0</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <acquirerresponsecode>00</acquirerresponsecode>
    <operation>
      <splitfinalnumber>1</splitfinalnumber>
      <authmethod>PRE</authmethod>
      <accounttypedescription>MOTO</accounttypedescription>
    </operation>
  </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.

Operatie

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: "ECOM" - E-commerce. "MOTOMail Order Telefoon Order "RECUR" - Terugkerende transacties
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: PRE - Pre-autorisatie FINAL - Finale autorisatie INCREMENTAL - Incrementeel autorisatie SPLIT - Gesplitste zending 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. "0" - Komt niet in aanmerking voor CoF, of is niet van plan de referenties op een later tijdstip opnieuw te gebruiken. "1" - Transactiegegevens gemarkeerd als beschikbaar voor toekomstig gebruik. "2" - Betaling met gebruik van eerder opgeslagen inloggegevens. Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator	Numeriek (1)	Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency: 1 - Transactie is gemarkeerd als aankoop van cryptocurrency. 0 - Transactie is niet gemarkeerd als aankoop van cryptocurrency. Dit veld wordt geretourneerd indien het door de overnemende bank wordt verstrekt, anders wordt het niet geretourneerd.
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: 1 - Lage waarde 2 - Analyse van transactierisico's 3 - Vertrouwde handelaar 4 - Beveiligde zakelijke betaling 5 - Gedelegeerde authenticatie

Facturering

De volgende velden bevatten de factureringsgegevens van de klant:

Veld	Formaat	Beschrijving
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. Dit zal in ISO2A formaat zijn. Klik hier voor een volledige lijst van landcodes.
maskedpan XPath: /billing/payment/pan	Alfanumeriek, inclusief "#" (12-19)	Als tokenisedpayment wordt niet teruggestuurd: De maskedpan veld staat voor het kaartnummer van de klant. Als tokenisedpayment wordt teruggestuurd met waarde 1: De maskedpan staat voor het unieke tokennummer van de klant dat wordt gebruikt om de transactie uit te voeren. De waarde van maskedpan veld wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.
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.

Handelaar

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: Hoofdletters/kleine letters A-Z Cijfers 0-9 Ruimtes Interpunctie: + - _ . @ ( ) 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.

Afwikkeling

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.

Verrichtingsstatus

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: 0 - Geen actie vereist. 1 - Nieuwe rekeninginformatie beschikbaar. 2 - Kan op dit moment niet worden goedgekeurd. 4 - Verwerk geen terugkerende transacties meer. 8 - Betaling geblokkeerd door kaartsysteem. Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
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. 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.
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)	0 - Transactie verwerkt met een testrekening. 1 - Transactie verwerkt met een live rekening.
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. Klik hier voor meer informatie.
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.

Meer lezen over dit onderwerp