Telebirr endpoint URL format
The Telebirr receipt endpoint is: https://transactioninfo.ethiotelecom.et/receipt/{REFERENCE}. The URL takes only the transaction reference as a path parameter. Example: DET8FJGUJ4.
HTML response structure
Telebirr returns an HTML page styled as a receipt. cheki fetches the HTML and extracts text from the DOM elements. The page is bilingual (English and Amharic).
Field mappings for Telebirr
cheki normalizes Telebirr receipts into a standard JSON shape regardless of the source format:
- senderName: the account holder who sent the payment
- receiverName: the account holder who received the payment
- amount: the transferred amount in ETB
- currency: always ETB for domestic transfers
- date: transaction date and time
- reference: the Telebirr transaction reference number
- sourceUrl: the full URL cheki fetched the receipt from
Frequently asked questions
What format does Telebirr use for receipts?
Telebirr publishes receipts as HTML page. The endpoint is https://transactioninfo.ethiotelecom.et/receipt/{REFERENCE}. The HTML page contains payer name, receiver name, amount, and date in a bilingual (English/Amharic) format.
Do I need authentication to access Telebirr receipts?
No. The Telebirr receipt endpoint at https://transactioninfo.ethiotelecom.et/receipt/{ref} is publicly accessible without authentication. However, it is geo-blocked to Ethiopian IP addresses. This is by design: banks want merchants to be able to verify payments without needing API keys or login credentials.
What fields are in a Telebirr receipt?
The Telebirr HTML receipt contains: payer name, payer phone number, receiver name, receiver account, amount in Birr, and transaction date/time.
Read the API docs
Open cheki