Umgang mit 3DS API Antworten

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:

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

<responseblock version="3.67">
  <requestreference>A3579dkvx</requestreference>
  <response type="THREEDLOOKUP">
    <operation>
      <cachetoken>XXXXX</cachetoken>
    </operation>
    <billing>
      <payment type="DELTA">
        <pan>490049######0501</pan>
      </payment>
    </billing>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <threedsecure>
      <transactionid>733ab129-1126-4b80-97a4-f3d8fee9c564</version>
    </threedsecure>
    <timestamp>2022-05-24 12:59:27</timestamp>
  </response>
  <secrand>VqOIoVXOJP7rZuxw</secrand>
</responseblock></responseblock>

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:

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

<responseblock version="3.67">
  <requestreference>X617j6u8v</requestreference>
  <response type="ERROR">
    <error>
      <code>22000</code>
      <message>Bypass</message>
    </error>
    <timestamp>2022-03-29 06:43:42</timestamp>
    <transactionreference>44-2-81001</transactionreference>
  </response>
  <secrand>D2i8Z</secrand>
</responseblock>

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "accounttypedescription": "ECOM",
    "errorcode": "60031",
    "errormessage": "Invalid acquirer for 3D 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"
}

<responseblock version="3.67">
  <requestreference>Xpbt194u6</requestreference>
  <response type="THREEDQUERY">
    <billing>
      <payment type="LASER">
        <issuercountry>US</issuercountry>
        <pan>630485######0701</pan>
      </payment>
    </billing>
    <error>
      <code>60031</code>
      <message>Invalid acquirer for 3D Secure</message>
    </error>
    <live>0</live>
    <merchant>
      <merchantcountryiso2a>GB</merchantcountryiso2a>
      <merchantname>Test Merchant</merchantname>
      <merchantnumber>00000000</merchantnumber>
      <operatorname>webservices@example.com</operatorname>
      <tid>27882788</tid>
    </merchant>
    <operation>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
    <settlement>
      <settleduedate>2022-03-28</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <timestamp>2022-03-28 19:57:15</timestamp>
    <transactionreference>44-2-81003</transactionreference>
  </response>
  <secrand>bUQL</secrand>
</responseblock>

Eingeschrieben

Wenn die Antwort THREEDQUERY Folgendes enthält enrolled Wenn der Wert „N“ angezeigt wird, bedeutet dies, dass die Karte nicht für das 3D Secure registriert ist. Bevor Sie eine Autorisierung mit einer nicht registrierten Karte durchführen, müssen Sie zunächst den Wert des 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 PSD2 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 Weiter: Übersicht über den reibungslosen Ablauf