Skip to main content

Sandbox

Quaderno Sandbox is a safe space to experiment with our set of APIs and products, testing new features or fine-tuning your Quaderno workflows and integrations, without the worries of breaking things while learning.

Quaderno Sandbox has feature parity with the real live environment plus all the new features, testable in advance but without the fuss of dealing with real user data! It's perfect for connecting your payment's processor testing accounts, knowing all will behave just as fine on the live production servers.

URL and credentials​

Quaderno Sandbox is a complete separate environment, with its own URL https://sandbox-quadernoapp.com and credentials.

This means your credentials for the Production environment won't work on Quaderno Sandbox. You'll need to create a new Quaderno Sandbox account.

Test data​

  • Tax ID validations always return { "valid": true } except for:
    • DE111111111: acts as an invalid Tax ID, returning { "valid": false }
    • IE222222222: acts as if the Tax Validator service is down, returning { "valid": null }
  • ZIP codes 90049, 10128, 60611, and 33132 are used for testing U.S. local tax rates.

Limitations​

Quaderno Sandbox has some limitations to provide an improved testing experience:

  • Emails are delivered to your account email rather than to the specified recipient.

  • In the Sandbox environment, the Tax Calculations API limits local tax rate calculations in the United States. For U.S. addresses, only state-level tax rates are returned, except for ZIP codes 90049, 10128, 60611, and 33132. This limitation does not apply in the production environment.

  • There's a global 200 documents cap.

    • The document limit and the remaining number of documents are provided in the HTTP headers X-Documents-Limitand X-Documents-Remaining respectively.
    • When the document limit is reached, a warning email will be sent to the account's admin, and notifications will be displayed within the app.
    • If you need to create more documents, please remove your previous documents first by navigating to You > Purge into the app, or by using the /purge endpoint:
    curl --user sk_your-secret-key:x \
        --request POST \
        --url https://your-url.sandbox-quadernoapp.com/api/purge