🧭 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:

  1. Automated POS (Public or Private APIs)

For platforms that support API-based access (like Jahez), Blend handles full synchronization and order flow.

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

FeatureDirectionDescription
Menu UpdatedManual POS β†’ BlendSend this event when any change in menu
Item VisibilityManual POS β†’ BlendHide/show specific items
Branch PauseManual POS β†’ BlendPause/unpause the branch
Update Order StatusManual POS β†’ BlendYour POS updates order status (ACCEPTED, PREPARING, etc.) back to Blend
Order CreatedBlend β†’ Manual POSBlend pushes new orders to your system via HTTP
Get MenuBlend β†’ Manual POSBlend calls this to retrieve the POS menu (categories, items, modifiers).
Get BranchesBlend β†’ Manual POSBlend calls this to retrieve the branches belonging to this brand
Update Order StatusBlend β†’ Manual POSBlend 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