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.

2208↓93.8%2PHP

Since May 5Pushed 3w 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 today

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

28

—

LowBetter than 52% of packages

Maintenance62

Regular maintenance activity

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity19

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

[msilabs/bkash

bKash Payment Gateway API for Laravel Framework.

181.2k](/packages/msilabs-bkash)

PHPackages © 2026

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