Joelorbit/chek

High-performance payment verification engine, smart router, and webhook bridge built for developers, Telegram bot creators, and merchants in Ethiopia. 🧾 Chek — Ethiopian Payment Verification Engine & Webhook Relay High-performance payment verification engine, smart router, and webhook bridge built for developers, Telegram bot creators, and merchants in Ethiopia. Supports CBE, Telebirr, Bank of Abyssinia, Dashen, CBE Birr, Safaricom M-Pesa, Awash, Coop, Hibret, Zemen, Nib, Wegagen, and Amhara. --- ## ⚡ Highlights - **🧾 Chek Universal Smart Router (`POST /verify`)**: Pass any reference code, token, URL, or receipt text and Chek automatically detects the bank and verifies transaction details. - **⚡ Sub-Second Verification**: Direct mobile API gateways, cached headless scrapers, and deterministic text tokenizers. - **🔄 Multi-Relay Circuit Breaker**: Distributed hedging pool to bypass Telebirr and M-Pesa foreign datacenter geo-blocks. - **🔔 Webhooks & HMAC SHA-256 Signatures**: Asynchronous delivery via BullMQ with exponential backoff and dead-letter queues (`X-Chek-Signature`). - **📷 Multimodal Vision OCR**: Screenshot verification powered by Mistral AI (`ministral-14b-2512`) with atomic credit guards and automated refund on upstream error. - **🛍️ E-Commerce & Checkout Suite**: Hosted payment links, product catalogues, order states (`PENDING`, `PAID`, `EXPIRED`), and merchant payout account matching. --- ## 📑 Documentation - 📘 **Developer Guide & API Reference** - 🔬 **Under The Hood & Architecture Deep Dive** --- ## 🏦 Supported Banks & Payment Methods | Financial Institution | Protocol / Verification Method | Auto-Detection | Live Lookup / Text | | :--- | :--- | :---: | :---: | | **Commercial Bank of Ethiopia (CBE)** | Mobile JSON API (`mb.cbe.com.et`), Port 100 PDF, Text | Yes | ✅ Both Supported | | **Ethio Telecom Telebirr** | Scraper + Multi-Relay Circuit Breaker Pool | Yes | ✅ Both Supported | | **Bank of Abyssinia (BoA)** | Public Slip API (`FT...` + 5-digit suffix) | Yes | ✅ Both Supported | | **Dashen Bank** | SuperApp Public PDF Parser (`receipt.dashensuperapp.com`) | Yes | ✅ Both Supported | | **C …