Testing in the Sandbox

It is very important to test your ProcessOut code during development, so we provide the sandbox to help you test safely.

The sandbox is a testing environment that simulates the normal ProcessOut production environment using mock data. This data doesn't belong to any real-world customers and is kept completely separate from any genuine data. We strongly recommend that you use the sandbox during development to avoid the risk of damaging real customer data.

Using the sandbox

You can use most of the ProcessOut API objects in either the sandbox or the production environment. Note that the two environments are separate and so objects created in one environment will not be available in the other. All of the main objects (ie, ones that are not simply used to pass parameters) have a sandbox attribute that is set to true only when the sandbox is active.

To enable the sandbox in your code, use the special sandbox public and private keys when you instantiate the ProcessOut object:

curl -X GET https://api.processout.com/ \
    -u test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x:key_test_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB

var ProcessOut = require("processout");
var client = new ProcessOut(
    "test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x",
    "key_sandbox_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB");

import processout
client = processout.ProcessOut(
    "test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x", 
    "key_sandbox_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB")

require "processout"
client = ProcessOut::Client.new(
    "test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x", 
    "key_sandbox_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB")

<?php
$client = new \ProcessOut\ProcessOut(
    "test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x", 
    "key_sandbox_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB");

import "github.com/processout/processout-go"

var client = processout.New(
    "test-proj_gAO1Uu0ysZJvDuUpOGPkUBeE3pGalk3x", 
    "key_sandbox_mah31RDFqcDxmaS7MvhDbJfDJvjtsFTB",
)

Note: You must enable the production environment before deploying your product. Remove the test- prefix from the project ID and replace the sandbox private key with the production private key.

You may find it convenient to create two completely separate projects and use one only for production and the other only for testing.

Test cards

In the sandbox, you can use a set of test card numbers in place of real cards. Some of these numbers simulate particular card brands or issuing countries while others will generate errors or other special behavior so you can test your code's responses.

The full set of test card numbers is listed below. Note that the sandbox environment doesn't check the expiry dates and CVC number of test cards. Also note that no genuine card numbers will work within the sandbox and no test numbers will work in the production environment.