Skip to main content
Paybyrd handles 3DS authentication. One payment request starts the flow.

Requirements

The only requirement is an API key.
You can find your API key in the Developers section of the dashboard.
Select the correct environment before making requests.

Step-by-step Guide

1. Initiate the flow

Send a payment request using your API key:
Execute this request from your backend. Sending card data from a client exposes credentials to end users.
Response example:
For full details on payment creation, see the API reference.

2. Handle the response

The response includes these fields relevant to the 3DS flow: Redirect the customer to action.url to continue the payment.

3. Authentication challenge

The customer sees an authentication screen (challenge) to verify their identity with the card issuer. After authentication, the customer is redirected to the redirectUrl specified during payment creation.
Redirection happens in both success and failure scenarios. Query the transaction to determine the outcome. See Query transactions.
The final transaction result is also sent via webhook. See Webhooks.

4. Process overview