PHPackages                             alex-nguetcha/intouch - 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. alex-nguetcha/intouch

ActiveLibrary

alex-nguetcha/intouch
=====================

The Intouch Payment Library is a PHP library that provides a simple interface for making payments with mobile money service providers that are supported by the Intouch platform. This library handles the complexities of interacting with the Intouch API, allowing you to focus on building your application.

1.0.2(3y ago)222MITPHP

Since Mar 21Pushed 3y ago1 watchersCompare

[ Source](https://github.com/AlexNguetcha/intouch-api-wrapper)[ Packagist](https://packagist.org/packages/alex-nguetcha/intouch)[ RSS](/packages/alex-nguetcha-intouch/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

Intouch Payment Library
=======================

[](#intouch-payment-library)

The Intouch Payment Library is a PHP library that provides a simple interface for making payments with mobile money service providers that are supported by the Intouch platform. This library handles the complexities of interacting with the Intouch API, allowing you to focus on building your application.

Installation
------------

[](#installation)

To install the Intouch Payment Library, you can use [Composer](https://getcomposer.org/), a package manager for PHP. Run the following command in your project directory:

```
composer require alex-nguetcha/intouch

```

Complete example
----------------

[](#complete-example)

Here is an complete example of a use case

```
$intouch = Intouch::credentials(
    username: 'username',
    password: 'password',
    loginAgent: 'loginAgent',
    passwordAgent: 'passwordAgent',
    intouchId: 'passwordAgent'
)->callback('https://app.test/confirm-payment')
    ->amount(100)
    ->phone(6xxxxxx)
    ->operator('ORANGE')
    ->makeMerchantPayment(
        [
            "recipientEmail" => "john@example.com",
            "recipientFirstName" => "John",
            "recipientLastName" => "Doe",
        ]
    );

if ($intouch->isInitiated()) {
    // Your transaction has been initiated by intouch API
    // echo (string)($intouch->getResult()->getBody());
} else {
    // something went wrong
    // echo $intouch->getError()['request'];
    // echo $intouch->getError()['response'];
}
```

Usage
-----

[](#usage)

To use the Intouch Payment Library, you must first obtain credentials from the [Intouch platform](https://intouchgroup.net/). These credentials include a username, password, login agent, password agent, and Intouch ID. You can then create an instance of the `Intouch` class, passing in your credentials:

```
use AlexNguetcha\Intouch\Intouch;

$intouch = Intouch::credentials(
    username: 'your-username',
    password: 'your-password',
    loginAgent: 'your-login-agent',
    passwordAgent: 'your-password-agent',
    intouchId: 'your-intouch-id'
);
```

Initiating a Payment
--------------------

[](#initiating-a-payment)

Once you have created an instance of the `Intouch` class, you can initiate a payment using the `makeMerchantPayment` method. This method takes an array of payment information, including the amount to be paid, the mobile money account to be debited, and the recipient information:

Before initiating a payment, you need to set the payment details using the following methods:

```
$intouch->amount(100); // Set the amount to be paid
$intouch->phone('1234567890'); // Set the mobile money account to be debited
$intouch->operator('MTN'); // Set the mobile money operator for the transaction
$intouch->callback('https://example.com/payment/callback');
```

### Callbacks

[](#callbacks)

Intouch sends a notification to your application when a payment is completed. You can set a callback URL using the `callback` method. This URL will be called by Intouch with a payload containing information about the completed payment:

```
$intouch->makeMerchantPayment([
    "recipientEmail" => "john@example.com",
    "recipientFirstName" => "John",
    "recipientLastName" => "Doe",
    "phone" => "1234567890",
    "amount" => 100,
    "operator" => "MTN",
    "reason" => "Payment for goods and services",
]);
```

```
$intouch->callback('https://your-app.com/intouch-callback');
```

Handling the Response
---------------------

[](#handling-the-response)

You can check if a payment was successfully initiated using the isInitiated method. If the payment was initiated, you can access the response using the getResult method. If something went wrong, you can access error information using the getError method:

```
if ($intouch->isInitiated()) {
    // Your transaction has been initiated by intouch API
    echo (string)($intouch->getResult()->getBody());
} else {
    // something went wrong
    // echo $intouch->getError()['request'];
    echo $intouch->getError()['response'];
}
```

Conclusion
----------

[](#conclusion)

The Intouch Payment Library provides a simple and convenient way to interact with the Intouch API and make mobile money payments. By following the steps outlined in this documentation, you can easily integrate mobile money payments into your PHP application.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

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 ~0 days

Total

2

Last Release

1146d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/24b749896c2d186d34caa6b48d325f40e5386d8feee5a4909d003d888ce58bc7?d=identicon)[AlexNguetcha](/maintainers/AlexNguetcha)

---

Top Contributors

[![AlexNguetcha](https://avatars.githubusercontent.com/u/57802413?v=4)](https://github.com/AlexNguetcha "AlexNguetcha (14 commits)")

---

Tags

mobile-paymentspayment-integrationphpphp-library

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alex-nguetcha-intouch/health.svg)

```
[![Health](https://phpackages.com/badges/alex-nguetcha-intouch/health.svg)](https://phpackages.com/packages/alex-nguetcha-intouch)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k20](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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