Test Payments

While in the Sandbox 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.

Bitcoin Lightning (BTC)

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

  1. Go to htlc.me

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

You're now ready to make test payments. To send a test 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 (BTC)

  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

You're now ready to make test payments. To complete a test 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

The payment may take several minutes to complete.

USDC - 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 the Circle Testnet Faucet to request Testnet USDC

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

  6. Select "Send 10 USDC"

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

Get ETH - 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 - Polygon PoS Amoy

Amoy Test Network Setup (Metamask)

  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 (MATIC) is required to acquire USDC on the Polygon Amoy network. See the following section for instructions on how to acquire MATIC for this purpose.

Get MATIC - Amoy

  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).

Get USDC - Amoy

You will need MATIC to acquire USDC using the following steps. If you do not have MATIC on the Amoy test network, complete the previous section first.

  1. Ensure the Amoy network is active and select "Import tokens"

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

  3. Select Import

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

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

USDC - 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 (in Phantom, tap Receive and copy the Solana Devnet address)

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

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

  6. Click "Send 10 USDC"

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

Get SOL - Solana Devnet

  • Copy your Solana Devnet address from your wallet app

  • Go to the Solana Faucet

  • Select "Devnet" from the dropdown

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

  • Select "Confirm Airdrop"

PreviousCommon

Last updated