AUTH

In der folgenden Dokumentation wird erläutert, wie Sie eine AUTH Anfrage mit Hilfe unserer Webservices API manuell einreicht.

Wenn Sie bereits E-Commerce-Zahlungen mit unserem JavaScript Library (unter Verwendung von 3-D Secure v2) abwickeln, brauchen Sie die hier beschriebene Anforderung AUTH nicht mehr manuell durchzuführen (da JavaScript Library die Anforderung Autorisierung automatisch durchführt).

Voraussetzungen

Der folgende Inhalt setzt voraus, dass Sie die erforderliche PCI-Zertifizierung erhalten haben, um sensible Karteninhaberdaten in der Anfrage an unsere Webservices API zu verarbeiten und zu übermitteln.

Wenn Sie sich nicht sicher sind, wenden Sie sich bitte an unser Support-Team, um Hilfe zu erhalten.

Alle Unternehmen innerhalb des EWR (Europäischer Wirtschaftsraum) sind im Rahmen des PSD2 Mandats verpflichtet, bei der Abwicklung von Transaktionen im elektronischen Handel 3-D Secure zu verwenden.

Händler, die E-Commerce-Transaktionen verarbeiten, MÜSSEN die 3DS-Authentifizierung unterstützen. Klicken Sie hier, um mehr zu erfahren.

Der folgende Inhalt sollte nur von Händlern verwendet werden, die Zahlungen im Rahmen des telefonischen Versandhandels (MOTO) oder andere Arbeitsabläufe verarbeiten, die vom PSD2-Mandat ausgenommen sind.

ECOM (e-Commerce) Maestro-Transaktionen erfordern die Implementierung von 3-D Secure , um erfolgreich verarbeitet werden zu können.

Um 3-D Secure auszuführen, müssen Sie unser JavaScript Library verwenden. Klicken Sie hier, um loszulegen.

Um Betrug zu reduzieren, hat Visa vorgeschrieben, dass alle in Großbritannien ansässigen Händler mit einer Kunden Categorie Nummer (MCC) von 6012 verpflichtet sind, zusätzliche Felder in AUTH und ACCOUNTCHECK Anfragen zu senden.

Werden diese Felder nicht ausgefüllt, kann die Transaktion nicht erfolgreich bearbeitet werden, und es wird ein "60025" angezeigt errorcode die in der Antwort zurückgegeben werden.

Klicken Sie hier für weitere Informationen.

AUTH Anfrage

Beispiel

Um eine AUTH Anfrage erfolgreich bearbeiten zu können, müssen Sie die folgenden Angaben beachten:

#!/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>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

Wenn Sie die Anfrage AUTH testen, stellen Sie sicher, dass Sie Ihren Test übermitteln sitereference. Dadurch wird sichergestellt, dass die Transaktionen an unsere Testbank weitergeleitet werden und kein Geld den Besitzer wechselt. Wenn Sie live gehen, müssen Sie Ihren Test Website-Referenz gegen Ihren Live-Test Website-Referenz austauschen.

Klicken Sie hier, um Testkartennummern zu erhalten, die Sie während der Testphase unter AUTH anfordern können.

Feldspezifikation

Operation

