How to use the Sandbox Environment

What is the Sandbox?

The Uphold Sandbox is a development environment for building and testing applications built on top of the Uphold Platform.

The Sandbox does not use real money.

Step 1: Create an account

To begin, create an account in the sandbox environment. 
Your sandbox account is a test account to be used for testing applications being built on the Uphold platform and is not in any way connected to your official Uphold account. The sandbox account should have a separate username and password and can be used safely to test without impacting your Uphold account.

To signup for a sandbox account visit our sandbox homepage.

Step 2: Verify your account

To complete the sandbox registration process, you will need to verify your email address. This email address should not be the same address as the one associated with your live Uphold account.

Step 3: Fund your account

You DO NOT need to send value from your own Uphold account to your sandbox account for testing.

You can utilize funds from the testnet faucet. The bitcoin testnet provides developers with, 'fake bitcoin' to assist in the development of new applications.

PLEASE ONLY USE TESTNET FUNDS WITH SANDBOX

We ask that you adhere to standard testcoin etiquette. Don’t take more coin than you need and be sure to return the coin you took once you have finished running your tests. This coin cannot be used outside of a sandbox environment.

Step 4: Connect your application

1. Navigate to Settings > Applications > Developer Applications > "register Application", and input the following information:
   • Name: An application name
     Example: ‘Really Awesome Bitcoin App’
   • Site URL: The application website 
     Example: https://reallyawesomebitcoinapp.com
   • Redirect URL: A callback URL for receiving an authorization code, as per the OAuth2 authorization flow (must be https://)
     Example: https://reallyawesomebitcoinapp.com/connect
2. Select the Scopes (permissions) of the application.
3. Select "I accept the Developer Agreement" followed by "Register".

Your client ID and Client Secret Tokens will be automatically generated. These codes are necessary for generating authentication tokens.

When connecting your application to the sandbox API, please use the following base URL:
https://api­-sandbox.uphold.com