Core APIs

Products

Catalog items with a fixed price. Each product gets a public page and a shareable Buy Now link. Perfect for creators, digital sellers, and small businesses without a website.

When to use products

  • Digital downloads — ebooks, PDFs, presets, samples
  • Services — coaching sessions, consultations, custom work
  • Workshop seats — course enrollments, event tickets
  • Physical items — one-of-a-kind crafts, pre-orders
  • Anything with a fixed price that you want to sell without building an e-commerce site

Creating a product

Products are created in your Dashboard → Products tab. Give it a name, description, price, image, and pick which cryptos you accept.

🛒 Open the dashboard

Each product becomes a public page you can share as a URL.

Manage products →

Product fields

FieldRequiredDescription
name YesProduct name shown at the top of the page.
description NoFree-form description. Supports line breaks.
price YesFixed price.
currency YesUSD, EUR, GBP, NGN, etc.
accepted_currenciesNoWhich cryptos your customers can pay with.
image_url NoURL of a cover image. Square works best. If empty, we render a gradient placeholder.
is_active NoFalse hides the product from the public page.

Public URL structure

https://blockcade.app/pay/product/{merchant_slug}/{product_slug}/

The product slug is derived from the product name. Share this URL anywhere.

The public page

Each product has a checkout-ready public page with:

  • Product image, name, description, price
  • Your business name
  • Optional email field
  • Big "Buy now →" button — creates a session and redirects to hosted checkout
  • "Secured by Blockcade" footer

Metadata on product payments

Payments fired from a product page include this metadata on the webhook:

{
  "created_via":  "product",
  "product_id":   "uuid",
  "product_name": "Premium Coaching Package"
}

Analytics

Each product shows times_purchased and total_revenue. Detailed analytics (conversion rate, average time to purchase, top referrers) are on the roadmap.

API (coming soon)

Programmatic product management via POST /gateway/api/products/ is planned. For now, products are dashboard-only.