A package to help integrate ssentezo wallet into your php application
- Create a ssentezo wallet account
The recommended way to install ssentezo wallet is through Composer:
$ composer require codelords/ssentezo-wallet
After ssentezo wallet installs, you can copy an example file to the project root.
$ cp vendor/code-lords/ssentezo-wallet/resources/example.php .
To make transactions you only need to create an instance of the ssentezo wallet
use Codelords\SsentezoWallet;
$username = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
$password = "zzzzzzzzzzzzzzzzzzzzzzzzzzzz";
$wallet = new SentezoWallet($username, $password);With the wallet object you can easily check balance, make deposits withdrawals and as well check status of a transaction.
Before we look at how you can make transactions, Let's first look at the configurations.
/**
* Environment
* You can choose which environment you are using your wallet.
* There are two possibilites production and sandbox
* For testing purposes always use sandbox to avoid making errors that may result int real
* money losses.
*/
$wallet->setEnvironment("sandbox");
/**
* Currency
* You can also select a currency you want to use
*
*/
$wallet->setCurrency("UGX");Here is a list of all the possible configurations and the various methods you can use to manipulate them.
| Configuration | Description | Values | Setter | Getter |
|---|---|---|---|---|
| Environment | The enviroment you are using your wallet in | production, sandbox | setEnvironment($value) | getEnvironment() |
| Currency | The currency | UGX, KES | setCurrency($value) | getCurrency() |
| Callback | A valid url which ssentezo wallet calls incase the transaction completes | A valid url | setCallback($url) | getCallback() |
use Codelords\SsentezoWallet;
$wallet = new SsentezoWallet($username, $password);
$username = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API username
$password = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API password
$phone_number = "+256771234567";
$amount = 10000.00;
$transaction_ref = "xxx";//Some unique reference to the transaction
$narrative = "xxx"; //A description of the transaction
$successCallbackUrl = "https://example.com/success";//A call back once the transaction is successful
try {
$ret = $wallet->deposit($phone_number,$amount,$transaction_ref,$narrative,$successCallbackUrl);
//
}catch(\Exception $e){
//Something wrong happened
echo "Exception: ". $e->getMessage();
}$transaction_ref = "xxx";//The unique identifier of the transaction
$username = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API username
$password = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API password
$wallet = new SsentezoWallet($username, $password);
try {
$response = $wallet->checkStatus($prn);//The response object has all the information about the transaction
//You can then find the status
switch ($response->status) {
case "SUCCEEDED": // For success
break;
case "FAILED": //Failed the transaction
break;
case "PENDING": //Still Pending
break;
case "INDETERMINATE": //As the name suggests
break;
default:// WTF
}
} catch (Exception $e) {
//Something went wrong
echo "Exception: ".$e->getMessage();
}use Codelords\SsentezoWallet;
$wallet = new SsentezoWallet($username, $password);
$username = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API username
$password = "xxxxxxxxxxxxxxxxxxxxx";//Put here your API password
$phone_number = "+256771234567";
$amount = 10000.00;
$transaction_ref = "xxx";//Some unique reference to the transaction
$narrative = "xxx"; //A description of the transaction
$successCallbackUrl = "https://example.com/success";//A call back once the transaction is successful
try {
$response = $wallet->withdraw($phone_number, $amount, $transaction_ref, $narrative, $successCallback);
//
}catch(\Exception $e){
//Something wrong happened
echo "Exception: ". $e->getMessage();
}