Sandbox Testcases

In order to facilitate your integration with our payment platform, we provide specific card numbers that can be used for test scenarios. These are only when using your test API Key, and will not result in a real transaction or transfer of funds. The following test cases will be possible:

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

It is also the intention that you can use the sandbox for automatic integration testing of your service. We will not modify individual test cases and will deprecate them with a sufficient grace period if need be.

How to use the test cards

Whenever working with a test card, use test API keys in all API calls.

Server-to-server integration

On a server-to-server integration, you can pass the any of the card numbers on this page in the Card.Number parameter of the payment request as shown below:

curl --request POST \
  --url \
  --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": ""
    "card": {
        "number": "555534******1115",
        "expiration": "12/25",
        "cvv": "***",
        "holder": "Peter Parker"
    "code": "BYRD207",
    "description": "Pending redirect",


Payment creation

In case you want to know more about how to create a payment via API, please check the section Create Payment

Hosted form / Paybylink

When using the Paybyrd's hosted form, all you need to do is to fill the field card number with the test card numbers and click on the Pay button:


Hosted form

In case you want to know more about our hosted form solution, please check the section Hosted Form

Test cards list

Successful scenarios

Card NumberSchemeTypeRequires 3DS

Error scenarios

Card NumberSchemeTypeExpected Result
5201282999005515MasterCreditTimeout (success)
5201288134424891MasterCreditTimeout (error)

Refund errors

Card NumberSchemeTypeRequires 3DSExpected Result


Card numbers

Any card numbers you may use which is not contained on the lists below will result in declined transactions.

3D Secure test cases

In case you want to test how your integration handles different 3D Secure 2 authentication scenarios, use the following test card numbers:

Card NumberSchemeExpected Result
5505772716954642MasterNot Enrolled
5431885746329897MasterDSMethod Execution
4844874705184109VisaChallenge Required


3D Secure

If you want to know more about the 3D Secure, please check here.