Die folgenden Felder beziehen sich auf die Art des eingereichten Antrags:

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Die Art des zu verwendenden Kontos: "ECOM" - Elektronischer Geschäftsverkehr "MOTO" - Versandhandel Telefonische Bestellung "RECUR" - Wiederkehrende Transaktionen
authmethod XPath: /operation/authmethod	Alpha (11)	Auth-Methoden werden verwendet, um festzulegen, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Jede authmethod hat eine Reihe von unterschiedlichen Anforderungen. Klicken Sie auf die folgenden Links, um mehr zu erfahren: PRE - Vor...Autorisierung FINAL - Finale Autorisierung INCREMENTAL - Inkrementell Autorisierung SPLIT - Gesplittete Sendung Der Inhalt von authmethod haben keinen Einfluss auf den Abrechnung Status der Transaktion. Abrechnung Status kann über settlestatus und settleduedate. Klicken Sie hier, um mehr über den Prozess Abrechnung zu erfahren.
credentialsonfile XPath: /operation/credentialsonfile	Numerisch (1)	Die zulässigen Werte für dieses Feld sind 0, 1 und 2. "0" - Keine Berechtigung für CoF oder keine Absicht, die Berechtigungsnachweise zu einem späteren Zeitpunkt wieder zu verwenden. "1" - Die Zugangsdaten des Karteninhabers sind als für die zukünftige Verwendung verfügbar gekennzeichnet. "2" - Zahlung mit zuvor gespeicherten Anmeldeinformationen. Dies ist für Transaktionen erforderlich, bei denen der Händler Hinterlegte Anmeldedaten (CoF) verwendet. Wenn die Transaktion nicht für CoF in Frage kommt oder Sie keine Credentials für zukünftige Transaktionen verwenden möchten, können Sie dieses Feld auslassen.
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator	Numerisch (1)	Zeigt an, ob die Transaktion als Kauf einer Kryptowährung gekennzeichnet ist: 1 - Die Transaktion wird als Kryptowährungskauf gekennzeichnet. 0 - Transaktion ist nicht als Kryptowährungskauf gekennzeichnet. Die Nutzung dieser Funktionalität unterliegt bestimmten Anforderungen. Klicken Sie hier, um mehr zu erfahren.
initiationreason XPath: /operation/initiationreason	Saibling (1)	Dies ist erforderlich, wenn eine vom Händler initiierte Transaktion verarbeitet wird (MIT). Hier können Sie einen Grund für eine vom Händler initiierte Transaktion angeben (MIT). Nicht einreichen, wenn eine kundeninitiierte Transaktion verarbeitet wird (CIT). Die zulässigen Werte für dieses Feld sind "A", "C", "D", "S" und "X". "A" - Erneute Autorisierung "C" - Ungeplante Zahlung "D" - Zeitverzögerte Gebühren "S" - Erneutes Absenden "X" - Keine Anzeige (bei einer Hotelbuchung) Klicken Sie hier für weitere Informationen zu den verschiedenen initiationreason Werte. Anmerkung: Sie müssen sicherstellen, dass die initiationreason die im Antrag angegebene Begründung für die neue Zahlung korrekt ist.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Ermöglicht Ihnen die Angabe der transactionreference einer früheren Anfrage. Die wichtigsten Details sind geerbt von diesem Antrag.
requesttypedescriptions XPath: /@type	Alpha (20)	Sie müssen "AUTH" eingeben, wie im Beispiel des Antrags gezeigt.
scaexemptionindicator XPath: /operation/scaexemptionindicator	Numerisch (1)	Erforderlich, wenn eine Transaktion als von EMV 3DS ausgenommen gekennzeichnet wird. Klicken Sie hier, um mehr zu erfahren. Geben Sie einen der folgenden Werte an: 1 - Niedriger Wert 2 - Analyse des Transaktionsrisikos 3 - Vertrauenswürdiger Händler 4 - Sichere Unternehmenszahlung 5 - Authentifizierung delegiert Die scaexemptionindicator darf nur im Rahmen einer Anfrage an AUTH übermittelt werden. Die Einreichung des scaexemptionindicator Feld wird nicht unterstützt, wenn auf eine übergeordnete Transaktion verwiesen wird. Wenn diese Bedingungen nicht erfüllt sind, kann die Ausnahme nicht angewendet werden.
sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

Zahlung

Die folgenden Felder enthalten die Zahlungsdaten des Kunden:

