Overview
The Verifier API allows developers in Ethiopia to verify CBE and Telebirr payments via reference number or receipt image. It uses web scraping and AI-based OCR to extract transaction details, providing a reliable way to confirm payment status for your applications.
With this API, you can automate payment verification processes, reduce manual checks, and integrate payment confirmation into your digital services, e-commerce platforms, or financial applications.
Authentication
All verification endpoints require an API key for authentication. You can obtain an API key from the dashboard.
API Key Usage
There are two ways to include your API key in requests:
1. HTTP Header (Recommended)
x-api-key: YOUR_API_KEY2. Query Parameter
https://verifyapi.leulzenebe.pro/verify-telebirr?apiKey=YOUR_API_KEYEndpoints
Sample Requests
curl -X POST https://verifyapi.leulzenebe.pro/verify-cbe \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"reference": "TXN123456789",
"accountSuffix": "12345678"
}'Environment
The Verifier API interacts with Telebirr and CBE systems, which have certain regional restrictions and requirements.
Regional Restrictions
Telebirr verification only works reliably from Ethiopia. Foreign servers may be blocked by Telebirr endpoints. Use Ethio Telecom hosting or enable fallback proxy in your configuration.
Configuration Options
You can configure the API behavior using environment variables in your server:
# .env file example SKIP_PRIMARY_VERIFICATION=true # Use fallback proxy for verification VERIFY_API_KEY=your_api_key
Admin Endpoints
Admin-only Endpoints
The following endpoints are restricted to administrators only and require the x-admin-key header for authentication. However, you can explore how they work by checking out the open-source repository on GitHub.
Creates a new API key for a user. Requires admin authentication.
Retrieves usage statistics for the API. Requires admin authentication.
Admin Access
Admin access is restricted to authorized personnel only.
Support
The Verifier API is maintained by Leul Zenebe, Creofam LLC. If you need assistance or have questions about the API, please don't hesitate to reach out.