Skip to main content

Test Environment (Sandbox)

MartianPay provides a fully functional test environment for developers to integrate and test payment flows before going live.

Environment URLs​

EnvironmentDashboardAPI Base URL
Productionhttps://dashboard.martianpay.comhttps://api.martianpay.com/v1/
Development (Sandbox)https://dev-dashboard.martianpay.comhttps://dev.martianpay.com/v1/
Quick Switch

To switch from production to development environment, simply replace api with dev in the URL. All API endpoints and parameters remain the same.

Getting Started with Test Environment​

  1. Register a new account at dev-dashboard.martianpay.com
  2. Get your API key from the dashboard
  3. Configure your SDK to use the dev environment URL

SDK Configuration​

Go SDK:

import martianpay "github.com/MartianPay/martianpay-go-sample/sdk"

client := martianpay.NewClient(apiKey)
client.BaseURL = "https://dev.martianpay.com"

Java SDK:

import com.martianpay.sdk.MartianPayClient;

MartianPayClient client = new MartianPayClient(apiKey, "https://dev.martianpay.com");

Supported Test Networks​

The test environment uses testnet for all crypto transactions. Below are all supported test networks and assets.

Native Tokens (Layer 1)​

BlockchainNetworkTokenExplorer
EthereumSepoliaETHsepolia.etherscan.io
SolanaDevnetSOLsolscan.io (devnet)
TRONShastaTRXshasta.tronscan.org
AvalancheFujiAVAXtestnet.snowtrace.io
BaseSepoliaETHsepolia.basescan.org
BNB ChainTestnetBNBtestnet.bscscan.com
TONTestnetTONtestnet.tonscan.org
BitcoinTestnetBTCblockstream.info/testnet
AlgorandTestnetALGOtestnet.explorer.perawallet.app
StellarTestnetXLMstellar.expert/testnet

Stablecoins (USDC/USDT)​

TokenNetworkContract/Asset ID
USDCEthereum Sepolia0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
USDCSolana Devnet4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
USDCAvalanche Fuji0x5425890298aed601595a70AB815c96711a31Bc65
USDCAlgorand Testnet10458941
USDCStellar TestnetUSDC-GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
USDCNoble TestnetNative
USDTEthereum Sepolia0x7169d38820dfd117c3fa1f22a697dba58d90ba06
USDTTRON ShastaTG3XXyExBkPp9nzdajDZsozEu4BkaSJozs
USDTBSC Testnet0x337610d27c682E347C9cD60BD4b3b107C9d34dDd

Getting Testnet Tokens​

Ethereum Sepolia​

TokenFaucet
ETHGoogle Cloud Web3 Faucet
USDCCircle Faucet
note

To transfer USDC on Ethereum Sepolia, you need ETH for gas fees. Request ETH first.

Solana Devnet​

TokenFaucet
SOLSolana Faucet
USDCCircle Faucet
note

To transfer USDC on Solana Devnet, you need SOL for gas fees. Request SOL first.

Avalanche Fuji​

TokenFaucet
AVAXAvalanche Faucet
USDCCircle Faucet

Base Sepolia​

TokenFaucet
ETHBase Faucet

BNB Chain Testnet​

TokenFaucet
BNBBNB Faucet

TRON Shasta​

TokenFaucet
TRXTRON Shasta Faucet

TON Testnet​

TokenFaucet
TONTON Testnet Faucet (Telegram Bot)

Bitcoin Testnet​

TokenFaucet
BTCBitcoin Testnet Faucet

Algorand Testnet​

TokenFaucet
ALGOAlgorand Testnet Dispenser

Stellar Testnet​

TokenFaucet
XLMStellar Friendbot

MetaMask (EVM Chains)​

MetaMask supports Ethereum Sepolia, Base Sepolia, Avalanche Fuji, and BSC Testnet.

Setup Steps:

  1. Install MetaMask browser extension
  2. Open MetaMask and click on the network dropdown
  3. Enable "Show test networks" in Settings > Advanced
  4. Select the desired test network (Sepolia, etc.)
  5. Request test tokens from the faucets above

Supported Networks:

  • Ethereum Sepolia (ETH, USDC, USDT)
  • Base Sepolia (ETH)
  • Avalanche Fuji (AVAX, USDC)
  • BSC Testnet (BNB, USDT)

Phantom (Solana)​

Phantom is recommended for testing payments on Solana Devnet.

Setup Steps:

  1. Install Phantom browser extension
  2. Open Phantom and go to Settings (gear icon)
  3. Select "Developer Settings"
  4. Enable "Testnet Mode" and select "Devnet"
  5. Request test SOL and USDC from the faucets above

Supported Assets:

  • SOL (native token for gas)
  • USDC on Solana Devnet

TronLink is recommended for testing payments on TRON Shasta.

Setup Steps:

  1. Install TronLink browser extension
  2. Switch to Shasta Testnet in network settings
  3. Request test TRX from the faucet

Supported Assets:

  • TRX (native token for gas)
  • USDT on TRON Shasta

Testing Checklist​

Before going live, make sure you have tested the following:

  • Create a payment intent
  • Complete a crypto payment with testnet tokens
  • Receive webhook notifications
  • Process a refund
  • Test payout functionality
  • Verify your integration handles all payment statuses

Moving to Production​

Once you've completed testing:

  1. Register at dashboard.martianpay.com
  2. Complete KYB verification
  3. Update your SDK configuration to use https://api.martianpay.com
  4. Replace your test API key with your production API key
  5. You're live!