top of page

Payer authentication test matrix

Exercise the eleven documented legacy authentication outcomes.

Use the correct test environment

This guide applies to Gateway.js ThreeDSecure#createUI with the account in test mode. It is separate from the sandbox test-card guide. Never toggle a merchant serving real customers into test mode as part of ordinary checkout.

Expected events

Scenario Test card Event Outcome Successful Frictionless Flow 4000000000002701 complete verified / ECI 05 Failed Frictionless 4000000000002925 failure TRANSACTION_STATUS_N Attempted Frictionless Flow 4000000000002719 complete attempted / ECI 06 Unavailable Authentication 4000000000002313 failure TRANSACTION_STATUS_U Rejected Authentication 4000000000002537 failure TRANSACTION_STATUS_R Unknown Error 4000000000002990 error gatewayError Timeout Error 4000000000002354 error gatewayError Successful Step Up 4000000000002503 complete verified / ECI 05 Failed Step Up 4000000000002370 failure TRANSACTION_STATUS_N Unavailable Step Up 4000000000002420 failure TRANSACTION_STATUS_U Error on Authentication 4000000000002644 error gatewayError

Keep authentication separate

complete does not mean a payment was charged. Forward the authentication result through the supported backend contract; retain failures and technical errors separately. Source code snippets have punctuation defects, so this matrix extracts behavior rather than copying them as runnable JavaScript.

Join the community and get the latest biz news & tips

Thanks for submitting!

© 2025 Betterpay. All Rights Reserved.

bottom of page