> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers-beta.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers-beta.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers-beta.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers-beta.clearpay.co.uk/_mcp/server.

# Sandbox Environments

> How can I test my Clearpay API integration?

Clearpay provides a sandbox for development and testing. The sandbox environment is:

* Accessed using a [different URL](/api-environments)
* Uses different credentials to a production environment.

> **How can I get Sandbox credentials?**
>
> Contact your Clearpay account manager and ask for sandbox credentials.

## Create customer accounts

When you check out the goods or services on the test site, use the details below to place a test Clearpay transaction.

You can create test customer accounts in the Sandbox environment within your test checkout flow.

Each Sandbox customer account needs a **unique email** and a **unique phone number**.

The correct region specific format is needed to complete the Sandbox Clearpay customer checkout flow.

In the UK the phone number must be unique. Edit the examples below to get a unique phone number:

> **No SMS's are sent in the Sandbox. Use 111111 as the verification code**

* (+44) 7777799999
* (+44) 7777799998
* (+44) 7777799997
* (+44) 7777799996

Accounts created within a Clearpay Sandbox only exist within that Sandbox; no money actually moves when payments are made.

> **Quick start**
>
> The quickest way to start testing the API is to use our [Postman request collection](/postman-collection).

## Test payment details

In Sandbox, to simulate different customer journeys, please be aware that:

* The outcome of the customer charge is determined by the card number that you use

The Sandbox Capture response (approved / declined) is determined by the CVV value.  Use\
`000` for approval and `051` for decline.

| Card type  | Long number         | Expiry | CCV |    |
| :--------- | :------------------ | :----- | :-- | :- |
| Visa       | 4111 1111 1111 1111 | 01/28  | 000 |    |
| Visa       | 4111 1111 1111 1111 | 01/28  | 051 |    |
| Mastercard | 5215 0977 9282 6659 | 01/28  | 000 |    |
| Mastercard | 5215 0977 9282 6659 | 01/28  | 051 |    |

> **Note**
>
> You can use any dummy Visa number and future expiry date for testing purposes in the Clearpay Sandbox. But the dummy number must pass a [mod 10 check](https://en.wikipedia.org/wiki/Luhn_algorithm) and cannot have been used by a different Sandbox customer account.

## Business Hub

How can I access the Sandbox Business Hub?

Contact your Clearpay account manager or delivery manager to request access to the sandbox Business Hub. The sandbox Business Hub provides the same functionality as the production Business Hub.

You can log in to the sandbox Business Hub [here](https://portal.sandbox.clearpay.co.uk/uk/merchant/login?next=%252F).

You can also view settlement files, however, no settlements are made to the merchant bank account.