Bareconnect API v2

The Commerce API
built for speed.

Build headless storefronts, sync complex inventory scripts, and create powerful custom webhook integrations with our RESTful Commerce API.

Generate API Keys View Merchant Solutions

POST /v2/orders

curl -X POST https://api.bareconnect.com/v2/orders \
  -H "Authorization: Bearer test_sk_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_9xk31",
    "line_items": [
      {
        "variant_id": "var_589md",
        "quantity": 2
      }
    ],
    "payment_method": "mobile_money",
    "currency": "GHS",
    "metadata": {
        "source": "custom_mobile_app"
    }
  }'

Real-time Webhooks

Listen to events instantly. Trigger automations exactly when an order pays, inventory drops, or a customer abandons checkout.

Headless Commerce

Bring your own frontend. Build with Next.js, React Native, Flutter, or Vue — our API handles the commerce logic.

Idempotent Requests

Built for poor network conditions. Retry requests safely without ever accidentally charging a customer twice.

Inventory API

Read and write inventory levels, variants, and product data programmatically. Sync your ERP, WMS, or custom dashboard in real time.

Payments API

Create payment links, initiate charges via Mobile Money, Paystack, Stripe, or card — and receive payment status webhooks instantly.

Order Management

Create, update, fulfill, and cancel orders via API. Build custom checkout flows that feed directly into Bareconnect's order dashboard.

Authentication

API key authentication. No OAuth complexity.

Generate your API keys directly from your Bareconnect dashboard. Every request must include your key in the Authorization header. We issue separate test_sk_* and live_sk_* keys so you can build without touching production data.

Test mode — full API access with simulated payments and no live data impact.

Rate limits — 1,000 requests/minute on standard plans. Contact us for higher limits.

Idempotency keys — pass Idempotency-Key header to safely retry any mutation.

Authorization header

# Test key (sandbox)
Authorization: Bearer test_sk_4xkP91mNvTc2aBqRjLw

# Live key (production)
Authorization: Bearer live_sk_9zYqD7nFhR3mKsWpEuG

# Example authenticated request
curl -X GET https://api.bareconnect.com/v2/products \
  -H "Authorization: Bearer test_sk_4xkP91mNvTc2aBqRjLw" \
  -H "Content-Type: application/json"

REST API

Core endpoints

Everything lives under https://api.bareconnect.com/v2/

GET /products List all products with variants and inventory

POST /products Create a new product with optional variants

GET /products/{id} Get a single product by ID

PUT /products/{id} Update product details or variant stock

POST /orders Create a new order from any channel

GET /orders List all orders with filters (status, date, channel)

GET /orders/{id} Get full order details including line items

PUT /orders/{id}/fulfill Mark order as fulfilled with tracking info

POST /payments/initialize Create a payment link or charge intent

GET /payments/{ref} Get payment status by reference

GET /inventory Get inventory levels across all products

PUT /inventory/{variant_id} Adjust stock level for a specific variant

GET /customers List customers with order history

POST /customers Create or upsert a customer record

GET /analytics/summary Revenue, order count, and AOV for a date range

GET /webhooks List active webhook subscriptions

POST /webhooks Register a new webhook endpoint

Webhooks

Listen to every event in real time.

Register your HTTPS endpoint and we'll POST a signed JSON payload every time something happens in your store. Verify our signature using HMAC-SHA256 with your webhook secret.

Available events

order.placed New order received from any channel

order.paid Payment confirmed for an order

order.fulfilled Order marked as shipped or complete

order.cancelled Order was cancelled by merchant or customer

payment.failed Payment attempt failed or was declined

inventory.low Stock drops below your set threshold

product.created New product added to the store

customer.created New customer account created

cart.abandoned Checkout started but not completed in 1hr

order.paid payload

{
  "event": "order.paid",
  "created_at": "2026-02-28T14:32:00Z",
  "store_id": "str_9aK3m",
  "data": {
    "order_id": "ord_7xPL1",
    "total": 380.00,
    "currency": "GHS",
    "channel": "online_store",
    "payment_method": "mobile_money",
    "customer": {
      "id": "cus_2Bm9r",
      "email": "ama@example.com"
    }
  }
}

Get started in minutes.

Pick your language, generate your keys, make your first call.

Generate API Keys

Log into your Bareconnect dashboard to create test and live API keys for your integration.

Go to dashboard

API Reference

Full documentation for every endpoint, request parameter, and response schema — with interactive examples.

Coming soon

Postman Collection

Import our Postman collection and start testing every endpoint in minutes — pre-populated with example payloads.