Skip to main content

Enable 3DS2 for Ebanx payment gateway integration

Zuora

Enable 3DS2 for Ebanx payment gateway integration

3D Secure 2.0 (3DS2) is a widely recommended solution for strong customer authentication (SCA) under PSD2. The Ebanx gateway integration provides support for 3DS2 through the embedded iFrame of Payment Pages 2.0. With 3DS2 enabled and implemented, end users may receive a challenge window presented by issuing banks who are seeking confirmation that the end user is the card owner. The callback page is displayed only when they are authenticated.

Configure 3DS2 settings in Payment Pages

When setting up a Payment Page, select the Enable 3D Secure 2.0 checkbox and select the Ebanx gateway instance that you created from the Default Payment Gateway dropdown list.

Implement Payment Pages 2.0 to support 3DS2

After completing the preceding configurations, you can then implement and use Payment Pages 2.0 as usual. See Payment Pages 2.0 implementation overview for more information.

If your customers fail the strong customer authentication, the [ThreeDs2_Authentication_Exception] error code and error message are returned. The error code is common across all gateways, while the error message is gateway-specific.

The "Best practices" section in Zuora’s implementation of 3D Secure 2.0 provides best practices for reducing the possibility of failed transactions due to 3DS2 authentication errors.