ttechnos/telebirr

Laravel package for Telebirr payment integration

v1.1.2 2026-07-20 22:22 UTC

Requires

• php: ^7.4|^8.0
• ext-openssl: *
• phpseclib/phpseclib: ^3.0
• spatie/crypto: ^2.0

Requires (Dev)

• phpunit/phpunit: ^9.5

MIT

• Tito Hailu

Published on Packagist.org on 2026-07-20 22:32 UTC

README

A Laravel package for integrating the Telebirr H5 (Web Checkout) payment gateway. Provides methods to create orders, handle auth tokens, and verify callback signatures.

Documentation

Browse the step-by-step guides in the docs folder:

• Installation Guide
• Configuration Guide
• Payment Flow
• Webhook Callbacks
• Queries & Refunds

Requirements

• PHP 7.4 or higher
• Laravel 8.x, 9.x, 10.x, 11.x
• OpenSSL extension

Installation

composer require ttechnos/telebirr

Quick Start

use Ttechnos\Telebirr\Facades\Telebirr;

// Create payment order
$order = Telebirr::createOrder('Product Title', 100.50, [
    'notify_url'   => 'https://yourapp.com/api/telebirr/callback',
    'redirect_url' => 'https://yourapp.com/payment/success',
]);

$prepayId   = $order['prepay_id'];
$rawRequest = $order['raw_request'];

// Query order status
$status = Telebirr::queryOrder($prepayId);

// Refund a payment
$refund = Telebirr::refundOrder(10.00, $paymentOrderId);

// Verify webhook signature
$isValid = Telebirr::verifySignature($requestData);

Features

• H5 Web Checkout (B2C)
• Fabric Token Auth
• Query Order Status
• Refund Payments
• RSA-PSS Webhook Signature Verification

Contributing

See CONTRIBUTING.md for details on how to contribute.

License

MIT License. See LICENSE for more information.