Channel Providers

Display available providers in your marketplace with real-time availability based on customer location.

Overview

The List Channel Providers endpoint allows you to list all connected providers for your sales channel. Each provider includes complete metadata, operational settings, delivery windows, and real-time availability status based on the customer's location.

Display Providers in Your App

Map Cities IDs

Techrar offerings are highly dependable on cities. Thus, cities in your system must be mapped to techrar's cities. Use List Supported Cities endpoint.

Why This Matters

Providers have specific service areas. Accurate city mapping ensures you show only providers that can serve each customer's location.

Collect Customer Location

In your app, you need to collect customer location. We only need its coordinates in the next step.

We also gonna need the coordinates to create a location in techrar system. More details in Customer Location

Fetch Channel Providers

After collecting city_id, lat, and lng. Send a POST Request to List Channel Providers endpoint to get the list of providers.

List Available Providers

Use the response of the previous request to display providers. Priotrize the field is_available_for_user, which indicates if provider can currently serve this customer or not

Understanding Provider Availability

The is_available_for_user field provides real-time availability based on multiple factors:

Provider is AVAILABLE when:

Customer location falls within provider's delivery zones

For delivery orders: Customer location is within serviceable range

For pickup orders: At least one pickup branch is currently open

Use this field to:

Show available providers first in your UI

Display "Currently Unavailable" badge for unavailable providers

Disable ordering buttons for unavailable providers

Provide clear messaging about why provider is unavailable

Implementation Best Practices

City Mapping

Fetch cities once and cache the mapping in your database

Update city mapping periodically (weekly/monthly)

Handle cases where user's city is not supported

Provider Listing

Always re-fetch providers when customer changes delivery location

Show both available and unavailable providers for better UX

Sort available providers first

Display clear availability status badges

Performance

Cache provider logos and banners for faster loading

Implement pagination if you have many providers

Show loading states while fetching providers

User Experience

Display provider operating hours using start_after and delivery_windows

Show pickup branch locations on a map

Highlight provider brand colors in your UI

Indicate which providers support delivery vs pickup

Example Response

[
  {
    "id": 123,
    "name_en": "Healthy Meals Co",
    "name_ar": "شركة الوجبات الصحية",
    "subtitle_en": "Premium meal plans delivered fresh",
    "subtitle_ar": "خطط وجبات مميزة طازجة",
    "logo": "https://cdn.techrar.com/logos/provider-123.png",
    "banner": "https://cdn.techrar.com/banners/provider-123.png",
    "start_after": 24,
    "primary_color": "#4CAF50",
    "secondary_color": "#81C784",
    "closed_dates": ["2025-01-01", "2025-12-25"],
    "off_days": ["Fri"],
    "supports_pickup": true,
    "supports_delivery": true,
    "is_available_for_user": true,
    "delivery_windows": [
      {
        "id": 1,
        "from_time": "08:00:00",
        "to_time": "12:00:00"
      },
      {
        "id": 2,
        "from_time": "16:00:00",
        "to_time": "20:00:00"
      }
    ],
    "pickup_branches": [
      {
        "id": 45,
        "name_en": "Main Branch",
        "name_ar": "الفرع الرئيسي",
        "location": {
          "address1": "King Abdulaziz Road, Jeddah",
          "lat": "21.5433",
          "lng": "39.1728"
        }
      }
    ]
  }
]

Display Providers

Channel Providers#

Overview#

Display Providers in Your App#

Understanding Provider Availability#

Implementation Best Practices#

City Mapping#

Provider Listing#

Performance#

User Experience#

Example Response#

Channel Providers

Overview

Display Providers in Your App

Understanding Provider Availability

Implementation Best Practices

City Mapping

Provider Listing

Performance

User Experience

Example Response