Sandbox Environment


We maintain an isolated test site at sandbox.dnsimple.com. We highly recommend testing against our sandbox environment before using our production environment. This will allow you to avoid real purchases, live charges on your credit card, and reduce the chance of your running up against rate limits.

Disclaimer

Sandbox data and systems are generally treated like production, however we may not apply the same backup, monitoring and high availability policies. That means we may occasionally need to take this environment down, wipe out a portion, or clear all stored data.

Getting started

The DNSimple Sandbox is independent from the DNSimple production site, you have to create another account and register some domains to test your integrations.

Every action within the Sandbox will be free of charge.

  • Go to sandbox.dnsimple.com/signup and register your account. It does not have to match your DNSimple live account.
  • When asked to choose a plan choose Skip this step and choose a plan later at the bottom. If you want to test features that requires a valid subscription, including registering test domains, please refer to the Testing Subscriptions section.

URL

The API hostname is api.sandbox.dnsimple.com. This hostname follows the same URL and version conventions of the production environment.

Sandboxing 3rd parties

This site is generally an exact duplicate of the production application, but there are some exceptions. Instead of actually performing domain registration, charging credit cards, etc. it mocks these functions.

Testing Domains

To register domains with your sandbox account you will need an active subscription (see below). You can register every domain you want, as long as it’s available because you are still sharing a system with other customers.

Domains you register within the sandbox will not have any DNS service.

Testing Certificates

Testing working with certificates is at the moment not supported within the sandbox because certificate validation requires actual DNS service.

Testing Subscriptions

To test domain registrations or other subscription-based features you will have to subscribe to a plan.

We use Stripe as our payment gateway, so their testing documentation may be relevant depending on your use case.

You can use any of the documented cards to make payments to succeed or fail at your convenience. Here are the 2 credit card numbers that we most frequently use:

  • 4242 4242 4242 4242: Use this credit card number to make all payments and authorizations succeed.
  • 4000 0000 0000 0341: Use this credit card number to make all payments and authorizations fail.