{"data":{"api_version":"2026-10-23","base_url":"https://birinchishop.uz/api/v1","currency":"UZS (Uzbek som), integer amounts","timezone":"Date filters use Asia/Tashkent (UTC+5). Timestamps are ISO 8601 in UTC.","scopes":{"account:read":"Read profile and balance","offers:read":"Read the offers catalog","links:read":"Read tracking links","links:write":"Create tracking links","orders:read":"Read orders and their statuses","orders:write":"Submit orders (leads)","stats:read":"Read statistics","events:read":"Read the event feed (order status changes)","webhooks:manage":"Manage webhook/postback endpoints","insights:read":"Read AI manager recommendations and order sale chance","ads:read":"Read Meta ad campaigns and their results","ads:write":"Pause ad campaigns; resume/budget changes require the partner's confirmation"},"order_statuses":{"new":"Order received, waiting for the call center.","processing":"Call center is processing the order.","callback":"Customer asked to be called back later.","confirmed":"Customer confirmed the order by phone.","packed":"Order is packed at the warehouse.","shipping":"Order is on the way to the customer.","delivered":"Customer received and paid for the product. Payout is earned.","returned":"Customer refused the product at delivery; it was returned.","cancelled":"Order was cancelled (not confirmed, duplicate, unreachable customer, etc.). No payout."},"conversion_statuses":{"lead":"Order received, not yet confirmed (new, processing, callback).","approved":"Confirmed by the customer, not yet delivered (confirmed, packed, shipping).","sale":"Delivered and paid by the customer. Payout earned.","rejected":"Returned or cancelled. No payout."},"payout_statuses":{"pending":"Order not delivered yet; payout will be earned on delivery.","earned":"Payout added to the balance.","under_review":"Delivered, payout temporarily held for review.","none":"Order returned/cancelled; no payout."},"offer_sorts":["recommended","newest","best_selling","highest_payout","highest_stock","highest_lead_bonus"],"sale_rate":"sale_rate_percent = delivered / finished orders over the last 60 days across the network (null if not enough data). sale_rate_tier: good (>=25%), normal, low (<10%).","sale_chance":"Order.sale_chance_percent / GET /orders/{id}/sale-chance — estimated probability (0-100) that the order gets delivered. Informational; computed from offer sale rate, order stage and customer history.","human_confirmation":"Ads actions that can increase spending (resume, budget change) never execute directly: they return an action in status pending_confirmation and the partner confirms it in the Telegram bot or panel within 30 minutes. Pausing is immediate.","mcp_prompts":["daily_review","find_offer","check_campaigns","order_problems"],"event_types":["order.created","order.status_changed"],"postback_macros":["click_id","sub1","sub2","sub3","sub4","sub5","order_id","external_id","status","conversion_status","payout","customer_price","currency","offer_id","link_id","event","event_id","timestamp"],"webhook_signature":"Header X-Birinchishop-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>. Reject if t is older than 5 minutes.","business_rules":["Customers pay on delivery (cash on delivery). A delivery fee (typically 30,000 UZS) is added to customer_price by the delivery partner.","Payout is credited only when an order reaches \"delivered\"; if the status is later reverted, the payout is reversed.","One phone number cannot order the same offer twice within 24 hours, and at most 3 different offers per 24 hours.","Customer phone numbers are always masked for partners.","Submitting orders via API (orders:write) requires at least 3 delivered orders on the account, or admin approval.","Fake or test orders are forbidden and lead to account blocking."],"authentication":{"api_key":"REST and MCP: header \"Authorization: Bearer bsk_live_<id>_<secret>\" (or X-API-Key). Keys are created in the partner panel (Dashboard -> API) with chosen scopes, optional IP allowlist and expiry.","oauth2":"MCP only (Claude.ai / ChatGPT connectors): OAuth 2.1 authorization code + PKCE S256. Metadata: https://birinchishop.uz/.well-known/oauth-protected-resource/api/v1/mcp and https://birinchishop.uz/.well-known/oauth-authorization-server. Access token 1 hour, rotating refresh tokens, connection valid up to 180 days, revocable in the panel."},"rate_limits":{"per_key":"120 requests/minute","orders_write":"30 orders/minute per account","failed_auth":"30 failed attempts per 15 minutes per IP"}},"request_id":"req_Ei-tHJ4uyZ3s"}