npx create-kibble) or directly via the REST API. Kibble either provisions a managed wallet for you or lets you bring your own USDC address on Base.
Two main workflows
Payment links
Run
kibble charge to generate a shareable payment link with a QR code. Your customer opens the link, scans the code, and sends USDC. Kibble detects the transfer in real time.Invoices
Run
kibble invoice to create and send a professional invoice by email. Kibble generates a PDF, tracks the payment status, and notifies you when funds arrive.Key benefits
- No Stripe — Kibble handles payment detection on-chain so you keep more of every transaction.
- No on-chain complexity — Kibble abstracts away wallet provisioning, transaction monitoring, and status tracking.
- Managed wallets or bring your own — Let Kibble provision a wallet instantly, or supply an existing USDC address on Base.
- Real-time payment detection — Kibble monitors Base for incoming transfers and updates payment statuses automatically.
Two ways to use Kibble
| Method | When to use |
|---|---|
CLI (npx create-kibble) | Interactive setup for one-off payments, invoices, or testing your integration |
| REST API | Programmatic integration into your product, billing system, or back office |
Payment network
Kibble accepts USDC on Base only.| Detail | Value |
|---|---|
| Network | Base (chain ID 8453) |
| Token contract | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| Currency | USDC |
Payments sent in any other currency or on any other network will not be detected. Always confirm your customer is sending USDC on Base.
Payment statuses
Every payment link and invoice moves through the following statuses as Kibble monitors the deposit address.| Status | Meaning |
|---|---|
pending | Link or invoice created; no payment detected yet |
confirmed | The exact expected amount has been received |
partial | A payment arrived but it is less than the expected amount |
excess | A payment arrived that exceeds the expected amount |
error | An unexpected condition occurred; check the merchant portal |