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: 5E37D19C-F99C-445F-8B77-1463EFC66C7B' \
--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"
}
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 |
