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).