Soft declines
Learn how to handle soft declines in 3D Secure
During the request for authorization or pre-authorization, when the card issuer does not agree with the SCA exemption, they may return a Soft Decline.
A Soft Decline response can be returned for any payment request and irrelevant of an SCA exemption being requested. Most cases where a Soft Decline is returned are for SCA Exemptions.
A Soft Decline response can also be returned for subsequent Credential on File payments. It is important that you can handle this decline code regardless of whether you intend to use SCA exemptions or not.
How a Soft Decline Works
A soft decline is not an outright refusal of (pre)authorization request. It advises that the card issuer wants the cardholder to perform 3D-Secure authentication. To prove that they are the cardholder, the cardholder must perform SCA (a challenge authentication).
In most cases, we will automatically manage the Soft Decline for you and perform a challenge authentication request during (pre)authorization flow:
Gateway (direct) integration:
- Payabl returns the 3D-Secure authentication data in response to your request (see example below).
- You re-direct the cardholder to their card issuers challenge page.
transactionid=104226827&transid=104226827&status=2000&errormessage=pending&errmsg=pending&amount=1.23&price=1.23ยคcy=USD&orderid=Payabl-Test&bin=402400&ccn_four=8466&card_type=VISA&cardholder=Gateway%20Test&expiry_month=12&expiry_year=2030&user_id=264604&url_3ds=https%3A%2F%2Fpay4.sandbox.payabl.com%2F3dss%2Ftest%2Fv1%2F9aff6737450e37d7834e7891eea14a61%2Fredirect
iFrame integration:
- payabl. redirect a customer to 3DS itself
Following a Soft Decline message, if payabl. is unable to perform 3D-Secure authentication for you, then it will return a Soft Decline response to your system. The value of the DeclineCode will be 65.
If you have
non3ds
transaction within EU or UK, the issuer can reply to transaction authentication witherrorcode=65
. In this case you will receiveurl_3ds
parameter in response and you need to redirect the customer to it for 3D Secure verification.
In Interface you will see 2 Authorizations. First will have a declined status with an error code = 65 or 1A. The second Authorization will be successful.
Updated 11 months ago