3D Secure Integration
Comprehensive guide to integrating 3D Secure authentication for enhanced transaction security.
Integration Steps
Step 1: Send a 3D Request
To initiate the 3D Secure authentication, send a server-to-server request to the 3D Secure endpoint.
Step 2: Use the Redirect URL
Use the redirect_url
from the response to open the 3D Secure page in the browser.
Step 3: After Completing the 3D Secure Authentication
After the cardholder completes the authentication, the issuer will approve or reject the request. Based on the outcome, the customer will be redirected to either a success_url
or a decline_url
that you provide.
success_url
decline_url
Step 4: Webhook Notification
In addition to the redirect response, the gateway will send a Webhook notification to your specified webhook_url
to confirm the status of the transaction. This ensures the transaction result is reliably communicated, even if the customer does not return to your website after the 3DS process.
Webhook Sample Response
Step 5: Get the 3D Secure Transaction status
Request Attributes
Response Attributes
Request Attributes
Authorizations
API Key for Authorization. Format: 'Basic YOUR_API_KEY_HERE'
API Key specific to x-api-key.
Body
The request payload to process a 3D Secure payment transaction.
The body is of type object
.
Response
3D Secure transaction initiated successfully
The response is of type object
.