> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snappy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Embedded Marketplace with Snappy as the Fulfillment Engine

> Bring Snappy's curated catalog into your own platform. Your users browse and select; your system places orders directly through the API. Build rewards marketplaces, swag stores, and procurement portals.

*Your platform displays the catalog and collects the order, Snappy handles the fulfillment.*

Bring Snappy's curated catalog of gifts and swag into your own platform. Build a dedicated gifting store from scratch, or seamlessly add Snappy's global products to your existing marketplace. You control the UI - whether it's a new redemption center or an existing e-commerce shop - and Snappy acts as the invisible fulfillment engine.

<Tip>
  Want recipients to choose their own gift from a Snappy-hosted claim page instead? See [Triggered Gifting](/pages/triggered-gifting).
</Tip>

***

## Common Use Cases

### **Embedded Rewards Marketplace**

Allow employees or customers to redeem loyalty points for physical products directly within your own portal. You control the branding, point values, and display; Snappy handles the logistics and shipping.

### **Procurement & Swag Stores**

Build an internal company store where office managers can order branded swag or equipment for their teams directly, with instant order placement.

***

## How it works

<Steps>
  <Step title="Catalog Retrieval">
    Pull product data via the [V3 Catalog API](/modules/api/v3/products/overview) to display items in your own UI. There are two integration patterns - pick the one that fits your traffic and UX:

    * **Real-time queries** - hit `GET /v3/products`, `GET /v3/variants`, and `GET /v3/collections/{collectionId}/products` on demand to browse, filter, and paginate directly against Snappy. Best for low-volume integrations or browse-as-you-go experiences where the catalog is rendered fresh per request.
    * **Bulk catalog mirror (async export)** - kick off a background job via `POST /v3/products/exports` (or `POST /v3/collections/exports` for a single collection), poll `GET /v3/products/exports/{exportId}` for completion, and download the full result as a single NDJSON file. Best for high-volume integrations, local search and filtering, or partners maintaining their own product database. See the [Export API](/modules/api/v3/exports/overview) for the full reference.

    <Tip>
      **Recommended pattern for production partners:** run a nightly async export to refresh your catalog mirror, and subscribe to the [`stock-availability-updates` webhook](/pages/webhook-event-types#stock-availability-events) for incremental inventory changes between exports.
    </Tip>
  </Step>

  <Step title="User Selection">
    The user chooses a product and variant in your UI. Your system captures the shipping address (from the user's profile or input form) and optionally validates per-country availability using `GET /v3/variants/{variantId}/availability`.
  </Step>

  <Step title="Order Placement">
    Pass the chosen variant and recipient details to [`POST /v3/orders`](/modules/api/v3/orders/place-order) in a single idempotent call. Snappy returns an order with a tracking link and emits webhooks for every status change.
  </Step>
</Steps>

***

## Key Features

* **Comprehensive catalog access** - browse, filter, expand, and paginate Snappy's full catalog via the V3 Catalog API in real time.
* **Bulk catalog ingestion** - mirror the entire catalog (or any filtered subset) into your own database via the async [Export API](/modules/api/v3/exports/overview). Export jobs return signed NDJSON download URLs, valid for 48 hours. Pair with webhooks for incremental refresh between full snapshots.
* **Single-call order placement** - variant + recipient → order in one API call. Built-in idempotency via `idempotencyKey` prevents duplicates on replay.
* **Full order management** - retrieve, list, and cancel orders programmatically. Tag orders for reporting and attach metadata to round-trip your internal IDs.

***

## Core Platform Capabilities

The following capabilities apply to all Snappy integration models.

**Global Reach** Send gifts to recipients in over 30 countries. Snappy handles currency conversion, local sourcing, and international logistics automatically.

**Real-Time Tracking** Track the full lifecycle of every order - from order received to delivered - using Snappy's comprehensive [Webhooks](/pages/overview-and-setup) system. Order-level webhooks fire alongside gift-level webhooks for V3 orders.

**Enterprise Security** Scoped API keys, granular per-endpoint permissions, PII masking on order reads, and optional mTLS for enterprise integrations. See [Authentication & Security](/pages/authentication-and-security).

**Standards-Based Integration** Connect through standardized RESTful API endpoints with JSON:API conventions for filtering, expansion, pagination, and sorting on V3.

***

<Card title="Ready to integrate?" icon="bolt" href="/introduction">
  See the step-by-step Embedded Marketplace walkthrough with code samples (JavaScript, Python, cURL) in the API Recipes guide.
</Card>