Daraja SDK

A JavaScript SDK for easy integration with the Safaricom Daraja API, facilitating seamless mobile payment and USSD services integration.

Installation

You can install the daraja-api-sdk via npm:

npm install daraja-api-sdk

Usage

const { Transaction } = require('daraja-api-sdk')

// Initialize SDK with your credentials
const transaction = new Transaction({
  customerKey: 'yourCustomerKey',
  customerKeySecret: 'yourCustomerKeySecret',
})

// Example usage: Initiating STK push
// Change these values with your actual details...This is just for demo
const options = {
  BusinessShortCode: '174379',
  TransactionType: 'CustomerPayBillOnline',
  Amount: '1',
  PartyA: 'number sending money',
  PartyB: '174379',
  PhoneNumber: 'The Mobile Number to receive the STK Pin Prompt',
  CallBackURL:
    'It is the endpoint to which the results will be sent by M-Pesa API.',
  AccountReference: 'Test',
  TransactionDesc: 'Test',
}

transaction
  .sendTransaction(options)
  .then((result) => {
    console.log('STK push initiated:', result)
  })
  .catch((error) => {
    console.error('Error initiating STK push:', error.message)
  })

If everything is correct you should get back an object:

{
  "status": 200,
  "MerchantRequestID": "29115-34620561-1",
  "CheckoutRequestID": "ws_CO_191220191020363925",
  "ResponseCode": "0",
  "ResponseDescription": "Success. Request accepted for processing",
  "CustomerMessage": "Success. Request accepted for processing"
}

If you get an error you should get back an object with status code , error message and a possible explanation of the error.

Documentation

For detailed documentation, API reference, and examples, visit the Github respository.