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.
Lesen Sie diesen Artikel, um mehr zu erfahren.
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.
Die PAN_ONLY authmethod unten beschriebene Funktion erfordert eine 3DS-Authentifizierung.
In diesem Dokument wird davon ausgegangen, dass Sie eine direkte Integration mit Google Pay konfiguriert haben und die Anleitung von befolgt haben, wie Sie das Zahlungs-Token Google Pay payload (Link zu externer Seite) verwenden und das Gateway TRU Connect für die Verarbeitung der Zahlung nutzen möchten.
Über Authentifizierungsmethoden
Jede Google Pay Transaktion kann auf zwei verschiedene Arten authentifiziert werden:
- PAN_ONLY - Eine im Google-Konto des Kunden gespeicherte Karte.
- CRYPTOGRAM_3DS - Ein Gerätetoken, der auf einem mit Android betriebenen Gerät gespeichert ist und mit einem 3-D Secure Kryptogramm authentifiziert wird.
Wenn Ihre Google Pay -Integration so konfiguriert ist, dass sie sowohl PAN_ONLY als auch CRYPTOGRAM_3DS Authentifizierungsmethoden unterstützt , müssen Sie feststellen, welche dieser beiden Authentifizierungsmethoden für jede Transaktion durchgeführt wurde. Dies ist wichtig, da die von der Google Pay API zurückgegebene Authentifizierungsmethode die nächsten Schritte vorgibt, die Ihr System durchführen muss, um die Zahlung abzuschließen.
Um die für eine bestimmte Transaktion verwendete Authentifizierungsmethode zu überprüfen, müssen Sie die verschlüsselte Nachricht entschlüsseln, die im Zahlungs-Token von der API Google Pay zurückgegeben wird. Konkret müssen Sie das Feld paymentMethodDetails > authMethod und prüfen, ob der Wert PAN _ONLY oder CRYPTOGRAM_3DS lautet.
Wenn PAN_ONLY in der authMethodzurückgegeben wird, müssen Sie die Transaktion zunächst mit 3-D Secure authentifizieren. Wenn die Karte registriert und erfolgreich authentifiziert wurde, sind Sie im Besitz der unten aufgeführten Felder, die in der Anfrage AUTH erforderlich sind:
Ergebnisdaten vom Anbieter 3-D Secure :
- cavv
- eci
- eingeschrieben
- Status
- threedversion
- threeddirectorytransactionreference
Die Felder müssen unter AUTH eingereicht werden, sofern vorhanden.
Zahlungsangaben aus der Antwort Google Pay :
-
pan
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ pan -
expirydate
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear -
walletdisplayname
Gemappt von:
paymentMethodData ≫ info
Wenn Sie beabsichtigen, die Rechnungs- und Lieferdaten des Kunden aus seiner Google Wallet zu erfassen, müssen Sie auch die Antwort der Google API auf diese Felder analysieren und sie den entsprechenden Feldern in der nachfolgenden AUTH Anfrage zuordnen.
Vor der Übermittlung der AUTH!
Nicht registrierte Karten
Wenn sowohl Ihr Unternehmen als auch die Bank des Karteninhabers ihren Sitz im Europäischen Wirtschaftsraum (EWR) oder im Vereinigten Königreich haben, muss Ihre Implementierung mit der Zahlungsdiensterichtlinie (PSD2) übereinstimmen.
PSD2 verlangt, dass Online-Kartenzahlungen über 3-D Secure abgewickelt werden. Wenn eine Karte nicht registriert ist, wird empfohlen, die Transaktion zu stoppen und dem Kunden eine alternative Zahlungsmethode anzubieten.
Wenn Sie die oben erwähnten rechtlichen Auswirkungen bedacht haben und fortfahren dürfen, muss Ihr System eine AUTH Anfrage erstellen und manuell einreichen, um die Zahlung mit einer nicht registrierten Karte abzuschließen. Klicken Sie hier für die vollständige Spezifikation.
Nicht authentifizierte Karten
Wir raten dringend davon ab, mit der Transaktion fortzufahren, wenn die status ist 'N' oder 'R':
- Wenn status ist 'N', bedeutet dies, dass der Kunde nicht authentifiziert wurde.
- Wenn status ist 'R', bedeutet dies, dass die Authentifizierung abgelehnt wurde.
AUTH Beispiel anfordern
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}
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(
'baseamount' => '2000',
'currencyiso3a' => 'GBP',
'expirydate' => '07/2026',
'pan' => '5100000000000511',
'requesttypedescriptions' => ["AUTH"],
'sitereference' => 'test_site12345',
'cavv' => 'Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=',
'eci' => '05',
'enrolled' => 'Y',
'status' => 'Y',
'threedversion' => '2.2.0',
'threeddirectorytransactionreference' => 'f00e1111-0011-00a6-ab00-a00000a00000',
'walletdisplayname' => 'MasterCard 0511',
'orderreference' => 'My_Order_123',
'walletsource' => 'GOOGLEPAY'
);
$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":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions":["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions":["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<billing>
<payment>
<expirydate>07/2026</expirydate>
<pan>5100000000000511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
<amount currencycode="GBP">2000</amount>
</billing>
<merchant>
<orderreference>My_Order_123</orderreference>
</merchant>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<threedsecure>
<cavv>Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<version>2.2.0</version>
<directorytransactionreference>f00e1111-0011-00a6-ab00-a00000a00000</directorytransactionreference>
</threedsecure>
</request>
</requestblock>
AUTH Feldspezifikation anfordern
Feld | Zuordnung zu Feldern aus Google paymentData | Format | Beschreibung | |
accounttypedescription XPath: /operation/accounttypedescription |
K.A. | Alpha (20) | Reichen Sie "ECOM" ein, um eine E-Commerce-Transaktion darzustellen. | |
baseamount XPath: /billing/amount |
K.A. | 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. |
|
currencyiso3a XPath: /billing/amount/@currencycode |
K.A. | Alpha (3) | Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. | |
eingeschrieben XPath: /threedsecure/einschreiben |
K.A. | Saibling (1) |
Geben Sie "Y" ein, um anzuzeigen, dass die Karte registriert ist. |
|
expirydate XPath: /billing/payment/expirydate |
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear |
Datum MM/JJJJ |
Das auf der Karte aufgedruckte Ablaufdatum. Sie müssen die von Google zurückgegebenen Felder expirationMonth und expirationYear kombinieren und diese im Format "MM/YYYY" in der Anfrage AUTH übermitteln. |
|
pan XPath: /billing/payment/pan |
encryptedMessage ≫ paymentMethodDetails ≫ pan |
Numerisch (12-19) | Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist. | |
requesttypedescriptions XPath: /@type |
K.A. | Alpha (20) |
Unterstützte Kombinationen Anforderungstyp :
Klicken Sie hier, um mehr über die Antragsarten zu erfahren. |
|
sitereference XPath: /operation/sitereference |
K.A. |
Alphanumerisch & Unterstrich (50) |
Identifiziert Ihre Website auf dem System Trust Payments . | |
status XPath: /threedsecure/status |
K.A. | Saibling (1) |
Zeigt an, ob der Kunde im ACS des Kartenausstellers authentifiziert wurde oder nicht:
|
|
walletdisplayname XPath:/billing/payment/wallet/displayname |
paymentMethodData ≫ info |
Numerisch (4) |
Hierbei handelt es sich um Informationen des Kartenausstellers, die dem Kunden angezeigt werden können, um die Zahlungsmethode zu identifizieren. Dazu gehören in der Regel die letzten 4 Ziffern der Kartennummer. Das Info-Objekt enthält zwei Eigenschaften, die Sie in das Feld walletdisplayname übertragen müssen. Sie sollten die Eigenschaften cardNetwork & cardDetails-Eigenschaftswerte analysieren und miteinander kombinieren, z. B. |
|
walletsource XPath: /billing/payment/wallet/source |
K.A. | Alpha (8) | Muss mit dem Wert "GOOGLEPAY" eingereicht werden. | |
billingfirstname XPath: /billing/name/first |
billingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der Kunde ist Rechnungsvorname. Erforderlich für Glücksspielanbieter. |
|
billinglastname XPath: /billing/name/last |
billingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der Kunde ist Rechnungsnachname. Erforderlich für Glücksspielanbieter. |
|
cavv XPath: /threedsecure/cavv |
K.A. | Alphanumerisch (56) |
Die eindeutige Cardholder Authentication Verification Value (CAVV), die mit der Transaktion verbunden ist. Geben Sie diesen Wert immer an, wenn er verfügbar ist.
|
|
customerpostcode XPath: /customer/postcode |
shippingAddress ≫ Postleitzahl | Alphanumerisch (25) |
Die Postleitzahl des Kunden. 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. |
|
customerlastname XPath: /customer/name/last |
shippingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der letzte Name in der Lieferadresse des Kunden. Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist. |
|
eci XPath: /threedsecure/eci |
K.A. | Alphanumerisch (2) |
Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Geben Sie diesen Wert immer an, wenn er verfügbar ist. Klicken Sie hier, um mehr über mögliche ECI Werte zu erfahren. |
|
threedversion XPath: /threedsecure/version |
K.A. | Numerisch (6) |
Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.2.0") Geben Sie diesen Wert immer an, wenn er verfügbar ist.
|
|
threeddirectorytransactionreference XPath: /threedsecure/directorytransactionreference |
K.A. | Alphanumerisch (48) |
Einzigartige DSTransactionId von Ihrem MPI Anbieter zurückgegeben. Geben Sie diesen Wert immer an, wenn er verfügbar ist.
|
|
billingcountryiso2a XPath: /billing/country |
billingAddress ≫ countryCode | Alpha (2) |
Das Land der Rechnungsadresse des Kunden. Diese muss im ISO2A-Format vorliegen. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
billingemail XPath: /billing/email |
K.A. | E-Mail (255) | Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen). | |
billingpostcode XPath: /billing/postcode |
billingAddress ≫ postalCode | Alphanumerisch (25) |
Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt. |
|
billingpremise XPath: /billing/premise |
billingAddress ≫ Adresse1 |
Alphanumerisch einschließlich Symbole (25) |
Der Hausname/die Hausnummer in der Rechnungsadresse des Kunden. | |
billingtelephone XPath: /billing/telephone |
billingAddress ≫ phoneNumber |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden für die Rechnungsstellung. Gültige Zeichen:
|
|
billingtown XPath: /billing/town |
billingAddress ≫ Ortschaft |
Alphanumerisch einschließlich Symbole (127) |
Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde. | |
customercountryiso2a XPath: /customer/country |
shippingAddress ≫ countryCode | Alpha (2) |
Das Land der Lieferadresse des Kunden. Es muss im ISO2A-Format angegeben werden. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
customeremail XPath: /customer/email |
K.A. | E-Mail (255) | Die Liefer-E-Mail-Adresse des Kunden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol). | |
customerfirstname XPath: /customer/name/first |
shippingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der erste Name in der Lieferadresse des Kunden. |
|
customerpremise XPath: /customer/premise |
shippingAddress ≫ Adresse1 |
Alphanumerisch einschließlich Symbole (25) |
Der Hausname/die Hausnummer auf der Lieferadresse des Kunden. | |
customertelephone XPath: /customer/telephone |
shippingAddress ≫ TelefonNummer |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden für die Zustellung. Gültige Zeichen:
|
|
customertown XPath: /customer/town |
shippingAddress ≫ Ortschaft |
Alphanumerisch einschließlich Symbole (127) |
Die Stadt in der Lieferadresse des Kunden. | |
orderreference XPath: /merchant/orderreference |
K.A. |
Alphanumerisch einschließlich Symbole (25) |
Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. |
|
paymenttypedescription XPath: /billing/payment/@type |
K.A. | Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). |
AUTH Beispiel für eine Antwort
Nach dem Absenden der Anfrage AUTH erhalten Sie eine Antwort von AUTH :
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST09',
u 'authmethod': u 'FINAL',
u 'baseamount': u '2000',
u 'cavv': u 'Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=',
u 'currencyiso3a': u 'GBP',
u 'customeroutput': u 'RESULT',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'JP',
u 'livestatus': u '0',
u 'maskedpan': u '510000######0511',
u 'merchantcategorycode': u '1234',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'orderreference': u 'My_Order_123',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-03-22',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'GOOGLEPAY'
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(36) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST09"
["authmethod"] => string(4) "FINAL"
["baseamount"] => string(4) "2000"
["cavv"] => string(28) "Q0FWVkNBVlZDQVZWQ0FWVkNBVlY="
["currencyiso3a"] => string(3) "GBP"
["debtrepayment"] => string(1) "0"
["customeroutput"] => string(6) "RESULT"
["eci"] => string(2) "02"
["enrolled"] => string(1) "Y"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuercountryiso2a"] => string(2) "JP"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "510000######0511"
["merchantcategorycode"] => string(4) "1234"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(8) "00000000"
["operatorname"] => string(13) "webservices@example.com"
["orderreference"] => string(12) "My_Order_123"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-03-22"
["settlestatus"] => string(1) "0"
["splitfinalnumber"] => string(1) "1"
["status] => string(1) "Y"
["threedversion"] => string(5) "2.2.0"
["tid"] => string(8) "27882788"
["transactionreference"] => string(11) "36-9-286248"
["transactionstartedtimestamp"] => string(19) "2023-03-22 09:34:31"
["walletdisplayname"] => string(19) "MasterCard 0511"
["walletsource"] => string(8) "GOOGLEPAY"
}
}
}
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription": "ECOM",
"acquirerresponsecode": "00",
"authcode": "5",
"authmethod": "FINAL",
"baseamount": "2000",
"cavv": "Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"currencyiso3a": "GBP",
"customeroutput": "RESULT",
"debtrepayment": "0",
"eci": "05",
"enrolled": "Y",
"errorcode": "0",
"errormessage": "Ok",
"issuercountryiso2a": "ZZ",
"livestatus": "1",
"maskedpan": "510000######0511",
"merchantcountryiso2a": "GB",
"merchantname": "Live Unittest Site <>&!_-=+@#:;,./?OK",
"merchantnumber": "98965325",
"operatorname": "webservices@merchant.com",
"orderreference": "My_Order_123",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "AUTH",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-09-11",
"settlestatus": "0",
"status": "Y",
"threedversion": "2.2.0",
"tid": "27887756",
"transactionreference": "16-14-110",
"transactionstartedtimestamp": "2023-09-11 13:52:55",
"walletdisplayname": "MasterCard 0511",
"walletsource": "GOOGLEPAY"
}],
"secrand":"zO9"
}
<?xml version='1.0' encoding='utf-8'?>
<responseblock version="3.67">
<requestreference>Xpdpuy1q7</requestreference>
<response type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>11</authcode>
<billing>
<amount currencycode="GBP">2000</amount>
<payment type="MASTERCARD">
<issuercountry>ZZ</issuercountry>
<pan>510000######0511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Merchant123</merchantname>
<merchantnumber>98965325</merchantnumber>
<operatorname>Merchant</operatorname>
<orderreference>My_Order_123</orderreference>
<tid>27887756</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<authmethod>FINAL</authmethod>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-09-12</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<cavv>Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<version>2.2.0</version>
</threedsecure>
<timestamp>2023-09-12 08:32:35</timestamp>
<transactionreference>16-14-116</transactionreference>
</response>
<secrand>dOtpy</secrand>
</responseblock>
AUTH Spezifikation des Antwortfeldes
Feld | Format | Beschreibung | |
accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "ECOM" wird in der Antwort zurückgegeben, um eine E-Commerce-Transaktion darzustellen. | |
authmethod XPath: /operation/authmethod |
Alpha (11) |
Die authmethod gibt an, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Sie sollten erwarten, dass einer der folgenden Werte zurückgegeben wird, um die authmethod beschäftigt. Klicken Sie auf die folgenden Links, um mehr zu erfahren:
Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde. |
|
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. | |
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) | Da Google Pay DCC nicht unterstützt, wird "0" zurückgegeben, um anzuzeigen, dass DCC für diese Transaktion deaktiviert ist. | |
debtrepayment XPath: /merchant/debtrepayment |
Numerisch (1) |
Zeigt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist. Klicken Sie hier, um mehr zu erfahren. |
|
eci XPath: /threedsecure/eci |
Alphanumerisch (2) | Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren. | |
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 Nachricht Werte. |
|
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 Nachricht Werte. |
|
issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Das Land des Kartenausstellers des Kunden. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
livestatus XPath: /live |
Numerisch (1) |
|
|
maskedpan XPath: /billing/payment/pan |
Alphanumerisch einschließlich "#" (12-19) | Die maskedpan steht für die Kartennummer des Kunden. 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. | |
operatorname XPath: /merchant/operatorname |
Alphanumerisch (255) | Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. | |
paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). | |
requesttypedescription XPath: /@type |
Alpha (20) | "AUTH" wird in der Antwort zurückgegeben. | |
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) | ||
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. |
|
splitfinalnumber XPath: /operation/splitfinalnumber |
Numerisch (2) | Da Google Pay keine geteilten Sendungen unterstützt, wird eine "1" zurückgegeben, um anzuzeigen, dass der Betrag in einem Durchgang beglichen wird. | |
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. | |
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. | |
walletdisplayname XPath: /billing/payment/wallet/displayname |
Alphanumerisch (255) | Die vom Kunden verwendete Kartenart und die letzten vier Ziffern seiner Kartennummer (z. B. "Visa 1111"). | |
walletsource XPath: /billing/payment/wallet/source |
Alphanumerisch (20) | Wird verwendet, um die Art der für diese Zahlung verwendeten Geldbörse zu identifizieren (in diesem Fall "GOOGLEPAY"). | |
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. |
|
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. |
|
errordata XPath: /error/data |
Alphanumerisch (255) |
Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
|
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) | ||
orderreference XPath: /merchant/orderreference |
Alphanumerisch einschließlich Symbole (25) |
Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde. |
Wenn CRYPTOGRAM_3DS zurückgegeben wird authMethodzurückgegeben wird, müssen Sie keine 3-D secure Authentifizierung durchführen.
3-D Secure Authentifizierung ist nicht erforderlich für die CRYPTOGRAM_3DS Authentifizierungsmethode nicht erforderlich, da der Authentifizierungsprozess bereits von Google im Namen des Kartenausstellers unter Verwendung der auf dem Gerät des Kunden Android gespeicherten Anmeldeinformationen durchgeführt wird. Dies steht im Einklang mit den Anforderungen des Mandats Starke Kundenauthentifizierung (SCA).
Nach der Antwort von Google Pay sollten Sie im Besitz der unten aufgeführten Felder sein, die in der Anfrage AUTH erforderlich sind:
Zahlungsangaben aus der Antwort Google Pay :
-
pan
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ pan -
expirydate
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear -
walletdisplayname
Gemappt von:
paymentMethodData ≫ info -
tavv
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ cryptogram -
eci
Gemappt von:
encryptedMessage ≫ paymentMethodDetails ≫ eciIndicator
Wenn Sie beabsichtigen, die Rechnungs- und Lieferdaten des Kunden aus seiner Google Wallet zu erfassen, müssen Sie auch die Antwort der Google API auf diese Felder analysieren und sie den entsprechenden Feldern in der nachfolgenden AUTH Anfrage zuordnen.
AUTH Beispiel anfordern
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference":"test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}
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' => 'ECOM',
'baseamount' => '2000',
'currencyiso3a' => 'GBP',
'eci' => '2',
'expirydate' => '07/2026',
'orderreference' => 'My_Order_123',
'pan' => '5100000000000511',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => 'test_site12345',
'tavv' => 'ALFoEd4DhmGzAIj3dUo4AoABFA==',
'tokenisedpayment' => '1',
'tokentype' => 'GOOGLEPAY',
'walletdisplayname' => 'MasterCard 0511',
'walletsource' => 'GOOGLEPAY'
);
$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":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"orderreference": "My_Order_123",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"orderreference": "My_Order_123",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<billing>
<payment>
<expirydate>07/2026</expirydate>
<pan tokenised="1" tokentype="GOOGLEPAY">5100000000000511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
<amount currencycode="GBP">2000</amount>
</billing>
<merchant>
<orderreference>My_Order_123</orderreference>
</merchant>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<threedsecure>
<eci>2</eci>
<tavv>ALFoEd4DhmGzAIj3dUo4AoABFA==</tavv>
</threedsecure>
</request>
</requestblock>
AUTH Feldspezifikation anfordern
Feld | Zuordnung zu Feldern aus Google paymentData | Format | Beschreibung | |
accounttypedescription XPath: /operation/accounttypedescription |
K.A. | Alpha (20) | Reichen Sie "ECOM" ein, um eine E-Commerce-Transaktion darzustellen. | |
baseamount XPath: /billing/amount |
K.A. | 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. |
|
currencyiso3a XPath: /billing/amount/@currencycode |
K.A. | Alpha (3) | Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. | |
eci XPath: /threedsecure/eci |
encryptedMessage ≫ paymentMethodDetails ≫ eciIndicator | Alphanumerisch (2) | Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren. | |
expirydate XPath: /billing/payment/expirydate |
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear | Datum MM/JJJJ |
Sie müssen die von Google zurückgegebenen Felder expirationMonth und expirationYear kombinieren und diese im Format "MM/YYYY" in der Anfrage AUTH übermitteln. |
|
pan XPath: /billing/payment/pan |
encryptedMessage ≫ paymentMethodDetails ≫ pan | Numerisch (12-19) | Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist. | |
requesttypedescriptions XPath: /@type |
K.A. | Alpha (20) |
Unterstützte Kombinationen Anforderungstyp :
Klicken Sie hier, um mehr über die Antragsarten zu erfahren. |
|
sitereference XPath: /operation/sitereference |
K.A. |
Alphanumerisch & Unterstrich (50) |
Identifiziert Ihre Website auf dem System Trust Payments . | |
tavv XPath: /threedsecure/tavv |
encryptedMessage ≫ paymentMethodDetails ≫ Kryptogramm | Alphanumerische Zeichen und Sonderzeichen (32) | Token Authentifizierung Verifizierungswert | |
tokenisedpayment XPath: /abrechnung/zahlung/pan/@tokenised |
K.A. | Numerisch (1) | Senden Sie mit dem Wert "1", um anzugeben, dass die Transaktion mit einem Token verarbeitet wird. | |
tokentype XPath: /abrechnung/zahlung/pan/@tokentype |
K.A. | Alpha (50) | Muss mit dem Wert "GOOGLEPAY" eingereicht werden. | |
walletdisplayname XPath:/billing/payment/wallet/displayname |
paymentMethodData ≫ info |
Numerisch (4) |
Hierbei handelt es sich um Informationen des Kartenausstellers, die dem Kunden angezeigt werden können, um die Zahlungsmethode zu identifizieren. Dazu gehören in der Regel die letzten 4 Ziffern der Kartennummer. Das Info-Objekt enthält zwei Eigenschaften, die Sie in das Feld walletdisplayname übertragen müssen. Sie sollten die Werte der Eigenschaften cardNetwork und cardDetails analysieren und sie miteinander kombinieren, z. B. |
|
walletsource XPath: /billing/payment/wallet/source |
K.A. | Alpha (8) | Muss mit dem Wert "GOOGLEPAY" eingereicht werden. | |
billingfirstname XPath: /billing/name/first |
billingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der Kunde ist Rechnungsvorname. Erforderlich für Glücksspielanbieter. |
|
billinglastname XPath: /billing/name/last |
billingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der Kunde ist Rechnungsnachname. Erforderlich für Glücksspielanbieter. |
|
customerpostcode XPath: /customer/postcode |
shippingAddress ≫ Postleitzahl | Alphanumerisch (25) |
Die Postleitzahl des Kunden. 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. |
|
customerlastname XPath: /customer/name/last |
shippingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der letzte Name in der Lieferadresse des Kunden. Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist. |
|
billingcountryiso2a XPath: /billing/country |
billingAddress ≫ countryCode | Alpha (2) |
Das Land der Rechnungsadresse des Kunden. Diese muss im ISO2A-Format vorliegen. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
billingemail XPath: /billing/email |
K.A. | E-Mail (255) | Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen). | |
billingpostcode XPath: /billing/postcode |
billingAddress ≫ postalCode | Alphanumerisch (25) |
Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt. |
|
billingpremise XPath: /billing/premise |
billingAddress ≫ Adresse1 |
Alphanumerisch einschließlich Symbole (25) |
Der Hausname/die Hausnummer in der Rechnungsadresse des Kunden. | |
billingtelephone XPath: /billing/telephone |
billingAddress ≫ phoneNumber |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden für die Rechnungsstellung. Gültige Zeichen:
|
|
billingtown XPath: /billing/town |
billingAddress ≫ Ortschaft |
Alphanumerisch einschließlich Symbole (127) |
Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde. | |
customercountryiso2a XPath: /customer/country |
shippingAddress ≫ countryCode | Alpha (2) |
Das Land der Lieferadresse des Kunden. Es muss im ISO2A-Format angegeben werden. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
customeremail XPath: /customer/email |
shippingAddress ≫ emailAddress | E-Mail (255) | Die Liefer-E-Mail-Adresse des Kunden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol). | |
customerfirstname XPath: /customer/name/first |
shippingAddress ≫ Name |
Alphanumerisch einschließlich Symbole (127) |
Der erste Name in der Lieferadresse des Kunden. |
|
customerpremise XPath: /customer/premise |
shippingAddress ≫ addressLines |
Alphanumerisch einschließlich Symbole (25) |
Der Hausname/die Hausnummer auf der Lieferadresse des Kunden. | |
customertelephone XPath: /customer/telephone |
shippingAddress ≫ TelefonNummer |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden für die Zustellung. Gültige Zeichen:
|
|
customertown XPath: /customer/town |
shippingAddress ≫ Ortschaft |
Alphanumerisch einschließlich Symbole (127) |
Die Stadt in der Lieferadresse des Kunden. | |
orderreference XPath: /merchant/orderreference |
K.A. |
Alphanumerisch einschließlich Symbole (25) |
Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. |
|
paymenttypedescription XPath: /billing/payment/@type |
K.A. | Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). |
AUTH Beispiel für eine Antwort
Nach dem Absenden der Anfrage AUTH erhalten Sie eine Antwort von AUTH :
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST09',
u 'authmethod': u 'FINAL',
u 'baseamount': u '2000',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '02',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'JP',
u 'livestatus': u '0',
u 'maskedpan': u '510000######0511',
u 'merchantcategorycode': u '1234',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'orderreference': u 'My_Order_123',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-03-22',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'tavv': u 'ALFoEd4DhmGzAIj3dUo4AoABFA==',
u 'tid': u '27882788',
u 'tokenisedpayment': u '1',
u 'tokentype': u 'GOOGLEPAY',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'GOOGLEPAY'
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(36) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST09"
["authmethod"] => string(4) "FINAL"
["baseamount"] => string(4) "2000"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["eci"] => string(2) "02"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuercountryiso2a"] => string(2) "JP"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "510000######0511"
["merchantcategorycode"] => string(4) "1234"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(8) "00000000"
["operatorname"] => string(13) "webservices@example.com"
["orderreference"] => string(12) "My_Order_123"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-03-22"
["settlestatus"] => string(1) "0"
["splitfinalnumber"] => string(1) "1"
["tavv"] => string(28) "ALFoEd4DhmGzAIj3dUo4AoABFA=="
["tid"] => string(8) "27882788"
["tokenisedpayment"] => string(1) "1"
["tokentype"] => string(9) "GOOGLEPAY"
["transactionreference"] => string(11) "36-9-286248"
["transactionstartedtimestamp"] => string(19) "2023-03-22 09:34:31"
["walletdisplayname"] => string(19) "MasterCard 0511"
["walletsource"] => string(8) "GOOGLEPAY"
}
}
}
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription": "ECOM",
"acquirerresponsecode": "00",
"authcode": "TEST09",
"authmethod": "FINAL",
"baseamount": "2000",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"eci": "02",
"errorcode": "0",
"errormessage": "Ok",
"issuercountryiso2a": "JP",
"livestatus": "0",
"maskedpan": "510000######0511",
"merchantcategorycode": "1234",
"orderreference": "My_Order_123",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "00000000",
"operatorname": "webservices@example.com",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "AUTH",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-03-22",
"settlestatus": "0",
"splitfinalnumber": "1",
"tavv": "ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tid": "27882788",
"tokenisedpayment": "1",
"tokentype": "GOOGLEPAY",
"transactionreference": "36-9-286248",
"transactionstartedtimestamp": "2023-03-22 09:34:31",
"walletdisplayname": "MasterCard 0511",
"walletsource": "GOOGLEPAY"
}],
"secrand":"zO9"
}
<responseblock version="3.67">
<requestreference>A3579dkvx</requestreference>
<response type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>TEST09</authcode>
<billing>
<amount currencycode="GBP">2000</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuercountry>JP</issuercountry>
<pan tokenised="1" tokentype="GOOGLEPAY">510000######0511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>0</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>1234</merchantcategorycode>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>00000000</merchantnumber>
<operatorname>webservices@example.com</operatorname>
<orderreference>My_Order_123</orderreference>
<tid>27882788</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<authmethod>FINAL</authmethod>
<splitfinalnumber>1</splitfinalnumber>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-03-22</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<eci>02</tavv>
<tavv>ALFoEd4DhmGzAIj3dUo4AoABFA==</tavv>
</threedsecure>
<timestamp>2023-03-22 09:34:31</timestamp>
<transactionreference>36-9-286248</transactionreference>
</response>
<secrand>hYWFMkiiAZ0wKHFZ</secrand>
</responseblock>
AUTH Spezifikation des Antwortfeldes
Feld | Format | Beschreibung | |
accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "ECOM" wird in der Antwort zurückgegeben, um eine E-Commerce-Transaktion darzustellen. | |
authmethod XPath: /operation/authmethod |
Alpha (11) |
Die authmethod gibt an, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Sie sollten erwarten, dass einer der folgenden Werte zurückgegeben wird, um die authmethod beschäftigt. Klicken Sie auf die folgenden Links, um mehr zu erfahren:
Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde. |
|
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. | |
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) | Da Google Pay DCC nicht unterstützt, wird "0" zurückgegeben, um anzuzeigen, dass DCC für diese Transaktion deaktiviert ist. | |
debtrepayment XPath: /merchant/debtrepayment |
Numerisch (1) |
Zeigt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist. Klicken Sie hier, um mehr zu erfahren. |
|
eci XPath: /threedsecure/eci |
Alphanumerisch (2) | Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren. | |
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 Nachricht Werte. |
|
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 Nachricht Werte. |
|
issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Das Land des Kartenausstellers des Kunden. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
livestatus XPath: /live |
Numerisch (1) |
|
|
maskedpan XPath: /billing/payment/pan |
Alphanumerisch einschließlich "#" (12-19) | Die maskedpan steht für die Kartennummer des Kunden. 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. | |
operatorname XPath: /merchant/operatorname |
Alphanumerisch (255) | Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. | |
paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). | |
requesttypedescription XPath: /@type |
Alpha (20) | "AUTH" wird in der Antwort zurückgegeben. | |
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) | ||
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. |
|
splitfinalnumber XPath: /operation/splitfinalnumber |
Numerisch (2) | Da Google Pay keine geteilten Sendungen unterstützt, wird eine "1" zurückgegeben, um anzuzeigen, dass der Betrag in einem Durchgang beglichen wird. | |
tavv XPath: /threedsecure/tavv |
Alphanumerische Zeichen und Sonderzeichen (32) | Token Authentifizierung Verifizierungswert | |
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. | |
tokenisedpayment XPath: /abrechnung/zahlung/pan/@tokenised |
Numerisch (1) | Wird mit dem Wert "1" zurückgegeben, um anzuzeigen, dass die Transaktion unter Verwendung eines Tokens verarbeitet wurde. | |
tokentype XPath: /abrechnung/zahlung/pan/@tokentype |
Alpha (50) | Rückgabe mit dem Wert "GOOGLEPAY", um anzuzeigen, dass Google Pay verwendet wurde. | |
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. | |
walletdisplayname XPath: /billing/payment/wallet/displayname |
Alphanumerisch (255) | Die vom Kunden verwendete Kartenart und die letzten vier Ziffern seiner Kartennummer (z. B. "Visa 1111"). | |
walletsource XPath: /billing/payment/wallet/source |
Alphanumerisch (20) | Wird verwendet, um die Art der für diese Zahlung verwendeten Geldbörse zu identifizieren (in diesem Fall "GOOGLEPAY"). | |
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. |
|
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. |
|
errordata XPath: /error/data |
Alphanumerisch (255) |
Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
|
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) | ||
orderreference XPath: /merchant/orderreference |
Alphanumerisch einschließlich Symbole (25) |
Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde. |