AUTH - Trust Payments

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.

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.

AUTH specificatie verzoekveld

	Veld	Formaat	Beschrijving
Verplicht	accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Het type rekening dat moet worden gebruikt: "ECOM" - E-commerce "MOTOMail Order Telefoon Order "RECUR" - Terugkerende transacties
Verplicht	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)
Verplicht	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.
Verplicht	expirydate XPath: /billing/payment/expirydate	Datum MM/JJJJ	De op de kaart gedrukte vervaldatum.
Verplicht	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.
Verplicht	requesttypedescriptions XPath: /@type	Alpha (20)	U moet "AUTH" invoeren, zoals in het verzoekvoorbeeld.
Verplicht	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.
Conditioneel	billingfirstname XPath: /billing/name/first	Alfanumeriek, inclusief symbolen (127)	De klant Voornaam facturatie. Vereist voor handelaren in kansspelen.
Conditioneel	billinglastname XPath: /billing/name/last	Alfanumeriek, inclusief symbolen (127)	De klant Achternaam facturatie. Vereist voor handelaren in kansspelen.
Conditioneel	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.
Conditioneel	customeraccountnumber XPath: /customer/accountnumber	Numeriek (20)	Als het type rekeningnummer "ACCOUNT", het rekeningnummer van de primaire ontvanger. Als het type rekeningnummer "CARD", het kaartnummer van de primaire ontvanger. De geretourneerde waarde in het antwoord is in een gemaskeerd formaat, bijvoorbeeld "411111#######1111". Vereist als Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.
Conditioneel	customeraccountnumbertype XPath: /customer/accountnumber/@type	Alfa (7)	Ofwel "CARD" of "ACCOUNT". Vereist als Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.
Conditioneel	customerdob XPath: /customer/dob	Datum JJJJ-MM-DD	De geboortedatum van de primaire ontvanger. Vereist als Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.
Conditioneel	customerlastname XPath: /customer/name/last	Alfanumeriek, inclusief symbolen (127)	De achternaam van de klant. Vereist als Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.
Conditioneel	customerpostcode XPath: /customer/postcode	Alfanumeriek (25)	De leveringspostcode of postcode. Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend. Vereist als Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.
Conditioneel	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.
Conditioneel	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.
Optioneel	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 .
Optioneel	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.
Optioneel	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".
Optioneel	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).
Optioneel	billingmiddlename XPath: /billing/name/middle	Alfanumeriek, inclusief symbolen (127)	De middelste factureringsnaam of -namen van de klant.
Optioneel	billingpostcode XPath: /billing/postcode	Alfanumeriek (25)	De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend.
Optioneel	billingprefixname XPath: /billing/name/prefix	Alfanumeriek, inclusief symbolen (25)	Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.).
Optioneel	billingpremise XPath: /billing/premise	Alfanumeriek, inclusief symbolen (25)	Het huisnummer of de eerste regel van het factuuradres van de klant.
Optioneel	billingstreet XPath: /billing/street	Alfanumeriek, inclusief symbolen (127)	De straat die is ingevoerd voor het factuuradres van de klant.
Optioneel	billingsuffixname XPath: /billing/name/suffix	Alfanumeriek, inclusief symbolen (25)	Het achtervoegsel van de factureringsnaam van de klant (bv. Bsc).
Optioneel	billingtelephone XPath: /billing/telephone	Alfanumeriek, inclusief symbolen (20)	Telefoonnummer van de klant. Geldige tekens: Cijfers 0-9 Ruimtes Speciale tekens: + - ( )
Optioneel	billingtelephonetype XPath: /billing/telephone/@type	Char (1)	Het type telefoonnummer. De beschikbare opties zijn: H = Thuis M = Mobiel W = Werk
Optioneel	billingtown XPath: /billing/town	Alfanumeriek, inclusief symbolen (127)	De ingevoerde stad voor het factuuradres van de klant.
Optioneel	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: + - _ . @ ( )
Optioneel	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.
Optioneel	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.
Optioneel	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".
Optioneel	customeremail XPath: /customer/email	E-mail (255)	Het e-mailadres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-symbool).
Optioneel	customerfirstname XPath: /customer/name/first	Alfanumeriek, inclusief symbolen (127)	De voornaam van de klant.
Optioneel	customerforwardedip XPath: /customer/forwardedip	IP-adres (39)	Door de klant doorgestuurd IP-adres, zoals verstrekt door een proxyserver, indien beschikbaar.
Optioneel	customerip XPath: /customer/ip	IP-adres (39)	Het IP-adres van de klant.
Optioneel	customermiddlename XPath: /customer/name/middle	Alfanumeriek, inclusief symbolen (127)	De middelste naam of namen van de klant.
Optioneel	customerprefixname XPath: /customer/name/prefix	Alfanumeriek, inclusief symbolen (25)	De prefixnaam van de klant (bijv. De heer, Juffrouw, Dr.).
Optioneel	customerpremise XPath: /customer/premise	Alfanumeriek, inclusief symbolen (25)	De naam of het nummer van het huis van de klant.
Optioneel	customerstreet XPath: /customer/street	Alfanumeriek, inclusief symbolen (127)	De straatnaam van de klant.
Optioneel	customersuffixname XPath: /customer/name/suffix	Alfanumeriek, inclusief symbolen (25)	De achtervoegselnaam van de klant (bv. Bsc).
Optioneel	customertelephone XPath: /customer/telephone	Alfanumeriek, inclusief symbolen (20)	Telefoonnummer van de klant. Geldige tekens: Cijfers 0-9 Ruimtes Speciale tekens: + - ( )
Optioneel	customertelephonetype XPath: /customer/telephone/@type	Char (1)	Het type telefoonnummer. De beschikbare opties zijn: H = Thuis M = Mobiel W = Werk
Optioneel	customertown XPath: /customer/town	Alfanumeriek, inclusief symbolen (127)	De stad van de klant.
Optioneel	merchantemail XPath: /merchant/email	E-mail (255)	Het e-mailadres van de handelaar. Maximale lengte van 255 (maximaal 64 tekens voor het "@"-symbool).
Optioneel	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).
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).
Optioneel	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.
Optioneel	paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Optioneel	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.
Optioneel	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.
Optioneel	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 '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.

