Simplified setup

This guide explains the simplified 3DS setup. Paybyrd handles the authentication flow automatically — you only need to make a single payment creation request.

Requirements

The only requirement to use our service is the apiKey provided during onboarding.

You can find your API key in the Developer section of the dashboard.

Make sure you select the correct environment before making requests.

Step-by-step Guide

1. Initiate the flow

To start the flow, send a payment request using your API key:

curl --request POST \
 --url https://gatewaysandbox.paybyrd.com/api/v2/payment \
 --header 'content-type: application/json' \
 --header 'x-api-key: {your_api_key}' \
 --data '{
 "type": "card",
 "isoAmount": 100,
 "currency": "EUR",
 "orderRef": "YOUR_REF_CODE_HERE",
 "redirectUrl": "https://your-shop-url?orderRef=YOUR_REF_CODE_HERE",
 "card": {
   "number": "5555341244441115",
   "expiration": "12/30",
   "cvv": "893",
   "holder": "Paybyrd"
 }
}'

Make sure to execute this request in your server side.

Request example:

{
 "type": "card",
 "isoAmount": 100,
 "currency": "EUR",
 "orderRef": "YOUR_REF_CODE_HERE",
 "redirectUrl": "https://your-shop-url?orderRef=YOUR_REF_CODE_HERE",
 "card": {
   "number": "5555341244441115",
   "expiration": "12/30",
   "cvv": "893",
   "holder": "Paybyrd"
 }
}

Response example:

{
 "type": "Card",
 "currency": "EUR",
 "orderRef": "YOUR_REF_CODE_HERE",
 "acquirer": "SIMULATED",
 "brand": "MASTER",
 "paymentMethod": "card",
 "redirectUrl": "https://your-shop-url?orderRef=YOUR_REF_CODE_HERE",
 "action": {
   "type": "redirect",
   "url": "https://link.paybyrd.com/3ds_yvLu4cxe8"
 },
 "code": "BYRD207",
 "description": "Pending redirect"
}

SDK setup Tracking requests

Get Started

Advanced

Simplified setup

Requirements

Step-by-step Guide

1. Initiate the flow

​Requirements

​Step-by-step Guide

​1. Initiate the flow

Requirements

Step-by-step Guide

1. Initiate the flow