Sell products

Use these endpoints to build a shop on your own website from the products you manage in Lahuta. Your site shows the products and keeps the basket. When the buyer is ready, you open a checkout and send them to it. Lahuta's checkout page takes care of delivery, address, coupon and payment, and the order lands in your dashboard like any other.

You need a connected Stripe account to sell anything that costs money. See Get paid.

Show your productsCopy Anchor Link

GET /v1/products returns every product on sale, in one response. Each item has what a product card needs:

curl https://api.lahuta.org/v1/products \
  -H "X-Api-Key: $LAHUTA_API_KEY"

{
  "items": [
    {
      "id": "0197a8b1-4f20-7c3e-9d15-2a6e8b1f4c73",
      "slug": "speckled-mug",
      "name": "Speckled mug",
      "category": "handmade",
      "image": {
        "id": "0197a8b1-4f2b-7a90-8c41-5e3d9f2b6a18",
        "type": "image",
        "url": "https://media.lahuta.io/images/0197a3c2-5b1e-7d40-9f2a-3c8e1b6d4f70/0197a8b1-4f2b-7a90-8c41-5e3d9f2b6a18.jpg",
        "alt": "Speckled stoneware mug",
        "width": 1200,
        "height": 1200,
        "thumbnail": null
      },
      "fromCents": 3200,
      "toCents": 3800
    }
  ]
}

fromCents and toCents are the lowest and highest variant prices, so you can show "$32 to $38".

For a product page, GET /v1/products/{slug} adds the description, every photo, the options and the variants:

{
  "slug": "speckled-mug",
  "name": "Speckled mug",
  "descriptionHtml": "<p>Wheel-thrown stoneware, dishwasher safe.</p>",
  "fulfillment": {
    "_tag": "physical",
    "shipping": { "mode": "flat_rate", "flatAmountCents": 800 },
    "pickup": null
  },
  "options": [
    {
      "id": "0197a8b2-0a11-7e4c-8b92-3f5d1c7a6e20",
      "name": "Size",
      "values": [
        { "id": "0197a8b2-0a12-7b05-9c3e-6a1f8d2b4c91", "name": "12 oz" },
        { "id": "0197a8b2-0a13-7d68-a0f4-1e9b5c3d7a02", "name": "16 oz" }
      ]
    }
  ],
  "variants": [
    {
      "id": "0197a8b2-0b40-7f21-8e6d-4c2a9b1f5e37",
      "title": "12 oz",
      "sku": "MUG-SPK-12",
      "priceCents": 3200,
      "compareAtCents": null,
      "optionValueIds": ["0197a8b2-0a12-7b05-9c3e-6a1f8d2b4c91"],
      "image": null
    }
  ]
}

The response is trimmed here. It also has media, specifications, category and seller, with your pickup address and free shipping threshold when you have them.

Every product has at least one variant, even without options. Variants are what a buyer puts in the basket. Keep the variant ids for the checkout.

Collections work the same way: GET /v1/collections lists them with a name and image, and GET /v1/collections/{slug} returns one with its products.

Send the buyer to checkoutCopy Anchor Link

When the buyer is ready to pay, open a checkout with their basket and redirect them to the url you get back.

curl -X POST https://api.lahuta.org/v1/products/checkouts \
  -H "X-Api-Key: $LAHUTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lines": [
      { "variantId": "0197a8b2-0b40-7f21-8e6d-4c2a9b1f5e37", "quantity": 2 }
    ],
    "successUrl": "https://northsidepottery.com/shop/thanks",
    "cancelUrl": "https://northsidepottery.com/shop/cart"
  }'

{
  "checkoutId": "0197b31c-7a05-7e92-8b4d-1c6f3a9e2d58",
  "url": "https://lahuta.org/checkout/0197b31c-7a05-7e92-8b4d-1c6f3a9e2d58",
  "expiresAt": "2026-09-26T16:40:02.117Z"
}

What the buyer sees:

1. The checkout page at url, with your organization's name, a Back to Northside Pottery button that goes to cancelUrl, the basket, delivery options and payment.
2. After paying, Lahuta's order page at lahuta.org/orders/<shortCode>, with a Continue to northsidepottery.com button. It goes to your successUrl with ?order=<shortCode> added, so your thank-you page knows which order came back.

Always send both URLs. Without successUrl, the order page offers to continue shopping on Lahuta instead of on your site.

Nothing is reserved or charged until the buyer submits the page. The link works for 24 hours, until expiresAt. An abandoned checkout needs no cleanup.

Check what happenedCopy Anchor Link

There are no webhooks. To know whether a checkout was paid, ask for it, for example when the buyer lands on your thank-you page:

curl https://api.lahuta.org/v1/products/checkouts/0197b31c-7a05-7e92-8b4d-1c6f3a9e2d58 \
  -H "X-Api-Key: $LAHUTA_API_KEY"

{
  "checkoutId": "0197b31c-7a05-7e92-8b4d-1c6f3a9e2d58",
  "status": "ordered",
  "expiresAt": "2026-09-26T16:40:02.117Z",
  "order": {
    "orderId": "0197b320-11d4-7a36-9e08-5b2c7f1d3a64",
    "shortCode": "Xq84Tn",
    "status": "confirmed"
  }
}

Confirmation can arrive a little after the buyer does, so poll every few seconds while you see open or pending, and stop after a minute or so. Whether or not your site checks, the order shows up in Commerce → Product orders like any other order.

Sell another organization's productsCopy Anchor Link

Set orgSlug to another organization's slug to open a checkout for their products, for example a neighboring studio's tools that you recommend. That organization must be listed on Discover. They're the seller: they fulfill the order and keep the money, and the order records that your organization sent the buyer. All lines must be their variants, and the Org API only lists your own products, so get the variant ids from them. See Referrals.

ServicesCopy Anchor Link

GET /v1/services and GET /v1/services/{slug} return the services you offer, like Northside Pottery's custom dinnerware commissions, with their tiers and prices. Buying a service happens on its Lahuta page, lahuta.org/services/<your-org>/<service slug>, so link there from your site.

ErrorsCopy Anchor Link

See Products in the API reference for every field.

RelatedCopy Anchor Link