Orders
Create Scent orders; read them back individually or through one order list, and track delivery through to your customer’s door.
API v1 — partner integration docs
Linra Omni Developer Docs
One platform, one API, one integration — order fulfillment, wallet visibility, catalog data, and real-time webhooks, all behind a single versioned facade that grows as Linra adds products.
One platform, one integration, many products
Section titled “One platform, one integration, many products”Linra Omni is a single B2B commerce platform, integrated once. You authenticate once, follow one set of API conventions, and read one wallet and one set of billing statements — no matter how many of Linra’s product lines you sell through. Scent (perfume and fragrance) is the first product live today; more will follow over time, each one showing up as its own self-contained section of this API, layered on the same platform foundation you already know.
That split is deliberate and load-bearing, not just an organizational nicety: everything under Platform — authentication, the response envelope, pagination, rate limits, your wallet, billing statements, commission periods — is built to keep working exactly the same way once a second product ships, with no breaking change on your side. Everything under Scent is specific to that one product’s catalog, cart, and order lifecycle. See Platform overview for the full framing, and the diagram there for how the pieces fit together.
What you can build today
Section titled “What you can build today”Cart & checkout
Price a Scent cart, see per-line availability and price issues before you charge anything, and optionally lock the priced lines for up to 15 minutes.
Webhooks
Get pushed order lifecycle, fulfilment, and back-in-stock events instead of polling — with HMAC-signed, replay-resistant delivery.
Wallet & billing
Read your own balance and transaction history, and pull persisted or on-demand billing statements — across whatever products you buy, in one place.
A quick orientation
Section titled “A quick orientation”Every endpoint in this document lives under /api/v1 on the Linra Omni Gateway. All of it
requires a bearer token from POST /api/v1/auth/token — the Getting started
guide walks through credential exchange to your first authenticated call in about five minutes.
This is the partner-facing surface only. There is no credential management, no admin functionality, and no internal pricing data anywhere in this document — see Credentials for why credential management deliberately stays on the Portal dashboard, never this API.
Where to go next
Section titled “Where to go next”- New here? Start with Getting started — it covers how you get access in the first place, then your first authenticated call.
- Want the full picture before you write code? Read Platform overview for how the platform and its products fit together, then the Integration journey for the full credential-to-delivered-order walkthrough.
- Ready to sell Scent? Head straight to the Scent product page.
- Building the checkout flow? Read Cart preview & price locks.
- Wiring up push notifications? Read Webhooks & HMAC verification — it has a worked, tested signature-verification code sample.
- Just need the wire shapes? Jump straight to the API Reference.