Skip to main content
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. Please note that faucet availability and token limits are managed by third parties and may vary over time.
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 the origin when creating a quote.

​
Test cards

The following cards are available for testing across different networks, countries, and card types.
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.

​
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 Apple Pay

To test Apple Pay in Sandbox, we must use Apple’s own Sandbox testing environment, using a dedicated Apple ID and Apple’s test cards so you can go through the full deposit and withdrawal flow without moving real funds.
1

Create a Sandbox Apple Account

Apple Pay’s Sandbox mode uses a dedicated Apple ID for testing, separate from your personal Apple ID. Create one in App Store Connect under Users and Access → Sandbox → Testers, or reuse an existing Sandbox tester.
2

Sign in to the Sandbox Apple Account on your test device

On your Apple Pay-capable device, go to Settings → Wallet & Apple Pay (iOS) or System Settings → Wallet & Apple Pay (macOS) and sign in to the Sandbox Apple Account with the tester credentials. This is separate from the device’s main Apple ID — no sign-out required.
3

Add a test card to Wallet

While signed in to the Sandbox Apple Account, add one of Apple’s test cards to Wallet. Apple Pay recognizes it as a Sandbox card, so no real funds move regardless of the amount you transact.
4

Authorize and transact

Use Apple Pay to authorize, where you will see a “TEST CARD” badge, and complete the transaction.
Unlike Production, Apple Pay servers don’t require domain verification in the Sandbox environment, so you can test web integrations without registering your domain first.
See Apple’s Apple Pay sandbox testing guide for the full details, including region-specific test card numbers. See the Apple Pay developer guides for a full walkthrough: Deposit via Payment Widget and Withdrawal via Payment Widget.

​
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.
1

Create a PayPal sandbox account

Sign in at the PayPal developer site with your PayPal account — or sign up if you don’t have one yet — then follow PayPal’s guide to create a sandbox account.
2

Match the user's country

Choose the same country for your PayPal sandbox account as the country of the user you’re testing with.
3

Authorize and transact

Use the PayPal sandbox account credentials to authorize and complete the transaction.
See the PayPal developer guides for a full walkthrough: Deposit via REST API and Withdrawal via REST API.