Get started in testnet

test usdc transfers test usdc transfers in the cross river sandbox environment using supported blockchain test networks both ethereum (sepolia) and solana (devnet) are available for end to end testing prerequisites a registered docid\ z mvwov p00 xx082nabk sandbox account in the cross river developer environment a testnet blockchain wallet address on ethereum (sepolia) and or solana (devnet) test usdc tokens funded through public faucets get testnet tokens test tokens are required to simulate stablecoin payment flows in the sandbox environment each blockchain uses separate assets for testing, including usdc for payment simulation and eth or sol for network fees asset network source description usdc ethereum (sepolia) & solana (devnet) circle faucet https //faucet circle com/ provides test usdc on both sepolia and devnet networks requires a wallet configured for the corresponding test network, such as metamask for sepolia or phantom for devnet eth ethereum (sepolia) google cloud faucet https //cloud google com/application/web3/faucet/ethereum provides test eth for sepolia network fees each request grants a limited amount for development use sol solana (devnet) solana faucet https //faucet solana com/ provides test sol for solana devnet network fees requires a solana compatible wallet important testnet assets have no monetary value and are intended for development and testing only always confirm that the correct test network is selected before initiating transfers run your first test the sandbox environment supports testing of both inbound and outbound stablecoin payment flows test an inbound payment (external to cross river) retrieve a receiving address call get /v1/accounts/{accountnumber}/account addresses to retrieve a cross river managed receiving address associated with the account for the selected blockchain network fund a test wallet request test usdc and the corresponding network token using the public faucet links listed in the table in the get testnet tokens docid\ kkg6wdgvptdfwwn7gccrh section initiate the transfer send test usdc from an external testnet wallet to the retrieved receiving address onchain confirmation once the transaction is confirmed on the test network, cross river detects the transfer and makes the payment available for pii submission provide pii submit the required sender pii using post /v1/payments/{id}/pii verify receipt after required pii is submitted and the payment is completed, cross river issues a crypto payment received webhook webhook logs can be used to confirm successful receipt of the inbound payment and account credit test an outbound payment (cross river to external) create an external destination wallet call post /v1/accounts/{accountnumber}/external addresses to register a destination blockchain address for testing send a payment call post /v1/payments to initiate a usdc payment from the cross river sandbox account to the registered external address set the blockchain field to either ethereum or solana , based on the selected test network confirm transaction status after the transaction is broadcast and confirmed, a crypto payment sent webhook is issued containing the payment id and blockchain transaction hash learn about cross river onchain payment apis docid\ lnz2vwmxvaha4yp7mayed learn more about using the cross river sandbox environment docid\ wmg 1fqwq3bj d3c3hffs additional considerations supported assets in sandbox usdc on ethereum sepolia and solana devnet settlement timing confirmation typically occurs within seconds, subject to blockchain network conditions and applicable review processes network fees testnet network fees may apply as part of the sandbox testing flow these fees are paid using the applicable test network token