PHPackages                             roamtech/gateway-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. [API Development](/categories/api)
4. /
5. roamtech/gateway-api

ActiveLibrary[API Development](/categories/api)

roamtech/gateway-api
====================

Roamtech Gateway API implementation

v0.1.3(5y ago)195711MITPHPPHP >=5.6CI failing

Since Dec 18Pushed 5y ago1 watchersCompare

[ Source](https://github.com/weezqyd/gateway-sdk)[ Packagist](https://packagist.org/packages/roamtech/gateway-api)[ RSS](/packages/roamtech-gateway-api/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (4)Versions (12)Used By (1)

Roamtech Gateway API Package
----------------------------

[](#roamtech-gateway-api-package)

### Installation

[](#installation)

Pull in the package through Composer to get the latest stable version.

`$ composer require roamtech/gateway-api`

### Native Addon

[](#native-addon)

When using vanilla PHP, modify your `composer.json` file to include:

```
  "scripts": {
    "post-update-cmd": [
        "Roamtech\\Gateway\\Support\\Bootstrap::run"
    ]
  },
```

This script will copy the default configuration file to a config folder in the root directory of your project. Now proceed to require the package.

### Laravel

[](#laravel)

When using Laravel 5.5+, the package will automatically register. For laravel 5.4 and below, include the service provider and its alias within your `config/app.php`.

```
'providers' => [
    Roamtech\Gateay\Laravel\ServiceProvider::class,
],
```

Publish the package specific config using:

```
php artisan vendor:publish --provider 'Roamtech\Gateay\Laravel\ServiceProvider'
```

### Configuration

[](#configuration)

#### Vanilla PHP

[](#vanilla-php)

For Vanilla PHP you will need to initialize the sdk bootstrapper to get started.

```
use GuzzleHttp\Client;
use Roamtech\Gateway\Engine\Core;
use Roamtech\Gateway\Native\NativeCache;
use Roamtech\Gateway\Native\NativeConfig;
use Roamtech\Gateway\Client as GatewayClient;

require "vendor/autoload.php";

$config = new NativeConfig(__DIR__.'/config/roamtechapi.php');
// Configure the HTTP client
$client = new Client(['base_uri' => $config->get('roamtechapi.api_endpoint')]);
$core = new Core($client, $config, new NativeCache($config));
$gateway = new GatewayClient($core);
```

#### Laravel

[](#laravel-1)

Laravel configuration is straight forward. After installation the API client is registered in the service container as:

```
$gateway = resolve('roamtech.client');
// Or Type hint it in method definitions
use Roamtech\Gateway\Client as GatewayClient;

class Mycontroller extends Controller {

    /**
     * @var GatewayClient
     */
    private $apiClient;

    /**
     * Inject client in constructor
     *
     * @param GatewayClient $apiClient
     */
    public function __construct(GatewayClient $apiClient)
    {
        $this->apiClient = $apiClient;
    }
}
```

SMS
---

[](#sms)

#### Send Bulk SMS

[](#send-bulk-sms)

Send SMS in bulk mode, this endpoints allows you to send multiple messages in a single API call.

```
$messages = [
    ['recipient' => '25472xxxxxxx', 'message' => 'This is a test message'],
    ['recipient' => '25471xxxxxxx', 'message' => 'This is a a custom message']
];
// Using the gateway instance we can now invoke the API with our payload

$response = $gateway->sms()->sendBulkMessages($messages, ['from' => 'YourSenderId']);
var_dump($response);
```

#### Send single SMS

[](#send-single-sms)

This API allows you to send a single message to one or multiple recipients.

```
$recipients = ['25472xxxxxxx', '25471xxxxxxx'];
$message = 'A test message to say hello';
$options = [
    'from' => 'YourSenderId'
    'messageId' => '345623',
    'callback' => 'http://yoursite.com/sms/callback/345623',
];

// Let us send our message
$response = $gateway->sms()->sendMessage($message, $recipients, $options);
var_dump($response);
```

#### Get Delivery reports

[](#get-delivery-reports)

To get delivery reports for messages use this snipet

```
$messageId = '448768fjkhgcs4cykxuy8747r9c489';
$response = $gateway->sms()->getDeliveryReport($messageId);
var_dump($response);
```

### Airtime

[](#airtime)

You can also credit airtime to your customers instantly. This Api is asynchronous when you initiate a request our API will respond back to you with the transaction and a pending status. We will then send a callback to your application with the final status.

```
$recipients = [
    [
        'phoneNumber' => '25472xxxxxxx',
        'amount' => 10
    ],
    [
        'phoneNumber' => '25471xxxxxxx',
        'amount' => 10
    ]
];
$callback = 'http://mysite.com/callback?id=50';

// initiate the airtime purchase transaction
$response = $gateway->airtime()
->setRecipients($recipients)
->setCallback($callback)
->purchase();

var_dump($response);
```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~59 days

Recently: every ~98 days

Total

11

Last Release

2109d ago

PHP version history (2 changes)v0.0.1-alphaPHP >=7.0

v0.0.2-alphaPHP >=5.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/e96a8fb006579076bb41b7d543654038bb9ea28addeb9ac685daee5011195eb3?d=identicon)[weezqyd](/maintainers/weezqyd)

---

Top Contributors

[![weezqyd](https://avatars.githubusercontent.com/u/11520842?v=4)](https://github.com/weezqyd "weezqyd (2 commits)")

---

Tags

apilaravelsmsgatewayroamtech

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/roamtech-gateway-api/health.svg)

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

###  Alternatives

[mollie/laravel-mollie

Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[specialtactics/l5-api

Dependencies for the Laravel API Boilerplate package

3672.8k2](/packages/specialtactics-l5-api)

PHPackages © 2026

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