Telebirr Verification

How to verify a Telebirr receipt

Telebirr is Ethio Telecom's mobile money service with over 40 million users in Ethiopia. Tuna verifies Telebirr receipts by parsing their HTML response pages.

⚠️ Geo-blocked — Telebirr's receipt endpoint is only accessible from Ethiopian IP addresses. If you're outside Ethiopia, use a VPN or self-host Tuna.

What you need

  • Transaction reference — Found on your Telebirr receipt or SMS notification
  • Ethiopian IP — The endpoint is geo-blocked outside Ethiopia

Step-by-step verification

1

Find your reference number

Open your Telebirr app or check your SMS. The reference is usually labeled "Transaction ID" or "Ref". It's a string of letters and numbers.

2

Select Telebirr

Choose "Telebirr" from the bank dropdown, or paste the reference — Tuna auto-detects Telebirr references.

3

Verify

Tuna fetches the receipt HTML from Telebirr's endpoint, parses the transaction details, and returns structured data: amount, sender, receiver, date, and status.

Telebirr receipt formats

Telebirr returns receipts as HTML pages with embedded transaction data. Tuna parses the HTML to extract:

  • • Transaction amount and currency
  • • Sender name and phone number
  • • Receiver name and phone number
  • • Transaction date and time
  • • Transaction status (successful/failed)
  • • Reference number

Common errors

"Geo-blocked"

Telebirr's endpoint only works from Ethiopian IPs. Use a VPN or self-host Tuna in Ethiopia.

"Receipt not found"

The reference might be incorrect, or the receipt has expired. Telebirr typically retains receipts for 30 days.

API verification

# Verify a Telebirr transaction
curl -X POST https://api.txna.me/verify \
-H "Content-Type: application/json" \
-d '{"bank": "telebirr", "ref": "TR1234567890"}'