> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paybyrd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://beta.paybyrd.com/developer-keys) page in the dashboard. If you don't have an account yet, contact our [Sales team](mailto:sales@paybyrd.com).

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.

<Info>You can manage your API keys in the Developer section of the Paybyrd dashboard.</Info>

***

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:

```bash theme={null}
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"
 }
}'
```

```json theme={null}
{
 "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](/api-reference/payments/create-payment) 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

<Warning>Any card number not listed below will result in a declined transaction.</Warning>

### 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 |