AUTH specificatie antwoordveld

	Veld	Formaat	Beschrijving
Geretourneerd	accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Het type rekening dat moet worden gebruikt: "ECOM" - E-commerce. "MOTOMail Order Telefoon Order "RECUR" - Terugkerende transacties
Geretourneerd	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)
Geretourneerd	currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare munteenheden.
Geretourneerd	dccenabled XPath: /billing/dcc/@enabled	Numeriek (1)	Geeft aan of uw account is geconfigureerd voor DCC: 1= Ja 0 = Nee
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	livestatus XPath: /live	Numeriek (1)	0 - Transactie verwerkt met een testrekening. 1 - Transactie verwerkt met een live rekening.
Geretourneerd	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.
Geretourneerd	merchantnumber XPath: /merchant/merchantnumber	Alfanumeriek (32)	Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.
Geretourneerd	operatorname XPath: /merchant/operatorname	Alfanumeriek (255)	De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
Geretourneerd	paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Geretourneerd	requesttypedescription XPath: /@type	Alpha (20)	"AUTH" wordt in het antwoord teruggezonden.
Geretourneerd	securityresponseaddress XPath: /security/address	Numeriek (1)	Het resultaat van AVS en beveiligingscodecontroles. Klik hier voor meer informatie.
Geretourneerd	securityresponsepostcode XPath: /security/postcode	Numeriek (1)
Geretourneerd	securityresponsesecuritycode XPath: /security/securitycode	Numeriek (1)
Geretourneerd	settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-DD	De datum waarop de transactie zal worden afgewikkeld.
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	transactionstartedtimestamp XPath: /timestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	Het tijdstip waarop de transactie werd verwerkt.
Conditioneel	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.
Conditioneel	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.
Conditioneel	acquirerresponsemessage XPath: /acquirerresponsemessage	Alfanumeriek (255)
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	issuer XPath: /billing/payment/issuer	Alfanumeriek (255)	De uitgever van de kaart van de klant. Deze informatie wordt geretourneerd indien beschikbaar.
Conditioneel	merchantcategorycode XPath: /merchant/merchantcategorycode	Alfanumeriek (255)	Klant Categorie Code (MCC) in onze administratie. 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.
Conditioneel	merchantcity XPath: /merchant/merchantcity	Alfanumeriek (127)	Stad op het adres van de verkoper in onze gegevens. 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.
Conditioneel	merchantcountryiso2a XPath: /merchant/merchantcountryiso2a	Alpha (2)	Land op het adres van de verkoper in onze administratie. 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.
Conditioneel	merchantname XPath: /merchant/merchantname	Alfanumeriek (255)	Naam verkoper in onze administratie. 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.
Conditioneel	merchantstatecode XPath: /merchant/merchantstatecode	Alfanumeriek (127)	Deelstaatcode op het adres van de verkoper in onze administratie. 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.
Conditioneel	merchantzipcode XPath: /merchant/merchantzipcode	Alfanumeriek (10)	Postcode op het adres van de verkoper in onze administratie. 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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.

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

	Veld	Formaat	Beschrijving
Geretourneerd	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.
Geretourneerd	secrand	Alfanumeriek (16)	Willekeurige tekenreeks, teruggegeven in de respons van niet-API-gebaseerde bibliotheken ontwikkeld door Trust Payments.