Skip to main content
A Kibble-managed wallet is a Base wallet that Kibble provisions for you automatically. You don’t need to create a crypto wallet, store a seed phrase, or configure any network settings. Provide your email address when creating a payment link or invoice, and Kibble takes care of the rest.

​
How to use a managed wallet

Set wallet_type to "privy" in your request body. No wallet_address field is needed — Kibble looks up or creates a wallet tied to your email. 
curl -X POST https://pay.kibble.sh/api/links \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme SaaS",
    "email": "you@example.com",
    "expected_amount": "50.00",
    "wallet_type": "privy"
  }'
The API response includes a wallet_address field containing the provisioned wallet address for your account. This address is used as the deposit address on the checkout page or invoice.
Your wallet address is consistent across all payment links and invoices tied to your email. Kibble creates it on your first request and reuses it automatically for every subsequent one.

​
Accessing your merchant portal

When you use a managed wallet, Kibble creates a merchant portal at /merchant/{slug} for each payment link or invoice. The portal shows payment status, transaction history, and link details. Sign in using the same email address you provided when creating the link.
The merchant portal at /merchant/{slug} shows all your payment links and their statuses. Bookmark it after creating your first link so you can monitor incoming payments without calling the API.

​
When to choose a managed wallet

A managed wallet is the right choice if:
  • You don’t already have a USDC wallet on Base
  • You want the simplest possible setup without any crypto configuration
  • You want to access a hosted merchant portal to track payments visually
If you already have a wallet on Base and prefer funds deposited directly, see Bring your own wallet.