Telebirr Payment Verifier API

A simple API to verify payments made through Telebirr by fetching and parsing receipt data.

API Documentation

Endpoint

GET /verify/{transactionId}

Replace {transactionId} with the 10-character transaction ID from the receipt URL.

Example Request

GET http://localhost:3000/verify/DBN54S90BX

Example Response

{
  "transactionId": "DBN54S90BX",
  "verified": true,
  "payerName": "Shamil Nasir Seid",
  "payerTelebirrNo": "2519****5143",
  "creditedPartyName": "Ethio telecom",
  "creditedPartyAccountNo": "111222",
  "transactionStatus": "Completed",
  "invoiceNo": "DBN54S90BX",
  "paymentDate": "23-02-2026 19:50:47",
  "settledAmount": "1275.00 Birr"
}

Response Fields

transactionId: The transaction ID
verified: Boolean indicating if the payment is completed
payerName: Name of the payer
payerTelebirrNo: Payer's telebirr number
creditedPartyName: Name of the credited party
creditedPartyAccountNo: Account number of the credited party
transactionStatus: Status of the transaction
invoiceNo: Invoice number
paymentDate: Date and time of payment
settledAmount: Amount settled

Demo

Test the API by entering a transaction ID below: