Developer platform

Build on the local commerce layer SnapAct is verifying every day.

SnapAct Connect gives approved partners a production API and Node SDK for catalog sync, verified nearby inventory, signed order webhooks, and commerce events designed for serious marketplace integrations.

Start quickstart View inventory API

Server-side keys API keys stay on your server, never inside buyer apps or browsers.

Verified inventory Stock can include freshness, proof image metadata, and location distance.

Signed webhooks Order and catalog events are signed, retryable, and partner-scoped.

Quickstart

Three steps from partner system to SnapAct.

Create a server key, sync products, then receive signed order and catalog events. Keys and webhooks are managed from the approved partner dashboard.

Create an API key

Open Partner Dashboard, go to Connect API, create a key, and store the one-time secret in your server secret manager.

Sync live catalog

Use your own product IDs as external refs. SnapAct upserts items safely so repeated POS or website syncs stay clean.

Subscribe to events

Authentication

Use partner-scoped API keys.

All production calls use https://connect.snapact.io. Requests must come from a trusted server, POS backend, automation worker, or commerce platform backend.

Header	Value	Notes
Authorization	Bearer $SNAPACT_CONNECT_API_KEY	Recommended for server integrations.
X-SnapAct-API-Key	$SNAPACT_CONNECT_API_KEY	Supported when your HTTP client separates auth from API keys.
Content-Type	application/json	Required for POST, PATCH, and DELETE request bodies.

Keys are scoped to one approved partner. Revoke unused keys from the dashboard immediately.

SDK

Install the SnapAct Connect SDK.

The SDK keeps partner integrations cleaner than raw fetch calls and is built for server-side Node 18+ runtimes.

Install

npm install @snapact/connect-sdk

Sync and search verified stock

import { SnapActConnect } from "@snapact/connect-sdk";

const snapact = new SnapActConnect({
  apiKey: process.env.SNAPACT_CONNECT_API_KEY
});

await snapact.upsertCatalogItems({
  external_ref: process.env.SNAPACT_PRODUCT_REF,
  title: process.env.SNAPACT_PRODUCT_TITLE,
  price_naira: Number(process.env.SNAPACT_PRODUCT_PRICE_NAIRA),
  category_label: process.env.SNAPACT_PRODUCT_CATEGORY,
  availability: "in_stock",
  status: "live",
  stock_quantity: Number(process.env.SNAPACT_PRODUCT_STOCK || 0),
  inventory_verified_at: new Date().toISOString(),
  inventory_verification_source: "merchant_shelf_snap"
});

const nearby = await snapact.findNearbyInventory({
  lat: Number(process.env.SNAPACT_DELIVERY_LAT),
  lng: Number(process.env.SNAPACT_DELIVERY_LNG),
  product: process.env.SNAPACT_INVENTORY_QUERY,
  radius_km: 25
});

Verify webhooks

import { verifyWebhookSignature } from "@snapact/connect-sdk";

const valid = await verifyWebhookSignature({
  secret: process.env.SNAPACT_WEBHOOK_SECRET,
  rawBody,
  timestamp: request.headers["x-snapact-timestamp"],
  signature: request.headers["x-snapact-signature"]
});

if (!valid) {
  throw new Error("Invalid SnapAct webhook signature");
}

Keep API keys and webhook signing secrets in your server secret manager, not inside browsers or mobile apps.

Catalog sync

Keep partner products current.

SnapAct stores partner prices as the final buyer-facing item price. Service fees are calculated separately at checkout.

Upsert items

curl https://connect.snapact.io/connect/v1/catalog/items \
  -H "Authorization: Bearer $SNAPACT_CONNECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"items\": [{
      \"external_ref\": \"$SNAPACT_PRODUCT_REF\",
      \"title\": \"$SNAPACT_PRODUCT_TITLE\",
      \"description\": \"$SNAPACT_PRODUCT_DESCRIPTION\",
      \"price_naira\": ${SNAPACT_PRODUCT_PRICE_NAIRA},
      \"currency\": \"NGN\",
      \"category_label\": \"$SNAPACT_PRODUCT_CATEGORY\",
      \"availability\": \"in_stock\",
      \"stock_quantity\": ${SNAPACT_PRODUCT_STOCK},
      \"inventory_verified_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",
      \"inventory_verification_source\": \"merchant_shelf_snap\",
      \"status\": \"live\"
    }]
  }"

Delete an item

curl -X DELETE https://connect.snapact.io/connect/v1/catalog/items \
  -H "Authorization: Bearer $SNAPACT_CONNECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"external_ref\":\"$SNAPACT_PRODUCT_REF\"}"

Use stable external references from your POS, website, or inventory backend so SnapAct can keep product records clean.

Verified local inventory

Know what is actually nearby.

SnapAct returns live partner items near a delivery point with stock quantity, proof metadata, last verification time, distance, delivery estimate, and buy links.

Find verified inventory nearby

curl "https://connect.snapact.io/inventory/nearby?lat=$SNAPACT_DELIVERY_LAT&lng=$SNAPACT_DELIVERY_LNG&product=$SNAPACT_INVENTORY_QUERY&radius_km=25" \
  -H "Authorization: Bearer $SNAPACT_CONNECT_API_KEY"

This endpoint is API-key protected and only returns recently verified inventory for approved integrations.

Read freshness metrics

curl "https://connect.snapact.io/inventory/metrics" \
  -H "Authorization: Bearer $SNAPACT_CONNECT_API_KEY"

Use metrics for partner dashboards, POS health checks, distributor alerts, and brand coverage reporting.

Webhooks

Receive signed events.

SnapAct retries failed deliveries with backoff. Verify signatures before processing events.

Headers

X-SnapAct-Event-Id, X-SnapAct-Event-Type, X-SnapAct-Timestamp, and X-SnapAct-Signature are sent with every delivery.

Signature base

Compute HMAC-SHA256 over timestamp.rawBody using your webhook signing secret. Compare with the v1 signature value.

Retry behavior

Return any 2xx status to acknowledge delivery. Non-2xx responses are retried up to the configured limit.

Event types

Event	When it fires
catalog.item.upserted	A partner creates or updates a catalog item from dashboard or API.
catalog.item.deleted	A catalog item is removed.
order.paid	A buyer pays and the order is secured in SnapAct escrow.
order.status.updated	A partner updates fulfillment status such as confirmed, preparing, ready, or on the way.
commerce.*	Internal Meta-ready commerce events for future ads and analytics integrations.

Limits

Production guardrails.

Rate limits protect the marketplace and keep partner sync reliable.

Endpoint	Default limit	Purpose
/connect/v1/catalog/items	300 requests / 5 minutes	Catalog reads, upserts, and deletes.
/connect/v1/events	300 requests / 5 minutes	Server-side commerce event ingestion.
/inventory/nearby	300 requests / 5 minutes	Verified local inventory lookup for approved integrations.
/inventory/metrics	180 requests / 5 minutes	Partner inventory freshness, proof, and stock health metrics.
/partners/me/connect/*	40-60 requests / 5 minutes	Dashboard API key and webhook management.

Approved integrations

Ready to connect your catalog, POS, or inventory system?

Apply as a partner, create a server API key, and start syncing real catalog and shelf-snap inventory data into SnapAct.

Open Connect dashboard