Feld	Format	Beschreibung
baseamount XPath: /billing/amount	Numerisch (13)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. 10€ wird als 1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - wenden Sie sich für weitere Informationen an Ihre Bank)
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. Wenn die Währung in einer untergeordneten Anfrage übermittelt wird, muss sie denselben Wert haben wie die übergeordnete Transaktion.
expirydate XPath: /billing/payment/expirydate	Datum MM/JJJJ	Das auf der Karte aufgedruckte Ablaufdatum.
pan XPath: /billing/payment/pan	Numerisch (12-19)	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
securitycode XPath: /billing/payment/securitycode	Numerisch (3-4)	Dies ist der 3-stellige Sicherheitscode, der auf der Rückseite der Karte aufgedruckt ist. (Bei AMEX ist dies ein 4-stelliger Code, der sich auf der Vorderseite der Karte befindet) Dieses Feld ist für Trust Payments nicht unbedingt erforderlich, wird aber für die Verarbeitung von Sicherheitscodeprüfungen dringend empfohlen. Außerdem können einige Banken die Zahlung ablehnen, wenn der Sicherheitscode nicht vorhanden ist.

Händler

Die folgenden Felder beziehen sich auf Ihre Kontokonfiguration und ermöglichen es Ihnen, benutzerdefinierte eindeutige Referenzen für Ihre Anfrage zu konfigurieren:

Feld	Format	Beschreibung
chargedescription XPath: /merchant/chargedescription	Alphanumerisch einschließlich Symbole (25)	Dies ist eine Beschreibung der Zahlung, die auf dem Kontoauszug des Kunden erscheint. Dies wird von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren. Die Spezifikation dieses Feldes hängt von Ihrer anwerbenden Bank ab. Klicken Sie hier für weitere Informationen. Gültige Zeichen: Großbuchstaben/Kleinbuchstaben A-Z Ziffern 0-9 Räume Zeichensetzung: + - _ . @ ( )
merchantemail XPath: /merchant/email	E-Mail (255)	Die E-Mail-Adresse des Händlers. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. Standardmäßig ist dies der in der Anfrage enthaltene Webdienst-Benutzername. Dies kann durch einen benutzerdefinierten Wert überschrieben werden, indem dieses Feld in der Anfrage übergeben wird (optional).
orderreference XPath: /merchant/orderreference	Alphanumerisch einschließlich Symbole (25)Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Hinweis: Dies kann zu einem späteren Zeitpunkt aktualisiert werden (nur wenn die Transaktion noch nicht abgeschlossen ist Abrechnung).

Rechnungsstellung

Die folgenden Felder enthalten die Rechnungsdaten des Kunden:

Überschreitet ein übermitteltes Abrechnungsfeld die maximal zulässige Länge (wie in der Tabelle unten dokumentiert), wird ein Feldfehler zurückgegeben (errorcode 30000).

