PHPackages                             dagim/telebirr-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. dagim/telebirr-api

ActiveLibrary[Payment Processing](/categories/payments)

dagim/telebirr-api
==================

Simplify integration of Telebirr's payment gateway into Laravel applications. Generate payment URLs, handle notifications, and ensure secure transactions effortlessly. With robust error handling and configuration flexibility, streamline Telebirr payment integration in your Laravel projects.

2194↓50%2PHP

Since May 5Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Dagimassefa/Telebirr-Package-Laravel)[ Packagist](https://packagist.org/packages/dagim/telebirr-api)[ RSS](/packages/dagim-telebirr-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Telebirr Laravel Integration Package
====================================

[](#telebirr-laravel-integration-package)

Project Description
-------------------

[](#project-description)

Telebirr Laravel Integration Package is a Laravel helper package for integrating Telebirr H5 Web payment functionality into Laravel applications. This package facilitates payment via the web, allowing third-party systems to invoke the interface upon payment issues by the customer. A redirect page is returned to the third-party system from the Telebirr platform upon payment completion.

### Logical Specification

[](#logical-specification)

#### Platform Authentication Rule

[](#platform-authentication-rule)

- Telebirr platform allocates appId and appKey to corresponding third-party clients, uniquely identifying them.
- Third-party source IP addresses must be added to the trust list. IP addresses not on the trust list won't access the Telebirr system.
- The timestamp must be consistent with the server time (within one minute). Inconsistent access is considered illegal.
- Client-entered signatures must match the system-generated signatures. Inconsistent access is considered illegal.

#### Interface Description

[](#interface-description)

ParameterData TypeMandatory/OptionalDescriptionExampleappIdStringMandatoryUnique identifier provided by Telebirr platformce83aaa3dedd42ab88bd017ce1caappKeyStringMandatoryAppKey provided by Telebirr platforma8955b02b5df475882038616d5448d43nonceStringMandatoryUnique random string generated by third-party systemER33419df678o8bbnotifyUrlStringOptionalEndpoint URL from third-party to receive payment resultoutTradeNoStringMandatoryUnique transaction order number generated by third-partyT0533111222S001114129returnUrlStringMandatoryThird-party redirect page URL after payment completionshortCodeStringMandatoryThird-party short code provided by Telebirr8000001subjectStringMandatoryName or item for the payment being issued by the customerBooktimeoutExpressStringMandatoryPayment order request timeout (in minutes)30timestampStringMandatoryTimestamp of the request message (milliseconds)1624546517701totalAmountStringMandatoryOrder amount in ETB9.00receiveNameStringOptionalTransaction receiver's nameEthiopian airlines#### Response Message Elements

[](#response-message-elements)

ParameterData TypeMandatory/OptionalDescriptionExamplecodeStringMandatoryStatus code for payment request0msgStringMandatoryStatus code description for payment requestsuccessdataObjectMandatoryData object consisting of the toPayURLtoPayUrlStringMandatoryTelebirr payment landing page URL to redirect the customer to H5 Web Payment### Getting Started

[](#getting-started)

#### Install the Telebirr Laravel Integration Package:

[](#install-the-telebirr-laravel-integration-package)

```
composer require dagim/telebirr-api:dev-main
```

Usage Example
-------------

[](#usage-example)

```
use Dagim\TelebirrApi\Telebirr;

$telebirr = new Telebirr(
    env('TELEBIRR_APP_ID'),
    env('TELEBIRR_APP_KEY'),
    env('TELEBIRR_PUBLIC_KEY'),
    env('TELEBIRR_PRIVATE_KEY'),
    env('TELEBIRR_API_URL'),
    env('TELEBIRR_SHORT_CODE'),
    env('TELEBIRR_NOTIFY_URL'),
    env('TELEBIRR_RETURN_URL'),
    env('TELEBIRR_TIMEOUT_EXPRESS'),
    env('TELEBIRR_RECEIVE_NAME')
);

$title = 'Product Purchase';
$amount = 100.00;
$orderResult = $telebirr->createOrder($title, $amount);

if ($orderResult['success']) {
    // Payment creation successful
    $paymentId = $orderResult['payment_id'];

} else {
    // Payment creation failed
    $errorMessage = $orderResult['message'];

}
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/a879c11d01ccfd757a04d53690501319aa9cbd2be329759e094abc21e2cfc5ca?d=identicon)[Dagim Assefa](/maintainers/Dagim%20Assefa)

---

Top Contributors

[![Dagimassefa](https://avatars.githubusercontent.com/u/94830418?v=4)](https://github.com/Dagimassefa "Dagimassefa (13 commits)")

### Embed Badge

![Health badge](/badges/dagim-telebirr-api/health.svg)

```
[![Health](https://phpackages.com/badges/dagim-telebirr-api/health.svg)](https://phpackages.com/packages/dagim-telebirr-api)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)