Wanneer u een antwoord ontvangt na een verzoek via onze 3DS API, moet uw systeem de volgende controles uitvoeren op de geretourneerde waarden (indien van toepassing) om er zeker van te zijn dat het verzoek met succes is verwerkt.
Antwoordstructuur
Uw systeem krijgt talrijke velden terug in het antwoordobject. U zult de inhoud van deze velden moeten interpreteren om er zeker van te zijn dat het de verwachte waarden zijn.
Hieronder volgt een voorbeeld van een antwoord op 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>
Foutcode
De errorcode is een fundamenteel belangrijk veld, omdat het het resultaat van het ingediende verzoek weergeeft. Uw systeem moet de geretourneerde code controleren en de situatie afhandelen overeenkomstig de geretourneerde code. Hieronder volgt een lijst van gebruikelijke errorcode waarden die kunnen worden teruggezonden en die uw systeem moet verwachten en kunnen verwerken:
Errorcode 22000 wordt geretourneerd als de paymenttypedescription niet wordt ondersteund voor 3-D Secure. Als deze fout wordt geretourneerd, kunt u doorgaan met betalen, maar houd er rekening mee dat er in dit scenario geen verschuiving van aansprakelijkheid plaatsvindt.
{
"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>
Errorcode 60031 wordt geretourneerd als de bank van de klant niet wordt ondersteund voor 3-D Secure. Als deze fout wordt geretourneerd, kunt u doorgaan met betalen, maar houd er rekening mee dat er in dit scenario geen verschuiving van de aansprakelijkheid plaatsvindt.
{
"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"
}
<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 3-D 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>
Ingeschreven
Als het antwoord op THREEDQUERY het volgende bevat enrolled met de waarde "N", betekent dit dat de kaart niet is geregistreerd in een 3-D Secure schema. Voordat je verder gaat met een autorisatie verzoek met een niet-ingeschreven kaart, moet je eerst de waarde van de issuercountryiso2a veld terug om het land te bepalen waar de kaart is uitgegeven. Als het land van uitgifte het VK is of binnen de EER ligt, kun je mag niet Ga door met de transactie om in overeenstemming te blijven met PSD2. Als het land van de emittent echter buiten het VK en de EER ligt, kunt u ervoor kiezen om door te gaan met de transactie met dien verstande dat er geen verschuiving van aansprakelijkheid zal zijn.
Verzoektype
Elk antwoord bevat een requesttypedescription. De waarde van dit veld in het antwoord moet altijd overeenkomen met de waarde in het verzoek.
Als u requesttypedescription met de waarde "ERROR" ontvangt, is het verzoek misschien niet met succes verwerkt en moet u het onderzoeken.
Live status
Deze waarde wordt geretourneerd in THREEDQUERY antwoordberichten:
- 0 - Testverwerking
- 1 - Live verwerking
Terug: Aan de slag met 3DS APIVolgende: Testen van wrijvingsloze stroming - Doorloop