Feld	Format	Beschreibung
billingpremise XPath: /billing/premise	Alphanumerisch einschließlich Symbole (25)	Die Hausnummer oder die erste Zeile der Rechnungsadresse des Kunden.
billingstreet XPath: /billing/street	Alphanumerisch einschließlich Symbole (127)	Die für die Rechnungsadresse des Kunden eingegebene Straße.
billingtown XPath: /billing/town	Alphanumerisch einschließlich Symbole (127)	Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde.
billingcounty XPath: /billing/county	Alphanumerisch einschließlich Symbole (127)	Der Bezirk, der für die Rechnungsadresse des Kunden eingegeben wurde. Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: Zweistelliger Staatencode, z. B. "NY". Vollständiger Name des Staates, z. B. "New York".
billingcountryiso2a XPath: /billing/country	Alpha (2)	Das Land, in dem die Rechnungsadresse des Kunden liegt. Diese muss im ISO2A-Format angegeben werden. Klicken Sie hier für eine vollständige Liste der Ländercodes.
billingpostcode XPath: /billing/postcode	Alphanumerisch (25)	Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt.
billingemail XPath: /billing/email	E-Mail (255)	Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen).
billingtelephonetype XPath: /billing/telephone/@type	Saibling (1)	Die Art der Telefonnummer. Die verfügbaren Optionen sind: H = Heim M = Handy W = Arbeit
billingtelephone XPath: /billing/telephone	Alphanumerisch einschließlich Symbole (20)	Die Telefonnummer des Kunden. Gültige Zeichen: Ziffern 0-9 Räume Sonderzeichen: + - ( )
billingprefixname XPath: /billing/name/prefix	Alphanumerisch einschließlich Symbole (25)	Das Präfix des Rechnungsnamens des Kunden (z. B. Herr, Frau, Dr.).
billingfirstname XPath: /billing/name/first	Alphanumerisch einschließlich Symbole (127)	Der Kunde ist Rechnungsvorname. Erforderlich für Glücksspielanbieter.
billingmiddlename XPath: /billing/name/middle	Alphanumerisch einschließlich Symbole (127)	Der/die mittlere(n) Rechnungsname(n) des Kunden.
billinglastname XPath: /billing/name/last	Alphanumerisch einschließlich Symbole (127)	Der Kunde ist Rechnungsnachname. Erforderlich für Glücksspielanbieter.
billingsuffixname XPath: /billing/name/suffix	Alphanumerisch einschließlich Symbole (25)	Das Suffix des Rechnungsnamens des Kunden (z. B. Bsc).

Kunde und Lieferung

Die folgenden Felder enthalten die Lieferdaten des Kunden:

Wenn ein Kundenfeld die maximal zulässige Länge überschreitet (wie in der nachstehenden Tabelle angegeben), wird ein Feldfehler zurückgegeben (errorcode 30000).

Feld	Format	Beschreibung
customerpremise XPath: /customer/premise	Alphanumerisch einschließlich Symbole (25)	Der Name oder die Hausnummer des Kunden.
customerstreet XPath: /customer/street	Alphanumerisch einschließlich Symbole (127)	Der Straßenname des Kunden.
customertown XPath: /customer/town	Alphanumerisch einschließlich Symbole (127)	Die Stadt des Kunden.
customercounty XPath: /customer/county	Alphanumerisch einschließlich Symbole (127)	Der Bezirk des Kunden. Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: 2-stelliger Bundesstaatencode, z. B. "NY". Vollständiger Name des Staates, z. B. "New York".
customercountryiso2a XPath: /customer/country	Alpha (2)	Das Land des Kunden. Dies muss im ISO2A-Format erfolgen. Klicken Sie hier für eine vollständige Liste der Ländercodes.
customerpostcode XPath: /customer/postcode	Alphanumerisch (25)	Die Postleitzahl oder der ZIP-Code für die Zustellung. Es muss sich um eine gültige Postleitzahl für den customercountryiso2a vorgelegt. Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist.
customeremail XPath: /customer/email	E-Mail (255)	Die E-Mail-Adresse des Kunden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).
customertelephonetype XPath: /customer/telephone/@type	Saibling (1)	Die Art der Telefonnummer. Die verfügbaren Optionen sind: H = Heim M = Handy W = Arbeit
customertelephone XPath: /customer/telephone	Alphanumerisch einschließlich Symbole (20)	Die Telefonnummer des Kunden. Gültige Zeichen: Ziffern 0-9 Räume Sonderzeichen: + - ( )
customerprefixname XPath: /customer/name/prefix	Alphanumerisch einschließlich Symbole (25)	Der Präfixname des Kunden (z. B. Herr, Frau, Dr.).
customerfirstname XPath: /customer/name/first	Alphanumerisch einschließlich Symbole (127)	Den Vornamen des Kunden.
customermiddlename XPath: /customer/name/middle	Alphanumerisch einschließlich Symbole (127)	Der/die zweite(n) Name(n) des Kunden.
customerlastname XPath: /customer/name/last	Alphanumerisch einschließlich Symbole (127)	Der Nachname des Kunden. Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist.
customersuffixname XPath: /customer/name/suffix	Alphanumerisch einschließlich Symbole (25)	Der Suffixname des Kunden (z. B. Bsc).
customerforwardedip XPath: /customer/forwardedip	IP-Adresse (39)	Weitergeleitete IP-Adresse des Kunden, wie sie von einem Proxy-Server bereitgestellt wird, falls verfügbar.
customerip XPath: /customer/ip	IP-Adresse (39)	Die IP des Kunden.

