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.
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.
Feldspezifikation
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:
|
|
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:
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.
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:
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".
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: 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. |
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. |
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:
|
|
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). |
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:
|
|
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:
|
|
billingtelephone XPath: /billing/telephone |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden. Gültige Zeichen:
|
|
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). |
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:
|
|
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:
|
|
customertelephone XPath: /customer/telephone |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden. Gültige Zeichen:
|
|
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. |
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.
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:
|
|
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:
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.
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:
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: |
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. 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: Wenn tokenisedpayment wird mit dem Wert 1 zurückgegeben: |
|
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. |
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:
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. |
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. |
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:
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.
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) |
|
|
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. | |
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. |