Sandbox Testing Guide
🏖️ Sandbox environment for all your development needs
MoonPay provides a dedicated sandbox environment designed for integration development and testing. Leveraging this sandbox helps you identify potential issues early, ensures compatibility, and minimizes risks during deployment.
Initialize the MoonPay Widget
Initialize the MoonPay widget using your test API key with our SDK or with a simple URL (https://buy-sandbox.moonpay.com/?apiKey=pk_test_INSERT_YOUR_API_KEY). Your API KEY can be found on the Developers Page in your MoonPay dashboard.
Create a Sandbox Test Account
Know Your Customer (KYC) information entered will not be validated and when asked for documents you can skip by clicking on the below button.

Our Sandbox Supports the Following Testnet Tokens.
- Bitcoin - Testnet3
- Ethereum & ERC20 Tokens - Sepolia (ERC-20 token transfers will use our ERC-20 MoonPayToken
- Solana - Testnet
- Binance Coin - Testnet
- TON - Testnet
- Stellar - Testnet
- Litecoin - Testnet
Adding a Payment Method
At the payment screen choose the debit/credit card option and enter one of the following test card numbers. Do not enter authentic payment card information, as this will result in a failed transaction.
Card Type | Card Number | Expiration | CVC code |
---|---|---|---|
MasterCard 3DS Challenge (USA) | 5385 3083 6013 5181 | 12/2030 | 123 |
Visa 3DS Frictionless (UK) | 4485 0403 7153 6584 | 12/2030 | 123 |
Visa 3DS Challenge (UK) | 4242 4242 4242 4242 | 12/2030 | 123 |
Test Card for Declined Transactions
Card type | Card number | Expiration | CVC code |
---|---|---|---|
Visa Insufficient funds | 4544 2491 6767 3670 | 12/2030 | 123 |
Test Card for Off-Ramp Payouts
Card type | Card number | Expiration | CVC code |
---|---|---|---|
Visa Direct payout | 4000 0209 5159 5032 | 12/2030 | 123 |
Sandbox Failure Reasons
Transaction processing failed
may happen when the testnet wallet is empty or you used the wrong card. Please reach out to your MoonPay representative.Your Region is Not Supported
means MoonPay may not support your country or the cryptocurrency is unsupported in your region. New York, USA is not supported in sandbox but is supported in production.You've made too many actions
orYou can't perform this action
means you have been rate limited. This happens when we detect unusual behavior and is not uncommon for partners to experience this while testing. The recommendation is to wait ~20 minutes before trying again.Account is restricted or blocked
may happen if you are using a production MoonPay user account in sandbox or entered otherwise triggered one of our automated flags for suspicious behavior.
Updated about 10 hours ago