Documentation

Integration setup

Before testing payments in sandbox, set up MetaMask on Base Sepolia with test USDC, test EURC, and test cNGN. This guide walks through network and token configuration — no prior crypto experience needed.

Need machine-readable request/response bodies for your AI or codebase? Download this page as plain Markdown.

When should I use this?

  • You are testing checkout or payouts in sandbox for the first time.
  • You or your QA team need test USDC, EURC, or cNGN to simulate customer payments.
  • You want to verify wallet-direct or wallet-intent flows locally.

Why use Videpay?

  • Sandbox mirrors live behavior using free test tokens, no real money at risk.
  • Base Sepolia is the supported sandbox chain.
  • Test USDC and EURC from Circle's faucet and test cNGN from the cNGN faucet behave like real assets in your integration.

Developer testing checkout

Your backend developer creates a sandbox checkout link, opens it in Chrome with MetaMask, pays 25 test USDC, test EURC, or test cNGN, and confirms the payment.settled webhook fires — all before touching production.

Install and secure MetaMask

  1. Install the MetaMask browser extension from metamask.io.
  2. Create a new wallet and write down your seed phrase offline: never share it.
  3. Pin MetaMask in your browser toolbar for easy access during testing.

Add Base Sepolia to MetaMask

In MetaMask: menu → Networks → Add custom network. Enter these values:

  1. Network name: Base Sepolia Testnet
  2. Default RPC URL: https://sepolia-preconf.base.org
  3. Chain ID: 84532
  4. Currency symbol: ETH
  5. Block explorer: https://base-sepolia.blockscout.com

Add test USDC to MetaMask

Under Tokens → Manage tokens → Add custom token, paste the USDC contract address:

  1. Token contract address: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
  2. Token symbol: USDC
  3. Token decimal: 6
  4. Get free test USDC from https://faucet.circle.com

Add test EURC to MetaMask

EURC is Circle's euro-pegged stablecoin on Base Sepolia. Add it the same way as USDC:

  1. Token contract address: 0x808456652fdb597867f38412077A9182bf77359F
  2. Token symbol: EURC
  3. Token decimal: 6
  4. Get free test EURC from https://faucet.circle.com

Add test cNGN to MetaMask

cNGN is Videpay's NGN-pegged sandbox asset on Base Sepolia. Add it the same way as USDC so MetaMask can send and display balances:

  1. Token contract address: 0xe2387F04d3858e7Cb64Ef5Ed6617f9B2fcEEAfa2
  2. Token symbol: cNGN
  3. Token decimal: 6
  4. Get free test cNGN from https://cngn.co/faucet

Match your checkout chain and asset

When creating checkout links or payments in sandbox, set chain to base (Base Sepolia). Use asset USDC, EURC, or cNGN depending on what you are testing.