Catalog and line items - Zahlo Merchant Developer Docs

Use products for what you sell and prices for how you charge. A price owns an amount, currency, and optional recurring interval. Keep your internal SKU or account ID in metadata; keep checkout totals calculated on your server.

Create a product and price

const product = await zahlo.post("/api/v1/products", {
  name: "Team plan",
  description: "Access for one team",
  metadata: { sku: "team-plan" },
});

const price = await zahlo.post("/api/v1/prices", {
  productId: product.id,
  amountMinor: 1900,
  currency: "EUR",
  recurring: { interval: "month", intervalCount: 1 },
});

The zahlo call above represents your server-side API wrapper. It must send x-api-key, a timeout, and an idempotency key for creates.

Use line items in checkout

Resolve product and price IDs on the server, calculate quantity and totals, then create a checkout session or payment link. Do not accept a price or total copied from the browser without resolving it against your catalog.

{
  "mode": "hosted",
  "lineItems": [
    { "priceId": "price_demo_1001", "quantity": 2 }
  ],
  "amountMinor": 3800,
  "currency": "EUR",
  "metadata": { "orderId": "order_1001" }
}

Price changes

Create a new price for a new amount, currency, or interval. Keep historical price references intact so invoices and refunds remain explainable. Snapshot the selected price, quantity, discount, shipping, tax, and total into your order record before presenting checkout.