🧭 Overview

What is Blend?

Blend is a unified API platform that connects with major delivery apps across Saudi Arabia, including Jahez, HungerStation, Careem Food, Noon, and Ninja.

Merchants use Blend to control and synchronize their branch data across all delivery apps from a single backend.

🧩 Supported Integrations

Blend supports two types of integrations:

1. Public APIs

For apps like Jahez and Careem that offer their own public APIs, Blend connects directly and handles all synchronization logic.

2. Private APIs (Proxy Layer)

For platforms without APIs, Blend provides a private gateway that allows store owners to manage their branches indirectly via Blend.

🚀 Main Features

Feature	Direction	Description
Sync Menu	Blend → Delivery App	Send full menu structure from Blend to the delivery app
Item Visibility	Blend → Delivery App	Hide/show specific items
Branch Pause	Blend → Delivery App	Pause/unpause the branch
Order Created (Webhook)	Delivery App → Blend	Blend receives orders via webhooks
Update Order Status	Bidirectional	Blend and delivery apps can update order status (accepted, rejected, etc.)

🔐 IP Whitelist Requirement

To ensure secure communication, delivery partners must provide Blend with their public IP address(es) to whitelist.
This is required for :

Posting order creation or order updates to Blend

Please contact Blend support with your IP list before integration testing.

🔄 Event Direction Summary

→ = Blend triggers event to Delivery App  
← = Blend receives event from Delivery App  
↔ = Both directions (request & response)

Menu Sync: →
Item Visibility: →
Branch Pause: →
Order Create: ←
Order Status Update: ↔

🧪 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 '{
    "order_id": "123456",
    "status": "new",
    "items": [...]
  }'