Umgang mit 3DS API Antworten

  Zuletzt aktualisiert: 

 

Wenn Sie eine Antwort auf eine über unser 3DS API gesendete Anfrage erhalten, muss Ihr System die folgenden Überprüfungen der zurückgegebenen Werte (sofern zutreffend) durchführen, um sicherzustellen, dass die Anfrage erfolgreich bearbeitet wurde.

 

Struktur der Antwort

Ihr System wird zahlreiche Felder im Antwortobjekt zurückerhalten. Sie müssen den Inhalt dieser Felder interpretieren, um sicherzustellen, dass es sich um die erwarteten Werte handelt.

Im Folgenden finden Sie ein Beispiel für eine Antwort von THREEDLOOKUP:

Rohes JSON Roh-XML
{
"requestreference": "A3579dkvx",
"response": [{
"cachetoken": "XXXXX",
"errorcode": "0",
"errormessage": "Ok",
"maskedpan": "490049######0501",
"paymenttypedescription": "DELTA",
"requesttypedescription": "THREEDLOOKUP",
"threedstransactionid": "733ab129-1126-4b80-97a4-f3d8fee9c564",
"threedversion": "2.2.0",
"transactionstartedtimestamp": "2022-05-24 12:59:27"
}],
"secrand": "VqOIoVXOJP7rZuxw",
"version": "1.00"
}

 

Fehlercode

Die Seite errorcode ist ein grundlegend wichtiges Feld, da es das Ergebnis der eingereichten Anfrage anzeigt. Ihr System muss den zurückgegebenen Code überprüfen und die Situation entsprechend dem zurückgegebenen Code behandeln. Im Folgenden finden Sie eine Liste der üblichen errorcode Werte, die zurückgegeben werden können und die Ihr System erwarten und verarbeiten können sollte:

Fehlercode 22000 - Umgehung

Errorcode 22000 wird zurückgegeben, wenn die paymenttypedescription für 3-D Secure nicht unterstützt wird. Wenn dieser Fehler zurückgegeben wird, können Sie mit der Zahlung fortfahren, obwohl Sie sich bewusst sein sollten, dass es in diesem Szenario keine Haftungsumkehr gibt.

Rohes JSON Roh-XML
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"errorcode": "22000",
"errormessage": "Bypass",
"requesttypedescription": "ERROR",
"transactionreference": "44-2-81001",
"transactionstartedtimestamp": "2022-03-29 06:43:42"
}],
"secrand":"zO9"
}
Fehlercode 60031 - Ungültiger Erwerber für 3-D Secure

Errorcode 60031 wird zurückgegeben, wenn die Bank des Kunden für 3-D Secure nicht unterstützt wird. Wenn dieser Fehler zurückgegeben wird, können Sie mit der Zahlung fortfahren, obwohl Sie sich bewusst sein sollten, dass es in diesem Szenario keine Haftungsumkehr gibt.

Rohes JSON Roh-XML
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription": "ECOM",
"errorcode": "60031",
"errormessage": "Invalid acquirer for 3-D Secure",
"issuercountryiso2a": "US",
"livestatus": "0",
"maskedpan": "630485######0701",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "00000000",
"operatorname": "webservices@example.com",
"paymenttypedescription": "LASER",
"requesttypedescription": "THREEDQUERY",
"tid": "27882788",
"transactionreference": "44-2-81003",
"transactionstartedtimestamp": "2022-03-28 19:57:15",
"settleduedate": "2022-03-28",
"settlestatus": "0"
}],
"secrand":"zO9"
}

 

Eingeschrieben

Wenn die Antwort THREEDQUERY Folgendes enthält enrolled mit dem Wert "N", bedeutet dies, dass die Karte nicht in einem 3-D Secure System angemeldet ist. Bevor Sie eine Autorisierung -Anfrage mit einer nicht registrierten Karte durchführen, müssen Sie zunächst den Wert des Parameters issuercountryiso2a zurückgegeben, um das Land zu ermitteln, in dem die Karte ausgestellt wurde. Wenn das Land des Ausstellers das Vereinigte Königreich oder der EWR ist, können Sie darf nicht die Transaktion fortzusetzen, um die Bestimmungen von ZaDiRL einzuhalten. Befindet sich das Land des Emittenten jedoch außerhalb des Vereinigten Königreichs und des EWR, können Sie sich dafür entscheiden, die Transaktion fortzusetzen, wobei Sie davon ausgehen, dass keine Haftungsverlagerung stattfindet.

 

Anforderungstyp

Jede Antwort enthält eine requesttypedescription. Der Wert dieses Feldes, der in der Antwort zurückgegeben wird, sollte immer mit dem in der Anfrage angegebenen Wert übereinstimmen.

Wenn Sie requesttypedescription mit dem Wert "ERROR" erhalten, wurde die Anfrage möglicherweise nicht erfolgreich bearbeitet und Sie müssen der Sache nachgehen.

 

Live-Status

Dieser Wert wird in den Antwortmeldungen von THREEDQUERY zurückgegeben:

  • 0 - Testverarbeitung
  • 1 - Live-Verarbeitung

 

Zurück: Erste Schritte mit 3DS API  Nächste: Prüfung der reibungsfreien Strömung - Durchgang

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich