Sandbox Environments
Clearpay provides a sandbox for development and testing. The sandbox environment is:
- Accessed using a different URL
- Uses different credentials to a production environment.
How can I get Sandbox credentials?
Contact your Clearpay account manager and ask for sandbox credentials.
Accounts created within a Clearpay Sandbox only exist within that Sandbox, and no money actually moves when payments are made.
The Clearpay Sandbox environment includes the following components that mirror the Production environment:
- Sandbox API Endpoint for development and testing
- Sandbox Customer Account - see below
- Sandbox Merchant Portal - see below
Quick start
The quickest way to start testing the API is to use our Postman request collection.
Create customer accounts
When you check out the goods or services on the test site, use the below details 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 requires a unique email and a unique phone number.
The correct region specific format is required 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:
- (+44) 7777799999
- (+44) 7777799998
- (+44) 7777799997
- (+44) 7777799996
No SMS's are sent in the Sandbox. Use 111111 as the verification code
Merchant Portal
How can I access the Sandbox Merchant Portal?
Contact your Clearpay account manager or delivery manager to request access to the sandbox merchant portal. The sandbox merchant portal provides the same functionality as the production merchant portal.
You can log in to the sandbox merchant portal here.
You can also view settlement files, however, no settlements are made to the merchant bank account.
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/25 | 000 | |
| Visa | 4111 1111 1111 1111 | 01/25 | 051 | |
| Mastercard | 5215 0977 9282 6659 | 01/25 | 000 | |
| Mastercard | 5215 0977 9282 6659 | 01/25 | 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 and cannot have been used by a different Sandbox customer account.
Updated 4 months ago