Providers overview
All supported receipt URL shapes, the reference formats inside them, and which response schema each one returns.
v.odit.et resolves an inbound URL or reference into an upstream call against
one of these hosts, parses the response, and returns a provider-tagged
receipt object. The source field on the receipt (or its absence) tells you
which schema you're looking at.
| Provider | Source tag | Hosts | Return shape |
|---|---|---|---|
| Telebirr | telebirr-html | transactioninfo.ethiotelecom.et | HTML scraped → JSON |
| CBE — PDF | (none, legacy) | apps.cbe.com.et | PDF parsed → JSON |
| CBE — JSON | mb-json | mb.cbe.com.et · mbreciept.cbe.com.et (plain id) | JSON re-mapped |
| Zemen Bank | zemen-pdf | share.zemenbank.com | PDF parsed → JSON |
| Bank of Abyssinia | boa-json | cs.bankofabyssinia.com | JSON envelope flattened |
| Awash Bank | awash-html | awashpay.awashbank.com:8225 | HTML scraped → JSON |
Two amounts to remember:
- Reference numbers shown in URLs are placeholders (
ABCD1234EF,FT00000000, …) — substitute your own when testing - All receipts are immutable once issued, so v.odit.et caches them forever; the second hit on the same URL returns instantly from cache and shows
x-cache: HIT