Wallet

Embedded vs external wallets, balance display, and gas fees.

Wallet types

JoPay merchants use a wallet to receive USDC payments. There are two options:

Embedded wallet (Sequence WaaS)

The embedded wallet is created for you when you sign in with email or social login. It is powered by Sequence Wallet-as-a-Service (WaaS) and is non-custodial: only you can access it through your login credentials. JoPay does not hold your private keys.

Benefits:

  • No crypto knowledge required. No seed phrases to manage.
  • Sign in with email or social accounts.
  • Gas fees are handled automatically (sponsored by the platform).
  • Enables auto-forward (automatic sweep to a designated address).
  • Enables recurring billing (automated subscription payments).
  • Wallet is created instantly during onboarding.
The embedded wallet is recommended for most merchants. It is the simplest option and unlocks all platform features.

External wallet (MetaMask, etc.)

You can also connect an existing external wallet such as MetaMask, Coinbase Wallet, or any WalletConnect-compatible wallet. In this case, you manage your own private keys and gas fees.

Benefits:

  • Full control over your private keys.
  • Use a wallet you already know and trust.
  • Works with hardware wallets for maximum security.
  • No dependency on JoPay's wallet infrastructure.
External wallets do not support auto-forward or recurring billing. These features require the embedded wallet (Sequence WaaS) because they need programmatic access to sign transactions on your behalf.

Comparison

FeatureEmbedded (WaaS)External
SetupEmail / social sign-inConnect existing wallet
Key managementAutomatic (non-custodial)You manage keys
Gas feesSponsored (no cost)You pay gas fees
Auto-forwardSupportedNot supported
Recurring billingSupportedNot supported
Hardware wallet (Ledger / Trezor)Not applicableNot supported in v1
Seed phraseNone (managed internally)You store securely

Balance display

Your USDC balance is shown in the dashboard navigation area. This is your actual on-chain balance, meaning the USDC currently sitting in your wallet address on the active chain.

Verified revenue vs actual balance

Your verified revenue (shown in the KPI strip) is the total value of payments that JoPay has verified through the platform. Your actual balance is the USDC currently in your wallet.

These numbers can differ for several reasons:

  • You withdrew funds (sent USDC to another address).
  • You received USDC from a source outside JoPay.
  • Auto-forward swept funds to your withdraw address.
  • A payment was verified but the balance cache has not refreshed yet.
Balance is cached with a 30-second refresh cycle. If you just received a payment, wait a moment for the display to update.

Gas fees

Every on-chain transaction requires a gas fee paid to the blockchain network:

  • Embedded wallet — Gas fees are sponsored by the platform. You do not need to hold native tokens (MATIC, ETH, etc.) for gas. Sending USDC, including auto-forward sweeps, costs you nothing in gas.
  • External wallet — You are responsible for gas fees. Ensure your wallet holds enough native tokens on the chain you are using. For example, on Polygon you need MATIC for gas; on Base you need ETH.

Next steps