Summary table
Areas: tracking, integrations, AI, anti-fraud, analytics, infrastructure and partner tools. "Partial" means the capability exists with a limitation (stated in the notes). "No" means it does not exist today; the reasons are in "What we do not have, and why" below.
| Area | Capability | Status | Notes | More |
|---|---|---|---|---|
| Tracking | Click ID and sub1–sub5 | Yes | Append ?click_id=…&sub1=… to the link; values are stored with the order and returned in postbacks and webhooks. | API & postback guide |
| Tracking | S2S postback | Yes | GET request on every status change; 20 macros (click_id, sub1–sub5, status, payout, payout_earned, etc.); up to 8 delivery attempts (about 2 days) until a 2xx response. | API & postback guide |
| Tracking | Signed JSON webhooks | Yes | POST with an HMAC-SHA256 signature (X-Birinchishop-Signature); every event has an evt_ ID for de-duplication. | API & postback guide |
| Tracking | Click log | Yes | Since 2026-11-18: bots and link previews are filtered out, unique clicks (30-minute window), CR by period. Raw IP addresses are not stored. | Technical metrics |
| Tracking | Duplicate protection | Yes | One phone + one product = one order per 24 hours. For part of the catalog, a new order is refused while the customer's earlier order for that product is still in progress. A simultaneous double submit creates one order. | Technical metrics |
| Tracking | Idempotency-Key | Yes | On API order creation, a retried request with the same key returns the existing order instead of creating a new one. | API & postback guide |
| Tracking | Multi-touch attribution report | Yes | For orders placed through a link or landing page, the touch path is shown: first, last and assisting touches (panel and API). The payout rule is unchanged: an order is credited to the link it was placed through, and commission is not split across touches. | API & postback guide |
| Integrations | REST API v1 (OpenAPI) | Yes | Offers, links, orders, stats and webhooks; docs at /api/v1/docs, schema at /api/v1/openapi.json. Order submission (orders:write) unlocks after 3 delivered orders or with admin approval. | API docs |
| Integrations | API test mode (sandbox) | Yes | Since 2026-11-18: with a test key (bsk_test_) order and link requests run the real checks, but nothing is created and nobody is called; status changes, webhooks and postbacks can be simulated. | API docs |
| Integrations | Official SDKs (Node.js, Python, PHP) | Yes | Beta: Node.js 18+ (zero dependencies, TypeScript types, webhook signature verification), Python 3.8+ (standard library only) and PHP 8.1+ (zero dependencies, test-key mode supported). Install: npm install birinchishop, pip install birinchishop, composer require birinchishop/birinchishop; source on GitHub. A Postman collection is in the examples repo. | — |
| Integrations | n8n connector (community node) | Yes | Official connector for the n8n automation platform: npm package n8n-nodes-birinchishop (n8n → Settings → Community nodes). Actions: offers, links, orders, statistics; a signature-verified webhook trigger for new orders and status changes; test-key mode. Source on GitHub, published to npm with provenance. Submitted for review to the n8n verified nodes catalog. | — |
| Integrations | MCP server (ChatGPT, Claude) | Yes | Connect a partner account to an AI assistant via OAuth (/api/v1/mcp). A separate public shop MCP server exists for shoppers. | API & postback guide |
| Integrations | A2A agents (Agent2Agent 1.0) | Yes | Open to other AI agents: agent card at /.well-known/agent-card.json, JSON-RPC and HTTP+JSON bindings (0.3 clients are served too). The shop agent needs no key: it searches products, checks order status and places an order only after the shopper explicitly confirms. The partner agent (/api/a2a/partner) works with offers, orders, stats and links using an API key or OAuth; test keys create nothing. Node.js and Python code samples: github.com/Birinchishop/birinchishop-api-examples (a2a folder). No streaming or push notifications. | API & postback guide |
| Integrations | Keitaro, Binom, Voluum | Yes | Via the universal S2S postback and click_id; there is no separate native integration (preset template). Keitaro and Binom guides are on GitHub. | API & postback guide |
| Integrations | Meta Ads (Facebook, Instagram) | Yes | Connect your own ad account once, then create and manage campaigns from the panel; lead-form leads become orders automatically. | Meta lead ads |
| Integrations | Meta Conversions API | Yes | Purchase, Delivered and lead-form lead status events are sent to the partner's Meta dataset or landing pixel. | Meta lead ads |
| Integrations | Targenix | Yes | Leads from Targenix arrive via webhook and become orders; the order status is reported back to Targenix. | — |
| Integrations | Yuboraman | Yes | Leads sent through Yuboraman are accepted via webhook (matched by the partner's link token). | — |
| Integrations | Telegram bot | Yes | New order and status notifications, ready-made ad posts, AI chat and reports. | Features |
| Integrations | Telegram channel auto-posting | Yes | Since 2026-11-17: the bot posts products to the partner's channel 1–5 times a day with an "Order" button. | — |
| Integrations | Sign-in with Google and Telegram | Yes | Partners can sign in without a password via a Google account or the Telegram bot. | — |
| AI | AI assistant | Yes | In the panel and the Telegram bot; Uzbek, Russian and English; understands voice messages. Anything that spends money runs only after the partner confirms. | Features |
| AI | AI manager | Yes | Every day at 09:00 (Tashkent) a tip about yesterday's results arrives in the Telegram bot. | Features |
| AI | Offer recommendations | Yes | Suggests products by sale rate, payout and stock — in the panel and in the AI chat. | Features |
| AI | AI autopilot (Meta ads) | Yes | AI runs the partner's Meta ads: in "With confirmation" mode every spend is confirmed by the partner; in "Automatic" mode it stays within the daily limit set by the partner. Profit is not guaranteed. | AI autopilot |
| AI | AI replies to comments, orders from comments | Yes | AI replies briefly to ad comments; if a comment contains a phone number, an order is created. | — |
| AI | Comment → Direct message | Yes | A keyword in a comment triggers an automatic Direct message. Requires Meta permissions; one message per comment, within 7 days. | — |
| AI | Ad video generation for a product | Partial | For a product without a video: a 9:16 ad video built from a template, with AI-written script and voice-over. Only for accounts approved by an administrator. | — |
| AI | AI translation of product names and descriptions | Yes | In the Russian and English panel, product names and descriptions are shown translated; shoppers still see Uzbek. | — |
| Anti-fraud | Self-order ban | Yes | A partner cannot place an order to their own phone number: checked on the link form, in the panel, the API and the AI chat. | — |
| Anti-fraud | Spam and quality control | Yes | If a partner's recent orders are almost never confirmed, new orders are held for staff review instead of going to the call center. | — |
| Anti-fraud | Burst protection for external lead flows | Yes | Abnormally large or low-quality lead bursts from Targenix and Yuboraman are paused until an administrator reviews them. | — |
| Anti-fraud | Rate limiting | Yes | Login, sign-up, order form and API requests are rate-limited. | — |
| Anti-fraud | Bot click filtering | Yes | Bots, link previews and prefetch requests are excluded from click statistics. | Technical metrics |
| Anti-fraud | Customer phone masking | Yes | Partners see only the last 4 digits of the customer phone — in the panel, in Telegram and in the API. | Data protection |
| Anti-fraud | ML-based order scoring | Yes | A machine-learning model trained on our own order history estimates the sale probability of every new order: partner and product history, order source, supplier, price, hour and region. The score is shown on the order card with its main drivers; the model is retrained weekly. Advisory only: it never rejects or holds an order by itself, and its accuracy is still modest. | — |
| Analytics | Real sale rate per product | Yes | With enough data (30+ completed orders in 60 days from 2+ partners) it is the actual delivery rate on the platform; otherwise an external estimate. | Features |
| Analytics | Breakdowns | Yes | Orders, deliveries and earnings by link, product, region, hour and weekday. | — |
| Analytics | Clicks and CR | Yes | Since 2026-11-18: clicks, unique clicks and CR. CR counts orders placed on the link page (manually entered orders are excluded). | Technical metrics |
| Analytics | Meta ad spend and results | Yes | Spend and results (leads, orders) per campaign in the panel. | — |
| Analytics | Payout speed | Yes | From withdrawal request to approved payout: the median and shares are published openly. | Technical metrics |
| Analytics | Cohort analysis | Yes | Orders are grouped by the week they were created; for each week, the share delivered within 3, 7, 14 and 30 days, with product and source breakdowns. In the panel and the API (GET /stats/cohorts). | API & postback guide |
| Analytics | Real-time updates (SSE) | Yes | An open panel shows a new order, status change, balance change or notification within 1–2 seconds (Server-Sent Events). | — |
| Infrastructure & reliability | Cloudflare CDN | Yes | The site runs behind Cloudflare: CDN, HTTPS only, attack protection. | Data protection |
| Infrastructure & reliability | Independent uptime monitoring | Yes | Since 2026-11-18 an external service checks the site, API and panel every 5 minutes; public status page at /status. | Status page |
| Infrastructure & reliability | Public technical metrics | Yes | API response time (P50/P95), 5xx rate, postback delivery, duplicate rate — with the methodology. | Technical metrics |
| Infrastructure & reliability | Backups and a live copy | Yes | A live copy of the database runs on a separate standby server (a few seconds behind). An encrypted backup of the database is made every hour, and daily copies are stored in separate locations; files, code and settings are copied to the standby server once an hour. If a backup is missed or the live copy disconnects, an alert is sent. On 2026-11-15 a full restore drill was carried out — the database was restored from backup in a separate environment and verified to work. | Data protection |
| Infrastructure & reliability | Queue with retries | Yes | Orders are sent to the call center through a queue with automatic retries on errors. | — |
| Infrastructure & reliability | Independent security ratings | Yes | Scores from external services (2026-11-20): Mozilla HTTP Observatory — A+ (score 115, 12 of 12 tests passed); Qualys SSL Labs — A+. Anyone can re-run them: developer.mozilla.org/en-US/observatory/analyze?host=birinchishop.uz and ssllabs.com/ssltest/analyze.html?d=birinchishop.uz. These rate HTTP security headers and TLS configuration; they are not a full security audit (pentest). | Data protection |
| Infrastructure & reliability | Active devices and sign-in history | Yes | The profile lists the devices where the account is signed in (browser, system, sign-in method, last activity), lets the owner sign out one device or all others, and shows recent sign-ins. A sign-in from a new device triggers a notification to the owner. Full IPs and user-agent strings are not stored; history is kept for 90 days. | Data protection |
| Infrastructure & reliability | Download your data | Yes | Partners download their own data from the profile as a single JSON file: profile, links, orders, balance transactions, withdrawals, bonuses and connected services. Customer phones, card and personal ID numbers show the last 4 digits only; passwords and tokens are never included. Up to 3 times a day, with re-authentication; the owner is notified of every download. | Data protection |
| Infrastructure & reliability | HTTPS only and a closed origin | Yes | The site and all subdomains are served over HTTPS only (HSTS with includeSubDomains and preload; submitted to the browser preload list). The origin server accepts only connections presenting the CDN certificate (Authenticated Origin Pulls), so the protection layer cannot be bypassed by connecting directly. | Data protection |
| Infrastructure & reliability | Passwordless sign-in with passkeys | Yes | Partners sign in from the browser with a fingerprint, Face ID or screen lock (WebAuthn / passkeys): no password is typed and the key cannot be used on a fake site. Passkeys are added, renamed and removed in the profile, and the owner is notified of every change. Browsers only for now (Chrome, Safari, Edge, Firefox); not in the Android app. | Data protection |
| Infrastructure & reliability | Data protection | Yes | Hashed passwords, encrypted payout documents, masked customer phones — details on a separate page. | Data protection |
| Infrastructure & reliability | Failover (switching to the standby server) | Partial | The standby server is kept ready, but switching to it is done manually — there is no automatic failover. Availability is watched by external monitoring. | — |
| Infrastructure & reliability | Changelog and API versioning policy | Yes | Dated technical changes partners can notice; only additive changes within /api/v1, version in the X-API-Version header. | Changelog |
| Infrastructure & reliability | Vulnerability disclosure policy | Yes | /.well-known/security.txt (RFC 9116) and a public policy: scope, rules, response process. No paid bug bounty. | Disclosure policy |
| Partner tools | Android app | Yes | APK file: birinchishop.uz/reklamachi.apk. | — |
| Partner tools | Landing pages on your own subdomain + your pixel | Yes | A subdomain with a name you choose (name.birinchishop.uz), up to 15 product pages and your own Meta pixel. | — |
| Partner tools | YouTube Shorts and Instagram Reels auto-upload | Partial | Builds Shorts and Reels from product videos and uploads them to your channel/account. Not enabled for every account yet — an administrator turns it on. | — |
| Partner tools | Three-language panel | Yes | The partner panel is available in Uzbek, Russian and English. | — |
| Partner tools | Browser notifications (Web Push) | Yes | Since 2026-11-20: personal notifications about accepted and delivered orders and earnings arrive even when the browser is closed (Profile → Browser notifications). The partner chooses which kinds to receive (orders, withdrawals, bonuses, ads, offers, tips). On iPhone the panel must be added to the Home Screen; the Android app uses its own notifications. | — |
| Partner tools | Smart product search | Yes | Since 2026-11-17: handles synonyms, typos, Cyrillic and Latin spelling. | — |
| Partner tools | Account deletion | Yes | In the panel: Profile → "Delete account". | Account deletion |
Updated: 2026-11-18. Measured values (API latency, postback delivery, duplicate rate) are on the Technical metrics page. How to check any CPA network on these points: Technical checklist; dated changes: Changelog.
Does Birinchi Shop support S2S postbacks and an API?
Yes. Any partner tracking link accepts tracker parameters: ?click_id=…&sub1=… (sub1–sub5). They are stored with the order and returned on every status change via an S2S postback (GET, 20 macros) or a JSON webhook signed with HMAC-SHA256. If the partner server does not return 2xx, delivery is retried up to 8 times over about 2 days.
From your own site or CRM you submit orders through REST API v1 (an OpenAPI schema is published); an Idempotency-Key prevents duplicates when a request is retried after a network error. Duplicate protection: one phone + one product = one order per 24 hours; for part of the catalog a new order is refused while the customer's earlier order for that product is still in progress; a simultaneous double submit creates one order. Since 2026-11-18 clicks are logged: bots are filtered out, and unique clicks and CR by period are calculated.
Setup guide: API & postbacks; reference docs: /api/v1/docs.
Which services does Birinchi Shop integrate with?
- Trackers. Keitaro, Binom, Voluum and any tracker that accepts a postback URL — via the universal S2S postback and click_id. There is no separate native integration per tracker: copy the postback URL from your tracker into the panel.
- Meta. Connect your own ad account once and create Instagram and Facebook ads from the panel; lead-form leads become orders automatically. Via the Conversions API, Purchase, Delivered and lead status events are sent to your Meta dataset or landing pixel.
- AI assistants. An MCP server: connect ChatGPT or Claude to a partner account via OAuth. A separate shop MCP server exists for shoppers — shopping via AI.
- Lead platforms. Targenix (leads accepted, order status reported back) and Yuboraman (leads accepted) — via webhook.
- Telegram. The bot sends order notifications, ready-made posts, AI chat and reports. Since 2026-11-17 the bot can post products to your channel 1–5 times a day with an "Order" button. You can also sign in to the panel without a password via Google or the Telegram bot.
How does Birinchi Shop use AI?
The AI assistant works in the panel and the Telegram bot and understands text and voice messages in Uzbek, Russian and English: it suggests offers, answers questions about orders and balance, and prepares Meta ads. Anything that spends money runs only after the partner confirms. The AI manager sends a tip about yesterday's results every day at 09:00 (Tashkent).
The AI autopilot runs Meta ads: in "With confirmation" mode you approve spending, in "Automatic" mode it stays within the daily limit you set; profit is not guaranteed. AI replies to ad comments, a comment with a phone number becomes an order, and a keyword in a comment triggers a Direct message (Meta permissions required). Product names and descriptions are shown translated in the Russian and English panel. Ad video generation for products without a video is limited for now: only for accounts approved by an administrator.
What anti-fraud protection is in place?
Protection is rule-based. A partner cannot place an order to their own phone number. If a partner's recent orders are almost never confirmed, new orders are held for staff review instead of going to the call center. Abnormally large or low-quality lead bursts from Targenix and Yuboraman are paused until an administrator reviews them. Login, sign-up, order form and API requests are rate-limited; bot clicks are excluded from statistics.
Commission is paid only for delivered orders. Partners see customer phones masked (last 4 digits). There is no machine-learning fraud scoring. How data is protected: Security & data protection.
What analytics and reporting are available?
Every product card shows a sale rate: with enough data (30+ completed orders in the last 60 days from at least 2 partners) it is the actual delivery rate on the platform; otherwise an external estimate. The panel shows orders, deliveries and earnings by link, product, region, hour and weekday; since 2026-11-18 also clicks, unique clicks and CR (CR counts orders placed on the link page). Meta ad spend and results are shown per campaign; stats are also available through the API.
An open panel updates in real time: a new order, a status change or a balance change appears within 1–2 seconds (Server-Sent Events). New order notifications also arrive in the Telegram bot. There is no cohort analysis.
How reliable is the platform?
The site runs behind Cloudflare (CDN, HTTPS only). Since 2026-11-18 an external monitoring service checks the site, API and panel every 5 minutes — public status page: birinchishop.uz/status. API response time, server error rate, postback delivery and duplicate rate are published with the methodology on the Technical metrics page.
A live copy of the database runs on a separate standby server — it stays a few seconds behind the main database. In addition, an encrypted backup of the database is made every hour, and daily copies are stored in separate locations; files (images, video), code and settings are copied to the standby server once an hour. If a backup is missed or the live copy disconnects, an alert is sent. Orders are sent to the call center through a queue with automatic retries on errors. On 2026-11-15 a full restore drill was carried out — the database was restored from backup in a separate environment and verified to work. Switching to the standby server is done manually — there is no automatic failover.
What tools do partners get?
- Android app — APK: birinchishop.uz/reklamachi.apk.
- Your own landing pages — a subdomain with a name you choose (name.birinchishop.uz), up to 15 product pages and your own Meta pixel.
- YouTube Shorts and Instagram Reels auto-upload — built from product videos and uploaded to your channel or account; not enabled for every account yet, an administrator turns it on.
- Three-language panel — Uzbek, Russian and English.
- Smart product search — handles synonyms, typos, Cyrillic and Latin spelling.
- Account deletion — in the panel itself: Profile → "Delete account" (details).
- Cohort analysis — by the week an order was created: the share delivered within 3, 7, 14 and 30 days, with product and source breakdowns (panel and API).
- Multi-touch attribution report — the touch path for an order placed through a link or landing page: first, last and assisting touches. The payout rule is unchanged: an order is credited to the link it was placed through.
- Browser notifications (Web Push) — personal notifications arrive even when the browser is closed: Profile → “Browser notifications”.
All features in plain language: Birinchi Shop features.
What we do not have, and why
- Automatic failover. None; the standby server is kept ready, but switching to it is done manually. Availability is watched by external monitoring.
- Native tracker integrations. No dedicated connectors for Keitaro, Binom or Voluum — the universal postback carries the same data.
This list is updated as capabilities ship. Updated: 2026-11-18.
FAQ
Does Birinchi Shop support S2S postbacks?
Yes. Add a postback URL in the panel: a GET request is sent on every order status change, with 20 macros (click_id, sub1–sub5, status, payout, payout_earned and more). If the partner server does not return 2xx, delivery is retried up to 8 times over about 2 days. HMAC-signed JSON webhooks are also available.
Does it work with Keitaro or Binom?
Yes, via the universal S2S postback and click_id: copy the postback URL from your tracker into the panel. There is no separate native integration (preset template). Voluum and other trackers that accept postbacks connect the same way.
Does Birinchi Shop have an API?
Yes, REST API v1: offers, links, orders, stats and webhooks; docs at /api/v1/docs, OpenAPI schema at /api/v1/openapi.json. Order submission via the API unlocks after 3 delivered orders or with admin approval; Idempotency-Key is supported.
Can I connect ChatGPT or Claude?
Yes. There is an MCP server: connect a partner account to ChatGPT or Claude via OAuth and ask about offers, links, orders and stats in the chat. A separate shop MCP server exists for shoppers.
Is the Meta Conversions API supported?
Yes. Purchase, Delivered and lead-form lead status events are sent to the partner's Meta dataset or landing pixel. Lead-form leads become orders automatically.
What anti-fraud protection does Birinchi Shop have?
Rule-based: a self-order ban (own phone number), a 24-hour duplicate rule, holding orders on low confirmation rates, burst protection for external lead flows, rate limiting and bot click filtering. In addition, an ML model trained on our own order history scores the sale probability of every new order (advisory).
Does Birinchi Shop have AI features?
Yes: an AI assistant in the panel and Telegram (with voice messages), a daily AI manager, offer recommendations, an AI autopilot for Meta ads and AI replies to ad comments. Actions that spend money require confirmation or stay within the daily limit you set.
Are stats updated in real time?
Yes. An open panel shows a new order, a status change or a balance change within 1–2 seconds (Server-Sent Events). New order notifications also arrive in the Telegram bot.
Where can I check whether the site is up?
On the independent monitoring page: birinchishop.uz/status. It checks the site, API and panel every 5 minutes. Measured technical metrics are on the Technical metrics page.
Is there a mobile app?
Yes, an Android app as an APK: birinchishop.uz/reklamachi.apk.