Crypto
Get started in testnet
test usdc transfers you can test usdc transfers in cross river’s sandbox environment using blockchain testnets both ethereum (sepolia) and solana (devnet) networks are supported for end to end testing prerequisites a get api credentials sandbox account in cross river’s developer environment a testnet wallet address on ethereum (sepolia) and/or solana (devnet) test usdc tokens funded through public faucets get testnet tokens you’ll need test tokens to simulate blockchain transfers in the sandbox environment each blockchain uses its own assets usdc for payments and eth or sol for gas fees usdc ethereum (sepolia) & solana (devnet) circle faucet provides test usdc on both sepolia (ethereum) and devnet (solana) networks requires a wallet configured for the corresponding testnet (e g , metamask for sepolia, phantom for devnet) eth ethereum (sepolia) google cloud faucet provides test eth for sepolia gas fees each request grants a small amount for development use sol solana (devnet) solana faucet provides test sol for solana devnet gas fees requires a solana compatible wallet such as phantom testnet assets have no monetary value and are for development use only always verify that your wallet is configured for the correct test network before initiating transfers run your first test you can use the sandbox environment to test both inbound and outbound crypto payments follow the steps below to simulate each flow a test an inbound payment (external to cross river) retrieve your receiving wallet address call get /v1/accounts/{accountnumber}/account addresses to obtain your cross river wallet address for the selected blockchain fund your test wallet use the public faucet links above to request test usdc and the corresponding network gas token send the test usdc from your external test wallet to your cross river wallet address once the transaction is confirmed on the testnet, cross river will detect it and issue a crypto payment received webhook events crypto verify receipt check your webhook logs or sandbox dashboard to confirm the inbound payment b test an outbound payment (cross river to external) create an external beneficiary wallet use post /v1/accounts/{accountnumber}/external addresses to register a destination wallet address for testing send a payment use post /v1/payments to send usdc from your cross river sandbox account to the registered external wallet set the "blockchain" field to either ethereum or solana , depending on which testnet you are using confirm transaction status after the transaction is broadcast and confirmed, you will receive a crypto payment sent webhook events crypto containing the payment id and blockchain transaction hash you can also verify the transfer using the corresponding testnet block explorer (e g , sepolia or devnet) quickstart additional considerations supported assets usdc on ethereum and solana settlement time typically seconds, depending on blockchain conditions network fees gas or transaction fees are handled automatically by cross river’s system reconciliation all transactions are recorded in the same reporting environment as fiat payments for unified oversight