BusinessPlus Connect (Developer)

Headless & Custom Web Application Integration Guide

Integrate BusinessPlus backend infrastructure into custom React, Vue, Next.js, or HTML websites by combining Catalog APIs and the Embedded Chat Widget.

Headless Commerce Architecture

A headless integration allows you to build custom, bespoke frontend user interfaces while delegating catalog storage, order state management, payment webhooks, and 24/7 AI customer service to BusinessPlus.

Three-Step Implementation Blueprint

Follow this proven implementation pattern:

1. Embed the AI Chat Widget: Include `widget.js` before `` to handle customer inquiries, return policy questions, and automated lead capture.
2. Fetch Catalog Dynamically: Query `GET /v1/catalog` on page load or during Static Site Generation (SSG) to render products and services with active prices.
3. Submit Orders & Redirect to Paylinks: When the customer clicks checkout, dispatch `POST /v1/orders` and redirect the shopper to the returned `paylink_url` for M-Pesa STK or card payment.