Download the PHP package patricpoba/mtn-momo-api-php without Composer
On this page you can find all versions of the php package patricpoba/mtn-momo-api-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download patricpoba/mtn-momo-api-php
More information about patricpoba/mtn-momo-api-php
Files in patricpoba/mtn-momo-api-php
Package mtn-momo-api-php
Short Description Php wrapper for MTN Momo API - https://momodeveloper.mtn.com
License MIT
Homepage https://github.com/patricpoba/mtn-momo-api-php
Informations about the package mtn-momo-api-php
MTN MoMo API
This package helps you integrate the MTN MOMO API into your Php or Laravel application. Its wrapper around the MTN Open API to provide you with a much simpler API to work with.
Installation
You are required to have PHP 7.0 or later. You can install the package via composer:
Usage
In production, the needed credentials are provided for you on the MTN OVA management dashboard after KYC requirements are met. But in a testing environment, a sanbox user would have to be created by you using the API, which this package can do for you.
Creating a sandbox environment API user
We need to get the User ID
and User Secret
and to do this we shall need to use the Primary Key for the Product to which we are subscribed, as well as specify a host. The library ships with a commandline application that helps to create sandbox credentials. It assumes you have created an account on https://momodeveloper.mtn.com
and have your Ocp-Apim-Subscription-Key
(primaryKey) located at https://momodeveloper.mtn.com/developer
.
The option c
is your callback host and the option k
is the primary key or Ocp-Apim-Subscription-Key
for the specific product to which you are subscribed. The API Key
is unique to the product and you will need an API Key
for each product you use. You should get a response similar to the following:
Configuration
We have to setup up the package to utilise the our momodeveloper credentials by creating an instance of the MtnConfig
and pass it to the constructor of the class of the product (collection, disbursement or remittance) we want to use as
demonstrated below. The configuration can be overriden a product instance by calling the ->setConfig($config)
method and passing the new config instance.
Collection
Collections is used for requesting a payment from a customer (Payer) and checking status of transactions. Read more on Momo Collection
collectionPrimaryKey
: Primary Key for theCollection
product on the developer portal.collectionUserId
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.collectionApiSecret
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.
Collection Methods
-
requestToPay
: This operation is used to request a payment from a consumer (Payer). The payer will be asked to authorize the payment. The transaction is executed once the payer has authorized the payment. The transaction will be in status PENDING until it is authorized or declined by the payer or it is timed out by the system. Status of the transaction can be validated by checking thestatus
field on the result ofgetTransaction()
method. -
getTransaction
: Retrieve transaction information using thetransactionId
returned byrequestToPay
. You can invoke it at intervals until the transaction fails or succeeds. -
getBalance
: Get the balance of the account. accountHolderActive
: check if an account holder is registered and active in the system.
Disbursement
Disbursement is used for transferring money from the provider account to a customer. Read more on Momo Disbursement
disbursementPrimaryKey
: Primary Key for theDisbursement
product on the developer portal.disbursementUserId
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.disbursementApiSecret
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.
Disbursement Methods
-
transfer
: This operation is used to request a payment from a consumer (Payer). The payer will be asked to authorize the payment. The transaction is executed once the payer has authorized the payment. The transaction will be in status PENDING until it is authorized or declined by the payer or it is timed out by the system. Status of the transaction can be validated by checking thestatus
field on the result ofgetTransaction()
method. -
getTransaction
: Retrieve transaction information using thetransactionId
returned byrequestToPay
. You can invoke it at intervals until the transaction fails or succeeds. -
getBalance
: Get the balance of your disbursement account. accountHolderActive
: check if an account holder is registered and active in the system.
Remittance
Transfer operation is used to transfer an amount from the own account to a payee account.
disbursementPrimaryKey
: Primary Key for theDisbursement
product on the developer portal.disbursementUserId
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.disbursementApiSecret
: For development environment, use the sandbox credentials else use the one on thedeveloper portal
.
Api Responses
All api calls return the PatricPoba\MtnMomo\Http\ApiResponse object which is described below:
Testing
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Patric Poba
- All Contributors
- PHP Package Boilerplate.
License
The MIT License (MIT). Please see License File for more information.