Getting started

Geins Concept

Create a custom, tailored experience for your customers and streamline your e-commerce operations.

Architecture Overview

Geins is a headless commerce backend—we handle all the e-commerce logic while you build the frontend experience your customers deserve.

┌─────────────────────────────────────────────────────────┐
│                   SALES CHANNELS                        │
│         (Web, Mobile, POS, IoT, Voice, AR/VR)          │
└─────────────────────────┬───────────────────────────────┘
                          │
                          ▼
              ┌─────────────────────┐
              │    Merchant API     │
              │     (GraphQL)       │
              └─────────────────────┘
                          │
┌─────────────────────────┴───────────────────────────────┐
│                  GEINS COMMERCE BACKEND                 │
└─────────────────────────┬───────────────────────────────┘
                          │
              ┌─────────────────────┐
              │   Management API    │
              │       (REST)        │
              └─────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────┐
│                      BACKENDS                           │
│            (ERP, WMS, PIM, Marketing, BI)              │
└─────────────────────────────────────────────────────────┘

Core Concepts

Channels

A channel represents a sales portal—your website, mobile app, or marketplace presence. Each channel can have:

  • Different product assortments and pricing
  • Multiple languages and currencies
  • Custom checkout flows and payment methods

Learn more about multi-market support →

Products & Variants

Products in Geins can have multiple variants (size, color, material), each with:

  • Unique SKU and barcode
  • Individual pricing and inventory
  • Variant-specific images

Learn more about products →

Cart & Checkout

The Merchant API handles the complete purchase flow:

  1. Add to cart — Create cart, add/update items
  2. Checkout — Collect shipping, apply discounts
  3. Payment — Integrate with payment providers
  4. Order — Create order, trigger fulfillment

Learn more about checkout →

Content Management

Geins includes a built-in CMS for:

  • Pages — Landing pages, campaigns, content
  • Widgets — Reusable content blocks
  • Personalization — Targeted content based on user segments

Learn more about CMS →

Authentication & Personalization

Create logged-in experiences with secure, signature-based authentication:

  • User management — Register, login, password reset, logout
  • Personalized pricing — B2B, VIP tiers, contract pricing per customer
  • Targeted content — Personalized banners and recommendations

Learn more about authentication →

Data Flow

What you needAPI to useExample
Display productsMerchant APIProduct listings, search, filters
Build a cartMerchant APIAdd items, calculate totals
Process checkoutMerchant APIPayments, shipping options
Sync with ERPManagement APIInventory, order export
Update catalogManagement APIBulk product updates

Next Steps

API Reference

Explore the full Merchant API documentation

Open Source Launchpads

Get started with a pre-built storefront template