Install

$ npm install pesapal --save

Getting started

• Signup for a business account at pesapal.com.
• Note the credentials sent via email.

var pesapal = require('pesapal')({
  consumerKey: 'consumer_key',
  consumerSecret: 'consumer_secret',
  testing: false,
});


// post a direct order

var postParams = {
  'oauth_callback': 'https://www.example.com/post_payment_page/'
}
var requestData = {
  'Amount': '100',
  'Description': 'E-book purchase',
  'Type': 'MERCHANT',
  'Reference': '12erwe',
  'PhoneNumber': '0700111000'
}
var url = pesapal.postDirectOrder(postParams, requestData)


// get order status

var postParams = {
  'pesapal_merchant_reference': '000',
  'pesapal_transaction_tracking_id': '000'
}
var url = pesapal.queryPaymentStatus(postParams)

// get order status by ref

var postParams = {
  'pesapal_merchant_reference': '000'
}
var url = pesapal.queryPaymentStatusByMerchantRef(postParams)


// get detailed order status

var postParams = {
  'pesapal_merchant_reference': '000',
  'pesapal_transaction_tracking_id': '000'
}
var url = pesapal.queryPaymentDetails(postParams)


// once you've generated the url
// make request to pesapal

var request = require('superagent');
request()
  .get(url)
  .end(function(err, response){
    if (err) // handle error
    console.log(request.body); // parse response as documented at http://developer.pesapal.com/how-to-integrate/api-reference
  });

Express

For a more opionated solution, checkout express-pesapal(WIP).

Api

consumerKey

configurable consumer key

consumerSecret

configurable consumer secret

testing

variable that sets the base api url as http://demo.pesapal.com/api/ or https://www.pesapal.com/api/

postDirectOrder(postParams, requestData)

returns order url

postParams is a dictionary containing:

• Amount
• Description
• Type
• Reference
• Email or/and PhoneNumber
• Currency ( optional )
• FirstName ( optional )
• LastName ( optional )
• LineItems ( optional )

Line Items

This is an array of the products contained in the order:

{
  LineItems: [
    {
      'uniqueid': '',
      'particulars': '',
      'quantity': '',
      'unitcost': '',
      'subTotal': ''
    }
  ]
}

requestData is a dictionary containing:

• oauth_callback

queryPaymentStatus(options)

returns url to retrive payment status

options is a dictionary containing:

• pesapal_merchant_reference
• pesapal_transaction_tracking_id

queryPaymentStatusByMerchantRef(options)

returns url to retrive payment status

options is a dictionary containing:

• pesapal_merchant_reference

queryPaymentDetails(options)

returns url to retrive a detailed status of a payment

options is a dictionary containing:

• pesapal_merchant_reference
• pesapal_transaction_tracking_id

Test

$ make test

Similar

License

MIT