Fund Sandbox accounts

This page lists every way to fund a Sandbox account so you can perform a deposit and use the resulting balance for further testing.

​

Simulated bank deposit

Use the Simulate bank deposit test helper to credit a Sandbox account as if funds had arrived via bank transfer. Set up the target account first with Setup account deposit method and use the returned details when calling the simulator.

​

Simulated crypto deposit

Use the Simulate crypto deposit test helper to credit a Sandbox account as if a crypto deposit had been received. Set up the target account first with Setup account deposit method and use the returned details when calling the simulator. Because the deposit is simulated, the transaction hash is not available on any blockchain. If you need an actual on-chain transaction, use the testnet flow below instead.

​

Crypto deposit via testnets

When testing crypto deposit and withdrawal flows in Sandbox, Uphold integrates testnet blockchains so you can simulate real on-chain activity without using real funds. Use the details returned by the Setup account deposit method endpoint to deposit testnet tokens into your Sandbox account. Uphold does not supply test tokens. You must source them yourself using the faucets listed below, or any other preferred alternative.

​

Recommended token faucets

Please note that faucet availability and token limits are managed by third parties and may vary over time.

​

Card deposit using test cards

Use the test cards below to simulate card deposit flows in the Sandbox environment without processing real transactions. These are cards you can use to create an external account and use it as the origin when creating a quote.

​

Test cards

The following cards are available for testing across different networks, countries, and card types.

​

Simulating errors

To trigger a specific error response, use the corresponding reserved amount when creating a transaction with any of the test cards above. All other amounts will result in a successful transaction.

​

Testing APMs

Each alternative payment method (APM) has its own way of being tested in Sandbox. Follow the steps for the method you want to test below.

​

Setting up PayPal

Testing PayPal in Sandbox relies on PayPal’s own sandbox environment to authorize transactions, so you can go through the full deposit and withdrawal flow without moving real funds. See the PayPal developer guides for a full walkthrough: Deposit via REST API and Withdrawal via REST API.