Home / Docs / REST API & Webhooks

REST API & Webhooks Developer Reference

Comprehensive specification for OmniCommerce AI REST routes, authentication headers, rate limits, and webhook event schemas.

Base Namespace

Namespace Base
https://your-domain.com/wp-json/wc-telegram-suite/v1/

Public Storefront Endpoints

GET /store/products

Retrieves paginated product listings, categories, and inventory for the Mini App.

Parameters
?page=1&per_page=12&search=query&category=slug

POST /store/checkout

Submits a new order authenticated via Telegram WebApp init_data signature.

Request Payload
{
  "init_data": "query_id=...&user=...&auth_date=...&hash=...",
  "items": [
    { "id": 104, "variation_id": 0, "qty": 2 }
  ],
  "shipping": {
    "first_name": "Alex",
    "last_name": "Mercer",
    "phone": "+1234567890",
    "email": "alex@telegram.me",
    "address_1": "100 Market St",
    "city": "San Francisco",
    "country": "US"
  },
  "payment_method": "cod"
}

Webhook Endpoints

POST /telegram/webhook

Receives incoming Telegram updates (messages, voice notes, inline queries, and pre_checkout queries). Validated using the optional X-Telegram-Bot-Api-Secret-Token.

POST /webhooks/chapa

Processes Chapa checkout settlement callbacks with X-Chapa-Signature HMAC validation.

POST /webhooks/stripe

Processes Stripe Checkout session events (checkout.session.completed).