3D Secure

You can integrate your e-commerce application directly to our platform-agnostic 3D Secure API so your merchants can mitigate fraud while at the same time allowing the cardholders to enjoy additional security when using their cards online. Paysafe is compliant to 3D Secure version 1.0.2..

Click the links below to view our code samples.

Verify That the Service Is Accessible

boolean isOnline = apiClient.threeDSecureService().monitor();

Enrollment Lookup

Submit an enrollment lookup request
EnrollmentChecks enrollmentChecks =
                EnrollmentChecks.builder()
        .merchantRefNum(“merchantABC-123-enrollmentchecks”)
                .amount(5000)
                .currency("USD")
                .customerIp("172.0.0.1")
                .userAgent("Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/36.0.1985.125 Safari/537.36")
        .acceptHeader("text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8")
        .merchantUrl("https://www.merchant.com")
                .card()
                .cardNum("4111111111111111")
                  .cardExpiry()
                         .month(10)
                     .year(2019)
                  .done()
                .done()
                .build();

EnrollmentChecks enrollmentChecksRes = Apiclient.threeDSecureService().submit(enrollmentChecks );
Look up an enrollment lookup using an ID
EnrollmentChecks request = new EnrollmentChecks ();
request.setId(Id.create("e067d83f-add7-4b6b-8884-dfa8693dde1f", EnrollmentChecks.class));
EnrollmentChecks response = Apiclient.ThreeDSecureService().get(EnrollmentChecks.builder().id(request.getId()).build();

Authentication

Submit an authentication request
Authentications auth_response =
        Authentications.builder()
        .merchantRefNum("merchantABC-123-authentications")
        .paRes("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")
        .enrollmentId("e067d83f-add7-4b6b-8884-dfa8693dde1f ")
        .build();
Authentications response = Apiclient.threeDSecureService().get(auth_response);
Look up an authentication using an ID
Authentications request = new Authentications ();
request.setId(Id.create("5d4db3bc-34c9-417f-a051-0d992ad9284e", Authentications.class));
Authentications response = Apiclient.ThreeDSecureService().get(Authentications.builder().id(request.getId()).build();
Look up an authentication and corresponding enrollment lookup
Authentications request = new Authentications ();
request.setId(Id.create("5d4db3bc-34c9-417f-a051-0d992ad9284e", Authentications.class));
Authentications response = Apiclient.ThreeDSecureService().get(Authentications.builder().id(request.getId()).build();
Did you find this page useful?