API

Payment links

Payment links are reusable, shareable URLs that point at a hosted Tab checkout. Use them when you don't want to create a fresh order for every transaction (a tip jar, a donation page, a product page).

Create a payment link

POST /v1/payment_links
{
  "label": "May newsletter — supporter tier",
  "amount": "5.00",
  "currency": "USDC",
  "chain": "base",
  "recipient": "@yourhandle",
  "open_amount": false
}
→ 201 Created
{
  "id": "plk_2Wq…",
  "url": "https://pay.thetab.bar/l/2Wq…",
  "active": true,
  "amount": "5.00",
  "open_amount": false
}

Open-amount links

Set open_amount: true to let the buyer type their own figure (with optional min_amount and max_amount caps). Useful for tipping or pay-what-you-want pricing.

Disable a link

POST /v1/payment_links/plk_2Wq…/deactivate

Disabling stops new payments. Existing in-flight orders that already started from the link continue normally.

List payments against a link

GET /v1/payment_links/plk_2Wq…/orders