Payment Links: Instant USDC Checkout Pages

Generate unique payment URLs with QR codes that accept USDC on Base. Share a link, get paid, and track status in real time — no code required.

A payment link is a unique URL that gives your payer a checkout page with a QR code and a USDC deposit address on Base. You create the link once, share it with your payer, and Kibble handles the rest — detecting the on-chain payment and updating the status automatically.

How it works

1. Create a payment link

   Run npx create-kibble in your terminal or call POST /api/links with your business name, email, expected amount, and wallet preference. Kibble returns a unique URL and deposit address.

2. Share the link with your payer

   Send the payment_link URL directly, embed the checkout on your website, or display the QR code anywhere your payer can scan it.

3. Payer sends USDC

   Your payer opens the checkout page, scans the QR code or copies the deposit address, and sends USDC on Base from any wallet.

4. Status updates in real time

   The checkout page polls for on-chain activity every few seconds. Once Kibble detects the transfer, it updates the payment status automatically.

Payment status lifecycle

Every payment link starts in pending and moves to a final state once Kibble detects an on-chain transfer.

Status	Meaning
pending	No payment detected yet.
confirmed	Exact amount received — payment complete.
partial	Less than the expected amount received. Payer can top up.
excess	More than the expected amount received. Noted for the merchant.
error	Something went wrong processing the payment.

Create a payment link

CLI

npx create-kibble

The interactive prompt asks for your business name, email, expected amount, and wallet type, then prints your payment link and merchant portal URL.

API

cURL

curl --request POST \
  --url https://pay.kibble.sh/api/links \
  --header 'Content-Type: application/json' \
  --data '{
    "business_name": "Acme SaaS",
    "email": "[e-mail]",
    "expected_amount": "49.00",
    "wallet_type": "privy",
    "product_description": "Consulting"
  }'

Response

{
  "slug": "abc12345",
  "payment_link": "https://pay.kibble.sh/pay/abc12345",
  "merchant_portal": "https://pay.kibble.sh/merchant/abc12345",
  "wallet_address": "0x1234...",
  "iframe_snippet": "<iframe src=\"https://pay.kibble.sh/pay/abc12345\" width=\"400\" height=\"600\" frameborder=\"0\"></iframe>",
  "js_widget_snippet": "<script src=\"https://pay.kibble.sh/w.js\" data-slug=\"abc12345\"></script>"
}

Next steps

Checkout page

Learn what your payer sees on the checkout page and how real-time status updates work.

Embed on your site

Add the payment widget to your website using an iframe or a JS snippet.