# Zayuno Provider Integration

> Provider Contract 1.0.0. Build a provider backend for verified discovery, quotes and confirmed actions. Current product focus: food ordering.

## Start here
- [Agent workflow](https://partners.zayuno.uz/docs/ai-agents.md): scope, source precedence, tests and handoff.
- [Quickstart](https://partners.zayuno.uz/docs/getting-started.md): roles, credential ownership and integration steps.
- [Provider OpenAPI](https://partners.zayuno.uz/openapi.json): generated schemas and examples; canonical implementation contract.
- [Complete documentation](https://partners.zayuno.uz/llms-full.txt): all guides in one plain-text file.
- [Search corpus](https://partners.zayuno.uz/docs/search-index.json): titles, keywords, URLs and complete content.

## Boundaries
Provider API Base URL belongs to the merchant. Core API is https://api.zayuno.uz/api/v1.
Status webhooks are provider-to-Zayuno at /api/v1/webhooks/{providerSlug}.
Use real prices and availability. Require an unexpired quote and explicit confirmation before creating an action.
Demo sandbox success is not provider certification or approval to publish.
Keep secret values on the server. A generated AI Kit contains placeholders, not usable credentials.

## Guides
- [Boshlash · Quickstart](https://partners.zayuno.uz/docs/getting-started.md): Biznes profili, birinchi API so‘rovi va nashrgacha bo‘lgan yo‘l.
- [API Base URL & Endpoints](https://partners.zayuno.uz/docs/base-url.md): Qaysi serverni qurish kerak? Express va FastAPI misollari.
- [AI agent bilan integratsiya](https://partners.zayuno.uz/docs/ai-agents.md): Codex, Claude va boshqa agentlar uchun ish tartibi va resurslar.
- [Arxitektura va chegaralar](https://partners.zayuno.uz/docs/spec-v1.md): Provider va Zayuno vazifalari, lifecycle va to‘lov chegarasi.
- [Capability profillari](https://partners.zayuno.uz/docs/capabilities.md): Read-only, transactional va joylashuv talablari.
- [Authentication & HMAC](https://partners.zayuno.uz/docs/auth.md): API key kimniki? Webhook secret va raw body imzosi.
- [Katalog va mahsulotlar](https://partners.zayuno.uz/docs/catalog.md): Offering, variant, option, narx va mavjudlik.
- [Quote va hisob-kitob](https://partners.zayuno.uz/docs/quotes.md): Narxni hisoblash, expiry, subtotal va fees.
- [Buyurtma lifecycle](https://partners.zayuno.uz/docs/actions.md): Tasdiqdan keyingi action, idempotency va holatlar.
- [To‘lovga yo‘naltirish](https://partners.zayuno.uz/docs/payment-handoff.md): Provider checkout, nextAction va to‘lov holati.
- [Webhook va eventlar](https://partners.zayuno.uz/docs/webhooks.md): Providerdan Zayunoga imzolangan status xabarlari.
- [Xatolar va idempotency](https://partners.zayuno.uz/docs/errors.md): Retry, duplicate, conflict va xato formatlari.
- [Provider API reference](https://partners.zayuno.uz/docs/contract-reference.md): Koddagi contractdan yaratilgan endpoint va JSON misollar.
- [Zayuno Core API](https://partners.zayuno.uz/docs/api-reference.md): Portal, provider boshqaruvi va Core endpointlar.
- [Tekshirish va nashr](https://partners.zayuno.uz/docs/certification.md): Sandbox, haqiqiy API certification va review.
- [Dashboard va operatsiyalar](https://partners.zayuno.uz/docs/provider-operations.md): Buyurtmalar monitoringi, review va provider account.
- [Muammoni topish · FAQ](https://partners.zayuno.uz/docs/troubleshooting-faq.md): CORS, 401, HMAC, quote math va timeout yechimlari.