UPDATES & TIMELINE

Product Changelog

Stay up to date with the latest features, API upgrades, and improvements to the Verifier ecosystem.

v3.1.0

2026-02-22

added
  • Database Schema Updates: Added `keyHash`, `prefix`, `tier`, and `userId` relational mapping to the `ApiKey` model for enhanced security and identity management.
  • Database Schema Updates: Added `createdAt` tracking to the `User` model.
changed
  • Note for contributors: Because of these schema changes, anyone cloning or pulling the repository must run `pnpm prisma db push` (or `npx prisma db push`) to synchronize their local database.
fixed
  • Fixed `P2025` Prisma errors on API Key update and delete routes by enforcing an explicit `findUnique` ownership check before mutation.
  • Fixed `ECONNREFUSED` error during API Key generation in production by swapping the hardcoded `localhost:3001` with the dynamic `VERIFIER_API_URL` environment variable.

v3.0.0

2026-02-22

added
  • Universal Verification Endpoint (POST /verify): A smart router that dynamically detects the payment provider (CBE, Telebirr, Dashen, Bank of Abyssinia, CBE Birr) based on the reference number structure and payload, simplifying client integrations.
changed
  • Promoted Universal Router POST /verify endpoint as the highlighted/recommended method in primary documentation.

v2.1.1

2026-02-21

added
  • Add new M-Pesa verification endpoint with API integration and PDF parsing.
  • Update Postman collection to include M-Pesa endpoints.
fixed
  • Increase timeout for Telebirr verification to handle proxy retry logic.
  • Implement retry mechanism for Dashen receipt fetching with 5 attempts.
  • Update CBE Birr PDF parsing to handle actual document structure.
  • Increase wait time for CBE PDF detection from 3s to 6s.
  • Resolved a bug where the verifyCBEBirr service would fail implicitly if an API key was not explicitly provided through the inner service layer.
  • Fixed Express route precedence order to prevent the new /verify route from swallowing explicit /verify-* prefix calls.

v2.1.0

2025-11-13

added
  • Telebirr: Return bankName in receipt payloads.
changed
  • Bump API version to 2.1.0 in package.json, root endpoint, README, Postman collection.

v1.1.0

2025-05-18

added
  • API Key Authentication: All verification endpoints now require a valid API key.
  • Admin Routes: POST /admin/api-keys, GET /admin/api-keys, GET /admin/stats.
  • Usage Statistics Logging: Each request is logged to a UsageLog table.
  • Prisma + MySQL Integration: Introduced full Prisma schema and MySQL connection.
changed
  • Moved all key storage and logic from in-memory Maps to persistent DB.
security
  • Admin routes are protected using x-admin-key headers.
  • API keys are validated per request.

v1.0.0

2025-05-12

added
  • CBE Verification via reference and suffix using Puppeteer and PDF parsing.
  • Telebirr Verification using raw reference scraping.
  • Image-Based Verification powered by Mistral AI, detecting CBE or Telebirr receipts.
  • Express API with simple POST endpoints: /verify-cbe, /verify-telebirr, /verify-image.