This page lists every way to fund a Sandbox account so you can perform a deposit and use the resulting balance for further testing.Documentation Index
Fetch the complete documentation index at: https://developer.uphold.com/llms.txt
Use this file to discover all available pages before exploring further.
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
| Asset | Testnet | Faucet |
|---|---|---|
| BTC | Testnet | Bitcoin Testnet Faucet, Coinfaucet, testnet-faucet.com |
| ETH | Sepolia | Infura Sepolia Faucet, GetBlock Faucet |
| XRP | Ripple Testnet | XRP Faucets |
| SOL | Devnet | Solana Faucet, SolFaucet, SolFaucet (Toga) |
| USDC, EURC | Multiple | Circle Faucet |
| Multiple | Multiple | Chainlink Faucet |
| Multiple | Multiple | Chainstack Faucet |
Crypto withdrawals in Sandbox are simulated by default and do not reach the blockchain. Refer to your Account Manager if you require on-chain withdrawal testing.
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 theorigin when creating a quote.
Test cards
The following cards are available for testing across different networks, countries, and card types.- Mastercard
- Visa
| Card Number | Type | Country | Features | Method |
|---|---|---|---|---|
5355223761921186 | Debit | GB | Deposit | Instant |
5573606426146833 | Debit | GB | Deposit, Withdrawal | Instant |
5518832400606463 | Debit | US | Deposit | N/A |
5318773012490080 | Debit | US | Deposit, Withdrawal | Instant |
5385308360135181 | Credit | US | Deposit | N/A |
5502514549870410 | Debit | FR | Deposit | Instant |
5436031030606378 | Credit | MU | Deposit | N/A |
All test cards accept any three-digit CVV as valid, and any future expiry date in the MM/YY format.
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.| Amount | Error Code | Description |
|---|---|---|
12.12 | card_unauthorized | The card is not authorized for this transaction. |
15.15 | card_declined_by_bank | The issuing bank declined the transaction. |
20.20 | card_expired | The card has expired. |
26.26 | insufficient_funds | The card has insufficient funds to cover the amount. |
34.34 | velocity | The card has exceeded its transaction velocity limit. |
60.60 | card_unauthorized | The card is not authorized for this transaction. |