Test Payments

While in the Bead Test environment, testnet coins must be used. For example, to test a Bitcoin Lightning payment, Testnet BTC must be used. Please use the following sections for instructions on how to acquire assets for test payments and how to set up any dependencies.

BTC - Lightning Network Testnet

We recommend Bitcoin Lightning for general testing due to its near-instant transaction times and the ease to acquire Testnet coins.

Set Up Lightning Network Testnet Wallet

  1. Go to htlc.me

  2. Record the recovery secret and select "Got it, I wrote it down"

Make a Lightning Network Testnet Payment

  1. Select "Bitcoin Lightning" as the payment option in your payment flow

  2. Copy the Payment Request or QR code value

  3. Paste the Payment Request or QR code value into the field on the Send tab of htlc.me

  4. Select "Send Payment"

Payment should complete within a few seconds.

Bitcoin Lightning transactions are not available for testing in our Test environment at this time.

BTC - Bitcoin Testnet

Set Up Bitcoin Testnet Wallet

  1. Download a Bitcoin Testnet wallet (e.g. Testnet Wallet on Android)

  2. Go to a Bitcoin Testnet Faucet (e.g. coinfaucet.eu/btc-testnet/)

  3. Request Testnet coins to your mobile Bitcoin Testnet Wallet address

  4. Allow some time for the transaction to confirm to receive your Testnet Bitcoin

Make a Bitcoin Testnet Payment

  1. Select Bitcoin (BTC) as the payment option on your test payment

  2. Open your Testnet Wallet mobile app

  3. Select "Send Coins" or click the Scan/Camera button

  4. Scan the QR code on the test payment page (alternatively, copy/paste the "BTC Address" from the payment page)

  5. Enter the payment amount as displayed on your payment page

  6. Select Send

Generally, Bitcoin Testnet transactions are difficult to test due to the difficulty to acquire Testnet BTC and varying reliability of the Testnet. Please allow some time for your transaction to be be broadcast and several minutes to confirm once it enters the queue.

ETH - Ethereum Sepolia Test Network

  1. Download a crypto wallet app with Sepolia Test Network support (e.g. Metamask on Android, iOS)

  2. Enable the Sepolia Test Network in your wallet app (in the Metamask app, select the network at the top of the wallet screen, enable "Show test networks" and select "Sepolia Test Network")

  3. Copy your SepoliaETH address (in the Metamask app, tap SepoliaETH on the wallet screen, tap Receive and copy the address)

  4. Go to a SepoliaETH faucet (e.g. Sepolia PoW Faucet)

  5. Paste in your SepoliaETH address and request/mine coins

The Sepolia PoW Faucet is a time-efficient option to acquire SepoliaETH; however, it requires "mining" prior to receiving coins, which will consume system resources.

USDC - USD Coin

USDC Coin can be transacted on multiple networks. Please see the following subsections to acquire USDC on supported Testnets within our Test environment.

If you have added Sepolia and Amoy networks to the same Metamask account, you can use the same account address to get USDC tokens for both networks from the Circle Testnet Faucet.

USDC - Ethereum Sepolia Testnet

Import USDC Token

  1. Enable the Sepolia Test Network in your wallet app (in the Metamask app, select the network at the top of the wallet screen, enable "Show test networks" and select "Sepolia Test Network")

  2. Select "Import tokens"

  3. Enter the following Token Address for USDC Sepolia: 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238 (Note: Token Symbol and Token Decimal should update to "USDC" and "6" respectively)

  4. Select Import

Get USDC on Sepolia Testnet

  1. Copy your SepoliaETH address (in the Metamask app, tap SepoliaETH on the wallet screen, tap Receive and copy the address)

  2. Go to the Circle Testnet Faucet to request Testnet USDC

  3. Select "Ethereum Sepolia" as the Network and paste in your SepoliaETH address

  4. Select "Send 10 USDC"

To make a test payment with USDC on this network, ETH will be required to pay Gas fees. See the previous section for instructions on how to acquire ETH for this purpose.

USDC - Polygon Amoy Testnet

You will need POL (the Polygon network native token) to acquire USDC using the following steps. If you do not have POL on the Amoy test network, complete this section first.

Import USDC Token

  1. Ensure the Amoy network is active

  2. Select "Import tokens"

  3. Enter the following Token Address for USDC Polygon Amoy: 0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582 (Note: Token Symbol and Token Decimal should update to "USDC" and "6" respectively)

  4. Select Import

Get USDC on Polygon Amoy Testnet

  1. Copy your Amoy address (Note: this will be the same for POL and USDC tokens)

  2. Go to the Circle Testnet Faucet to request Testnet USDC Select "Polygon PoS Amoy" as the Network and paste in your Amoy address

  3. Select "Send 10 USDC"

USDC - Solana Devnet

  1. Copy your Solana Devnet address (in Phantom, tap Receive and copy the Solana Devnet address)

  2. Go to the Circle Testnet Faucet to request Devnet USDC

  3. Select "Solana Devnet" as the Network and paste in your Solana Devnet address

  4. Click "Send 10 USDC"

To make a test payment with USDC on this network, Devnet SOL is required to pay network fees. See this section for instructions on how to acquire Devnet SOL for this purpose.

POL - Polygon Amoy Testnet (Metamask Setup)

  1. Download the Metamask app (Android, iOS) and complete the initial setup

  2. Select the network at the top of the wallet screen and select "Add Network"

  3. Select the "Custom networks" tab

  4. Fill in the fields as follows and select Add:

Polygon's native token (POL) is required to acquire USDC on the Polygon Amoy network. See the following section for instructions on how to acquire POL for this purpose.

Get POL on Polygon Amoy Testnet

  1. Copy your Amoy address from your wallet app

  2. Go to the Polygon Faucet

  3. Select "Connect Discord to get tokens" and complete the Discord invite

  4. Select "Polygon PoS (Amoy)" as the Network and paste in your Amoy address

  5. Select Submit

If you don't have a Discord account, there are other faucet options available online; however, they typically require authentication via a third party provider (e.g. Discord, Github).

SOL - Solana Devnet

  1. Download a crypto wallet app with Solana Devnet support (e.g. Phantom on Android, iOS)

  2. Enable the Solana Devnet in your wallet app (in Phantom, go to Settings > Developer Settings)

  3. Copy your Solana Devnet address from your wallet app

Get SOL on Solana Devnet

  1. Copy your Solana Devnet address from your wallet app

  2. Go to the Solana Faucet

  3. Select "Devnet" from the dropdown

  4. Enter your Solana Devnet wallet address and select an Amount of tokens to receive

  5. Select "Confirm Airdrop"

PreviousCommon

Last updated