Lipisha Payments Node SDK
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Lipisha Payments Node SDK

This package provides bindings for Lipisha Payments API (


See usage examples below.


  • Send money
  • Acknowledge transactions
  • Send SMS
  • Get Float
  • Get Balance
  • Charge card transactions
  • Search transactions
  • Search customers
  • Add users
  • Add payment accounts and withdrawal accounts


npm install lipisha

Or install it yourself as:

git clone

$ npm install -g .


var lipisha = require('lipisha');

// In this case api key and signature are stored in environmental variables
var client = new lipisha.Lipisha(process.env.LIPISHA_API_KEY, process.env.LIPISHA_API_SIGNATURE, 'live')

client.get_balance(function(err, response) {
    if (error) {
        // handle error

/** Sample logged response from the above apii call.
* { status: 
*   { status_code: 0,     status: 'SUCCESS',
*     status_description: 'Balance Found' },
*  content: { balance: '175.4600', currency: 'KES' } }

client.send_money('03XXX', '07XXYYYZZZ', 200, function(err, response) { 
    if (err) {
        // handle error

IPN Examples

IPN Integration examples for Express are in the examples directory

Running Tests

Edit the test configuration in test/base_test.js

Run all tests

npm install


Run a particular test

mocha --grep "Pattern for test"

e.g. Balance test

mocha --grep Balance


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request