Test your integration

Follow these steps to start testing your Paybyrd integration.

Request your credentials

You can retrieve your test API keys from the Developer Keys page in the dashboard. If you don’t have an account yet, contact our Sales team. The Paybyrd API operates in two modes: test and live. In test mode, requests do not interact with banking networks. The API key you use to authenticate determines which mode is active.

You can manage your API keys in the Developer section of the Paybyrd dashboard.

Paybyrd provides specific card numbers for test scenarios. These work only with your test API key and do not result in a real transaction or transfer of funds. The following test scenarios are supported:

Successful payments with different card schemes.
Declined payments for different reasons.
Processing errors caused by unexpected events.
Capture, refunds, and reversals.
Different outcomes for 3D Secure authentication.

You can also use the sandbox for automated integration testing. Test cases will not be modified without sufficient advance notice.

How to use the test cards

When using test cards, use your test API keys in all API calls.

Testing via API

Pass any of the card numbers on this page in the card.number field of the payment request:

curl --request POST \
 --url https://gateway.paybyrd.com/api/v2/payment \
 --header 'Accept: application/json' \
 --header 'Content-Type: application/json' \
 --header 'x-api-key: {your_api_key}' \
 --data '
{
 "type": "Card",
 "amount": "8.15",
 "currency": "EUR",
 "orderRef": "ABC12345", 
 "card": {
   "number": "5555341244441115",
   "expiration": "02/25",
   "cvv": "123",
   "holder": "Peter Parker"
 }
}'

{
 "transactionId": "0e443bff-9052-4eec-a5f1-9db474f2077a",
 "type": "Card",
 "currency": "EUR",
 "orderRef": "ABC12345", 
 "brand": "VISA",
 "fingerprint": "b53b68c8-43af-4acc-bc79-e892dd6a9a38",
 "amount": "8.15",
 "isPreAuth": false,
 "redirectUrl": "https://your-shop-url?orderRef=ABC12345",
 "action": {
   "type": "redirect",
   "url": "https://link-s.paybyrd.com/3ds_Q44clBT77"
 },
 "card": {
   "number": "555534******1115",
   "expiration": "12/25",
   "cvv": "***",
   "holder": "Peter Parker"
 },
 "code": "BYRD207",
 "description": "Pending redirect"
}

See the full API reference for all request parameters.

Testing Checkout and Pay by Link

When using Paybyrd Checkout or Pay by Link, enter a test card number in the card number field and complete the payment as normal.

Test cards

Any card number not listed below will result in a declined transaction.

Successful scenarios

Card number	Scheme	Type	Requires 3DS
5555341244441115	Mastercard	Credit	No
5448280000000007	Mastercard	Credit	Yes
5277696455399733	Mastercard	Debit	Yes
4235647728025682	Visa	Credit	Yes
4761120000000148	Visa	Debit	Yes
36490101441625	Diners	Credit	Yes
3569990012290937	JCB	Credit	Yes
346267217553369	AMEX	Credit	Yes
6011000990139424	Discover	Credit	Yes

Error scenarios

Card number	Scheme	Type	Expected result
4000000000000119	Visa	Credit	Error
5201282999005515	Mastercard	Credit	Timeout (success)
5201288134424891	Mastercard	Credit	Timeout (error)

Refund errors

Card number	Scheme	Type	Requires 3DS	Expected result
5186170000000006	Mastercard	Credit	No	Declined
5186170000000014	Mastercard	Credit	No	Error
5186170000000022	Mastercard	Credit	No	Timeout
4444333322221111	Visa	Credit	No	Declined
4917610000000000	Visa	Credit	No	Error
4484070000000000	Diners	Credit	No	Timeout

3D Secure scenarios

Card number	Scheme	Expected result
5505772716954642	Mastercard	Not enrolled
2720290928104209	Mastercard	Unauthorized
5431885746329897	Mastercard	DSMethod execution
4844874705184109	Visa	Challenge required
4268796620674517	Visa	Attempt followed by challenge required

Get Started

Advanced

Test your integration

Request your credentials

How to use the test cards

Testing via API

Testing Checkout and Pay by Link

Test cards

Successful scenarios

Error scenarios

Refund errors

3D Secure scenarios

​Request your credentials

​How to use the test cards

​Testing via API

​Testing Checkout and Pay by Link

​Test cards

​Successful scenarios

​Error scenarios

​Refund errors

​3D Secure scenarios

Request your credentials

How to use the test cards

Testing via API

Testing Checkout and Pay by Link

Test cards

Successful scenarios

Error scenarios

Refund errors

3D Secure scenarios