We can't recommend this enough: test early and test often. It's a great way to identify potential issues with your integration, and it also gives you ample opportunities to get familiar with Braintree.
The sandbox is a test environment that is almost identical to our production environment. Within your sandbox, you can create users and roles, run transactions using test credit card numbers, and explore the full functionality of the Braintree gateway by using our sandbox testing values in the sandbox Control Panel or via the API.
Get started by signing up for a Braintree sandbox account!
There are a few key differences to keep in mind:
|Payment methods accepted||Test credit cards/payment methods||Real credit cards/payment methods|
|Processor responses||Triggered by specific test values||Returned by processing banks|
|Hardware resources||No dedicated hardware resources – cannot withstand high transaction volumes||Dedicated hardware resources – can withstand high transaction volumes|
|Purge and delete capabilities||Can purge transactions, Vault records, payment methods, addresses, subscriptions, and sub-merchants||Must manually delete Vault records, payment methods, addresses, and subscriptions; must manually suspend sub-merchants; cannot delete transactions|
|Webhooks||Triggered by specific test values||Triggered by actual events in the gateway|
|Processing options and settings||Standard processing options are displayed||Processing options may be limited based on account setup|
|Disputes||Chargebacks can be created in the Control Panel, and you can simulate winning or losing a dispute||The way you manage chargebacks depends on your account setup – not all accounts have disputes available in the Control Panel|
|Location||Determined by the country selection made at the time of signup||Determined by the country in which your business is registered|
Your sandbox business location will default to the country from which you access the Braintree homepage, unless you manually change the country selection before signing up. Sandbox processing options, currencies, and features can vary by country.
When you set up your sandbox for the first time, your account will default to processing with a single currency setup – usually with the major currency in your region. If you’d like to test other currencies, you can create new merchant accounts in the sandbox and specify which currency you would like to test for each one.
- Log into the sandbox Control Panel
- Navigate to Settings > Processing
- Scroll down to Merchant Accounts
- Click the New Sandbox Merchant Account button
- Enter a merchant account ID – this can be whatever you’d like to name it
- Select the currency you’d like to test in
You can also choose to check boxes to enable PayPal payments, set the new merchant account as your default account, or designate it as a Braintree Marketplace master merchant account. If you choose to enable PayPal, your choice of currencies will be limited to those that PayPal supports.
Keep in mind – while the sandbox is designed to simulate how the gateway functions in production, there can be some differences. For example: in the sandbox, you can enable PayPal and multiple currencies on a Braintree Marketplace account; in production, Braintree Marketplace is not compatible with PayPal or currencies other than USD. If you have any questions about limitations in production, feel free to contact us.
Once you're ready to start accepting real payments, your developers can begin your production integration.
Still have questions?
If you can’t find an answer, contact our Support team.