Appendix 5: Transaction Status
A transaction in Apata will conclude with one of the following states:
State |
Description |
---|---|
Succeeded |
The transaction was approved by the ACS and the result was returned to the directory server (payment scheme) successfully. A transaction in the SUCCEEDED state may have been approved frictionlessly or the cardholder completed SCA successfully. In the event that the challenge was approved frictionlessly, the exemption field will be set. See Exemption Values. |
Failed |
The cardholder failed to complete the challenge for SCA. If the state is FAILED then the reason field will be populated by one of the following:
|
Error |
An error occurred during the processing of the transaction. If the state is ERROR then the |
Timeout |
The cardholder failed to complete the challenge within the allotted period of time configured (as specified in the |
Aborted |
The 3DS requestor (usually a merchant) sent an authentication request (AReq), but never followed up with a challenge request (CReq) when Apata determined that a challenge was required. |
Cancelled |
The transaction was cancelled either by the cardholder or by the 3DS requestor (usually a merchant). If the state is CANCELLED then the reason field will be set:
|
Rejected |
The ACS determined that the transaction could not proceed. This may be due to the card being blocked or TRA (Transaction Risk Analysis) determining that the transaction is too risky. Possible reason values are:
|
Exemption Codes
Value |
Description |
---|---|
LOW_VALUE_PAYMENT |
For cards issued where PSD2 applies (EEA/UK) the low value payment exemption described under PSD2 was applied. This exemption can be applied if the following conditions are met:
|
LOW_RISK |
The transaction has been determined to be low risk using transaction risk analysis (TRA) performed by either Apata’s risk engine or a customer specified risk engine. The maximum value that may be exempted using TRA is determined by the institution’s fraud levels. |
WHITELISTED |
The cardholder previously opted to add the merchant to their Trust List of allowed merchants. This exempts future transactions for that merchant from challenges. SCA must be performed in order to add a merchant to the Trust List. |
RECURRING |
The transaction is a fixed, recurring payment for a particular merchant and the first payment of the recurring transaction was challenged. This allows subsequent payments for the same amount and the same merchant to be exempted from SCA. |
ACQUIRER_EXEMPTION |
The merchant has requested an exemption from SCA as they have already applied either transaction risk analysis (TRA) or performed SCA. |
SECURE_CORPORATE_PAYMENT |
The transaction falls under the secure corporate payment exemption as outlined by PSD2. |
ONE_LEG_TRANSACTION |
The transaction has been exempted under PSD2’s one-leg transaction exemption. This exemption may be used when the acquirer is outside of the EEA. |
MERCHANT_INITIATED |
The transaction was exempted as the request was initiated by the merchant. In this case the cardholder is not present and as a result cannot perform a challenge. |
Decline Reasons
Reason |
Description |
---|---|
Card disabled |
The card has been disabled. Not applicable to Thredd clients. |
Card expired |
The card has expired. Not applicable to Thredd clients. |
Card not Enrolled |
The card is not enrolled in 3D Secure authentication. |
Challenge Attempts Exceeded |
The number of Challenge attempts configured for this Challenge Method has been exceeded (e.g., entering an incorrect OTP or KBA answer too many times). |
Challenge Retries Exceeded |
The number of Challenge retries configured for this Challenge Method has been exceeded (e.g., . asking for the OTP to be resent too many times). |
Low Confidence |
The risk engine determined that the transaction was too risky to continue. |
Required Details Missing |
The transaction was missing mandatory details required for authentication. |
Risk Engine Error |
There was an error on the Apata risk engine. |
Error Codes
Refer to the table below for a list of error codes.
State |
Description |
---|---|
ds_error |
The directory server (card scheme) returned an error when the Apata Access Control Server (ACS) attempted to report the success of the transaction. |
client_error |
The 3DS requestor (typically a merchant) experienced an error on their side and they reported the error to the ACS. |
validation_error |
One of the 3DS messages received by the ACS was invalid according to the 3DS protocol. |
decoupled_not_supported |
A decoupled transaction (valid only under 3DS 2.2+) was required, but the challenge method selected for the card does not support decoupled challenges. |
non_payment_not_supported |
The ACS has been configured not to support non-payment transactions, but a non-payment transaction was received. |
card_not_enrolled |
The card does not exist in the Apata ACS. |
webhook_call_failed |
The webhook call from the Apata ACS to Thredd failed. |
sms_send_failed |
The sending of the SMS to the cardholder failed. |
invalid_config |
The transaction cannot be completed due to invalid or incomplete configuration of the solution. |
internal_server_error |
Any error not classified above. |