Abrechnung

Die folgenden Felder enthalten die Abrechnung Einzelheiten:

Feld	Format	Beschreibung
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Sie können dieses Feld in der Anfrage ausfüllen, um das Datum anzugeben, an dem Sie Ihre Transaktion abrechnen möchten. Dieses Datum muss innerhalb von 7 Tagen nach dem Datum von Autorisierung liegen.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	Ein numerischer Wert, der zur Definition der Anweisung Abrechnung verwendet wird. Wenn Sie hier keinen Wert angeben, wird die settlestatus ist standardmäßig auf "0" eingestellt. Klicken Sie hier, um mehr über den Prozess Abrechnung zu erfahren.

AUTH Antwort

Im Folgenden finden Sie ein Beispiel für eine Antwort von AUTH , die anzeigt, dass die Anfrage erfolgreich bearbeitet wurde.

{
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>

Wenn Sie eine Antwort von AUTH erhalten, müssen Sie die Feldwerte überprüfen, um sicherzustellen, dass die Anfrage erfolgreich verarbeitet wurde.

Klicken Sie hier, um die empfohlenen Kontrollen durchzuführen.

Operation

Die folgenden Felder beziehen sich auf die Art des eingereichten Antrags:

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Die Art des zu verwendenden Kontos: "ECOM" - Elektronischer Geschäftsverkehr. "MOTO" - Versandhandel Telefonische Bestellung "RECUR" - Wiederkehrende Transaktionen
authmethod XPath: /operation/authmethod	Alpha (11)	Auth-Methoden werden verwendet, um festzulegen, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Jede authmethod hat eine andere Reihe von Anforderungen. Klicken Sie auf die folgenden Links, um mehr zu erfahren: PRE - Vor...Autorisierung FINAL - Finale Autorisierung INCREMENTAL - Inkrementell Autorisierung SPLIT - Gesplittete Sendung Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
credentialsonfile XPath: /operation/credentialsonfile	Numerisch (1)	Die zulässigen Werte für dieses Feld sind 0, 1 und 2. "0" - Keine Berechtigung für CoF oder keine Absicht, die Berechtigungsnachweise zu einem späteren Zeitpunkt wieder zu verwenden. "1" - Transaktionsnachweise werden als für die zukünftige Verwendung verfügbar gekennzeichnet. "2" - Zahlung mit zuvor gespeicherten Anmeldeinformationen. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator	Numerisch (1)	Zeigt an, ob die Transaktion als Kauf einer Kryptowährung gekennzeichnet ist: 1 - Die Transaktion wird als Kryptowährungskauf gekennzeichnet. 0 - Transaktion ist nicht als Kryptowährungskauf gekennzeichnet. Dieses Feld wird zurückgegeben, wenn es von der erwerbenden Bank zur Verfügung gestellt wird, andernfalls wird es nicht zurückgegeben.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Die transactionreference eines früheren Ersuchens, aus dem die wichtigsten Details hervorgegangen sind vererbt. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
requesttypedescription XPath: /@type	Alpha (20)	"AUTH" wird in der Antwort zurückgegeben.
scaexemptionindicator XPath: /operation/scaexemptionindicator	Numerisch (1)	Wird zurückgegeben, wenn die Transaktion als von EMV 3DS ausgenommen gekennzeichnet wurde. Klicken Sie hier, um mehr zu erfahren. Die folgenden Werte können zurückgegeben werden: 1 - Niedriger Wert 2 - Analyse des Transaktionsrisikos 3 - Vertrauenswürdiger Händler 4 - Sichere Unternehmenszahlung 5 - Authentifizierung delegiert

Rechnungsstellung

Die folgenden Felder enthalten die Rechnungsdaten des Kunden:

Feld	Format	Beschreibung
baseamount XPath: /billing/amount	Numerisch (13)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. 10€ wird als 1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - wenden Sie sich für weitere Informationen an Ihre Bank)
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dccenabled XPath: /billing/dcc/@enabled	Numerisch (1)	Zeigt an, ob Ihr Konto konfiguriert ist für DCC: 1= Ja 0 = Nein
issuer XPath: /billing/payment/issuer	Alphanumerisch (255)	Der Kartenaussteller des Kunden.
issuercountryiso2a XPath: /billing/payment/issuercountry	Alpha (2)	Das Land, in dem der Kartenaussteller des Kunden ansässig ist. Es wird im ISO2A-Format angegeben. Klicken Sie hier für eine vollständige Liste der Ländercodes.
maskedpan XPath: /billing/payment/pan	Alphanumerisch einschließlich "#" (12-19)	Wenn tokenisedpayment wird nicht zurückgegeben: Die maskedpan steht für die Kartennummer des Kunden. Wenn tokenisedpayment wird mit dem Wert 1 zurückgegeben: Die maskedpan steht für die eindeutige Token-Nummer des Kunden, die zur Durchführung der Transaktion verwendet wird. Der Wert von maskedpan Feld ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
tokenisedpayment XPath: /billing/payment/pan/@tokenised	Numerisch (1)	Wenn dieses Feld mit dem Wert 1 zurückgegeben wird, bedeutet dies, dass die Transaktion unter Verwendung eines Tokens verarbeitet wurde. Dieses Feld wird zurückgegeben, wenn die Zahlung mit einem Token durchgeführt wurde.
tokentype XPath: /billing/payment/pan/@tokentype	Alphanumerisch (50)	Dient zur Identifizierung der Art des für diese Zahlung verwendeten Tokens (z. B. "VISATOKEN"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einem Token durchgeführt wurde.
walletdisplayname XPath: /billing/payment/wallet/displayname	Alphanumerisch (255)	Diese enthält normalerweise die letzten vier Ziffern der Kartennummer des Kunden (z. B. "1111"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einer Brieftasche durchgeführt wurde.
walletsource XPath: /billing/payment/wallet/source	Alphanumerisch (20)	Dient zur Identifizierung der Art der für diese Zahlung verwendeten Brieftasche (z. B. "APPLEPAY"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einer Brieftasche durchgeführt wurde.

Händler

Die folgenden Felder beziehen sich auf Ihre Kontokonfiguration:

Feld	Format	Beschreibung
chargedescription XPath: /merchant/chargedescription	Alphanumerisch einschließlich Symbole (25)	Dies ist eine Beschreibung der Zahlung, die auf dem Kontoauszug des Kunden erscheint. Dies wird von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren. Die Spezifikation dieses Feldes hängt von Ihrer anwerbenden Bank ab. Klicken Sie hier für weitere Informationen. Gültige Zeichen: Großbuchstaben/Kleinbuchstaben A-Z Ziffern 0-9 Räume Zeichensetzung: + - _ . @ ( ) Dieses Feld wird zurückgesendet, wenn es an die erwerbende Bank gesendet wird.
merchantnumber XPath: /merchant/merchantnumber	Alphanumerisch (32)	Die Händlernummer, die zur Bearbeitung der Transaktion verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt.
merchantcategorycode XPath: /merchant/merchantcategorycode	Alphanumerisch (255)	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.
merchantcity XPath: /merchant/merchantcity	Alphanumerisch (127)
merchantcountryiso2a XPath: /merchant/merchantcountryiso2a	Alpha (2)
merchantname XPath: /merchant/merchantname	Alphanumerisch (255)
merchantstatecode XPath: /merchant/merchantstatecode	Alphanumerisch (127)
merchantzipcode XPath: /merchant/merchantzipcode	Alphanumerisch (10)
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
orderreference XPath: /merchant/orderreference	Alphanumerisch einschließlich Symbole (25)	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Hinweis: Dies kann zu einem späteren Zeitpunkt aktualisiert werden (nur wenn die Transaktion noch nicht abgeschlossen ist Abrechnung). Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
tid XPath: /merchant/tid	Alphanumerisch (255)	Die für die Bearbeitung der Transaktion verwendete Terminal-ID. Diese wird Ihrer Händlernummer zugeordnet, wenn wir Ihr Konto in unserem System einrichten.

Abrechnung

Die folgenden Felder enthalten die Abrechnung Einzelheiten:

Feld

Format

Beschreibung

settleduedate
XPath: /settlement/settleduedate

Datum JJJJ-MM-TT

Das Datum, an dem die Transaktion abgewickelt wird.

settlestatus
XPath: /settlement/settlestatus

Numerisch (3)

Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung in Bezug auf diese Transaktion anzuzeigen.

Klicken Sie hier für eine vollständige Liste der settlestatus Werte.

Status des Vorgangs

Zusätzlich zu den response Objekts werden in der Antwort auch zwei zusätzliche Felder zurückgegeben:

Feld	Format	Beschreibung
acquireradvicecode XPath: /acquireradvicecode	Numerisch (1)	Ein numerischer Wert, der nach einer wiederholten Zahlungsanforderung zurückgegeben wird und angibt, ob weitere Zahlungen verarbeitet werden können. Kartierung: 0 - Keine Maßnahme erforderlich. 1 - Neue Kontoinformationen verfügbar. 2 - Kann zum jetzigen Zeitpunkt nicht genehmigt werden. 4 - Keine weiteren wiederkehrenden Transaktionen verarbeiten. 8 - Zahlung durch Kartensystem gesperrt. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
acquirerresponsecode XPath: /acquirerresponsecode	Alphanumerisch (255)	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
acquirerresponsemessage XPath: /acquirerresponsemessage	Alphanumerisch (255)
authcode XPath: /authcode	Alphanumerisch (255)	Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich. Wird nur zurückgegeben, wenn die Transaktion genehmigt ist.
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
errormessage XPath: /error/message	Alphanumerisch (255)	Hier finden Sie eine kurze Erklärung für die Fehlerursache. Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
retrievalreferencenumber XPath: /other/retrievalreferencenumber	Alphanumerisch (255)	Ein ISO-Begriff. Dieser wird verwendet, um auf die Quelltransaktion zu verweisen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
securityresponseaddress XPath: /security/address	Numerisch (1)	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
securityresponsepostcode XPath: /security/postcode	Numerisch (1)
securityresponsesecuritycode XPath: /security/securitycode	Numerisch (1)
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird. Sie benötigen diese Referenz, um eine Erstattung durchzuführen oder die Transaktion zu aktualisieren.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.

Zusätzlich zu den response Objekts werden in der Antwort auch zwei zusätzliche Felder zurückgegeben:

Feld	Format	Beschreibung
requestreference	Alphanumerisch (25)	Dies ist ein internes Feld, das von Trust Payments erzeugt wird. Es muss nicht validiert werden. Bei Problemen mit der Anfrage kann dieses Feld vom Trust Payments Support angefordert werden, um die Ursache zu ermitteln.
secrand	Alphanumerisch (16)	Zufällige Zeichenkette, die in der Antwort von nicht-API-basierten Bibliotheken zurückgegeben wird, die von Trust Payments entwickelt wurden.

Weitere Lektüre zu diesem Thema