RobiAbebe/verpay

The ultimate, production-ready REST API for verifying Ethiopian bank and mobile money transactions. # Open Source VerPay API **The ultimate, production-ready REST API for verifying Ethiopian bank and mobile money transactions.** Welcome to the definitive open-source verification engine for Ethiopian fintech. This project provides a fully automated way to validate receipts and transactions from various payment providers, complete with an AI-powered OCR fallback. ## What is this used for? This API allows businesses and developers to **programmatically verify the authenticity of customer payments**. Instead of manually checking bank portals or USSD messages to see if a customer actually paid, your application can send the receipt's "Reference Number" (or an image of the receipt) to this API. The API will instantly verify the transaction with the respective bank and return a JSON response confirming if the payment is real, preventing fraud and automating checkout flows. --- ## Key Features * **Extensive Provider Support**: Integrates CBE and Telebirr. * **AI Image Verification**: Upload screenshots of receipts; powered by Mistral AI, the system extracts data and automatically cross-verifies it with the provider (includes built-in QR code extraction for CBE). * **Usage Analytics**: Every API request is logged to Supabase, providing analytics on success rates, endpoints, and durations. * **Serverless Ready**: Out-of-the-box support for Vercel deployment. --- ## Supported Payment Providers | Provider | Reference Format | Example | Implementation | | :--- | :--- | :--- | :--- | | **CBE** | `v2-` prefix followed by alphanumeric | `v2-hfHCxz6TmMYrTUfWldzb` | Direct JSON API (Mbreceipt) | | **Telebirr** | 10 Alphanumeric chars | `AG3HF92K10` | Web Scraping (Proxy support) | --- ## Getting Started ### 1. Database Setup (Supabase) 1. Create a new project at Supabase. 2. Navigate to the SQL Editor in your Supabase dashboard. 3. Copy the contents of `supabase/migrations/001_init.sql` and run it. This creates the `api_keys` and `usage_logs` tables, plus the `i …