π§ Overview
What is Blend?
Blend is a unified API platform that connects merchants to major delivery apps and POS systems across Saudi Arabia, including Jahez, Careem, Noon, and others.
In addition to supporting automated POS integrations, Blend also supports manual POS integrations. These allow merchants with limited or no API capabilities to still sync menus, manage orders, and control branch availability via webhook and HTTP communication.
Merchants use Blend to synchronize their menus and order operations from a single backend to all delivery platforms and custom POS systems.
π§© Supported Integrations
Blend supports two types of integrations:
- Automated POS (Public or Private APIs)
For platforms that support API-based access (like Jahez), Blend handles full synchronization and order flow.
- Manual POS (Webhook + HTTP Layer)
For systems without direct API connectivity, merchants can implement manual POS integrations using Blendβs webhook events and HTTP-based endpoints (create order, update status, get menu, etc.).
π Main Features
Feature | Direction | Description |
---|---|---|
Menu Updated | Manual POS β Blend | Send this event when any change in menu |
Item Visibility | Manual POS β Blend | Hide/show specific items |
Branch Pause | Manual POS β Blend | Pause/unpause the branch |
Update Order Status | Manual POS β Blend | Your POS updates order status (ACCEPTED, PREPARING, etc.) back to Blend |
Order Created | Blend β Manual POS | Blend pushes new orders to your system via HTTP |
Get Menu | Blend β Manual POS | Blend calls this to retrieve the POS menu (categories, items, modifiers). |
Get Branches | Blend β Manual POS | Blend calls this to retrieve the branches belonging to this brand |
Update Order Status | Blend β Manual POS | Blend can update the order status whenever it changes on the delivery app (e.g., time out, cancellation, auto-accept, etc.), including statuses like ACCEPTED, CANCELED, and others. |
π IP Whitelist Requirement
To ensure secure communication, you must provide your public IP address(es) to Blend for whitelisting.
This applies to any service trying to:
- Receive webhooks from Blend (e.g. for order creation)
- Push events to Blend (e.g. menu.updated, order.updated, etc.)
Please contact Blend support with your IP list before integration testing.
π§ͺ Test Endpoints
You can simulate delivery app behaviors (e.g., sending a webhook to Blend) using tools like Postman or curl.
Example:
curl -X POST {{blend_webhook_url}} \
-H "Content-Type: application/json" \
-d '{
"brand_id": "5000",
"event": "menu.updated"
}'
π Continue to Explore
Updated 10 days ago