Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payreque.st/llms.txt

Use this file to discover all available pages before exploring further.

​
Supported Crypto Wallets

PayRequest uses WalletConnect to connect wallets on the Base network. Any wallet that supports WalletConnect and the Base network will work — for both merchants connecting to receive payments and customers paying invoices.
You need USDC on Base to pay, and a Base-compatible wallet address to receive. See the sections below for how to get set up with each wallet.

​
Wallets at a Glance

WalletiOSAndroidBrowser extensionBest for
MetaMask✅✅✅ Chrome, Firefox, EdgeMost popular, widest support
Coinbase Wallet✅✅✅ ChromeEasy USDC purchase via Coinbase
Rabby✅✅✅ ChromeMulti-chain power users
Rainbow✅✅—Clean beginner-friendly UX
Trust Wallet✅✅✅ ChromeBuilt-in dApp browser
Kraken Wallet✅✅—Kraken exchange users
Blockchain.com DeFi Wallet✅✅—DeFi-focused users
Any WalletConnect walletvariesvariesvariesIf it supports Base + WalletConnect

​
Wallet Details

The most widely used crypto wallet. Available as a mobile app and browser extension.Getting USDC on Base:
  1. Open MetaMask and switch to the Base network (Settings → Networks → Add Base if not listed)
  2. Tap Buy and select USDC — MetaMask will route you through MoonPay or another on-ramp
  3. Alternatively, bridge USDC from Ethereum mainnet using the Base Bridge
Connecting to PayRequest:
  • Desktop: install the MetaMask browser extension, then click Connect Wallet on the payment page
  • Mobile: scan the WalletConnect QR code with the MetaMask app’s built-in scanner
Download MetaMask
Made by Coinbase. The easiest option if you already have a Coinbase account — you can buy USDC directly inside the app and transfer it to Base in one step.Getting USDC on Base:
  1. Buy USDC on Coinbase exchange (coinbase.com)
  2. In Coinbase Wallet app, tap Receive and share your Base address
  3. In Coinbase exchange, withdraw USDC to that address — select Base as the network
Connecting to PayRequest:
  • Mobile: scan the WalletConnect QR code with Coinbase Wallet
  • Desktop: use the Coinbase Wallet browser extension
Download Coinbase Wallet
A modern multi-chain wallet built by DeBank. Excellent for users managing multiple chains. Shows clear transaction previews before you sign.Getting USDC on Base: Same as MetaMask — switch to Base network and use the built-in swap or bridge.Connecting to PayRequest:
  • Mobile: scan the WalletConnect QR code
  • Desktop: use the Rabby browser extension
Download Rabby
A mobile-first wallet with a clean, beginner-friendly design. Great if you’re new to crypto.Getting USDC on Base: Rainbow has a built-in swap and bridge. Switch to Base and buy or swap for USDC inside the app.Connecting to PayRequest: Mobile only — scan the WalletConnect QR code from the Rainbow app.Download Rainbow
A popular mobile wallet with a built-in dApp browser and support for hundreds of chains.Getting USDC on Base:
  1. Open Trust Wallet and select the Base network
  2. Use the built-in buy feature or receive USDC from another wallet/exchange
Connecting to PayRequest: Scan the WalletConnect QR code from Trust Wallet’s scanner or dApp browser.Download Trust Wallet
Kraken’s self-custody wallet app. Ideal for Kraken exchange users.Getting USDC on Base: Buy USDC on Kraken exchange, then withdraw to your Kraken Wallet address on Base network.Connecting to PayRequest: Scan the WalletConnect QR code from the Kraken Wallet app.Download Kraken Wallet
The self-custody wallet from Blockchain.com, focused on DeFi users.Getting USDC on Base: Transfer USDC from Blockchain.com exchange or another wallet to your Base address in the DeFi Wallet.Connecting to PayRequest: Scan the WalletConnect QR code from the app’s WalletConnect scanner.Download Blockchain.com DeFi Wallet

​
For Merchants — Connecting to Receive Payments

To receive USDC from your customers, you connect your wallet once in Provider Settings. PayRequest stores your public wallet address and routes all USDC payments there via the on-chain FeeSplitting contract.
1

Open Provider Settings

From your dashboard, go to Settings → Providers and find the Crypto (USDC) card.
2

Click 'Connect Wallet'

A WalletConnect modal opens. Scan the QR code with your wallet app or click your wallet’s name if you have a browser extension installed.
3

Approve the connection

Your wallet asks you to approve the connection. Tap Connect — no gas fee, no transaction.
4

Sign to verify ownership

Sign the verification message in your wallet (free — no gas). This proves you own the address.
5

Done

Your address appears in Provider Settings with a green Connected badge. All future crypto payments go directly to this address (98% of each payment).
Check your balance anytime. Once connected, your USDC and ETH balances on Base are shown right in Provider Settings — no need to open your wallet app.

​
For Customers — Paying an Invoice

Customers don’t need to create an account. They just need a wallet with USDC on Base.
1

Open the payment page

Click the payment link shared by the business. Select Pay with Crypto on the checkout page.
2

Scan the QR code

A WalletConnect QR code appears. Scan it with your wallet app, or if you have a browser extension, click Connect instead.
3

Approve USDC spending (first time only)

Your wallet asks you to approve the PayRequest contract to spend USDC on your behalf. This is a one-time step per wallet — you won’t need to do it again.
4

Confirm the payment

Your wallet shows the exact USDC amount. Confirm the transaction. Base confirms it in under 1 second.
5

Payment confirmed

The invoice is marked as paid instantly. You’ll see a confirmation on the payment page.
Make sure you have USDC on the Base network — not Ethereum mainnet, not Polygon, not Arbitrum. Sending USDC on the wrong network will not be received. Check that Base is selected in your wallet before confirming.

​
Getting USDC on Base

If you’re new to crypto and need USDC on Base, here are the easiest paths:

Buy on Coinbase

Buy USDC on Coinbase, then withdraw to your wallet address on the Base network. Coinbase supports Base natively — no bridge needed.

Buy on Kraken

Buy USDC on Kraken and withdraw to your Base wallet address. Select “Base” as the withdrawal network.

Bridge from Ethereum

Already have USDC on Ethereum mainnet? Use the Base Bridge to move it to Base. Bridging takes a few minutes.

Swap inside your wallet

Most wallets (MetaMask, Rainbow, Coinbase Wallet) have a built-in swap feature. Switch to the Base network and swap ETH or another token for USDC directly in the app.

​
Troubleshooting

This is a known issue on some Android devices where a QR scanner app intercepts the WalletConnect link instead of opening your wallet. Fix: long-press the QR code and copy the link, then open it directly in your wallet app’s browser or WalletConnect scanner.
WalletConnect deep links are blocked in Chrome on iOS (WKWebView limitation). Fix: use iOS Safari instead — WalletConnect works correctly there.
Any wallet supporting WalletConnect and Base will work, even if it’s not in the list above. Look for a WalletConnect or Scan QR option in your wallet’s settings or dApp browser.
Base transactions require a tiny amount of ETH for gas (typically $0.001). If you see a “insufficient gas” error, add a small amount of ETH on Base to your wallet. You can buy ETH on Coinbase or Kraken and withdraw to Base.
If you sent USDC on Ethereum mainnet instead of Base, the funds are not lost — they’re just on the wrong chain. Use the Base Bridge to move them to Base, or contact the exchange you used to check if they support a network correction.

​
Next Steps

Crypto Payments Overview

How USDC payments work on PayRequest, fees, and the FeeSplitting contract.

Payment Methods Overview

See all payment methods available on PayRequest.