swift-kuda-node v1.0.1

Kuda Node.js Library

NodeJS wrapper for making secure request to Kuda API

Getting started

• paste your private and public key (both in XML format) in your project directory
• Your client key is the name of your private key file

Using the library

run npm install swift-kuda-node

Library setup

const fs = require("fs");
const Kuda = require('swift-kuda-node'); 

const publicKey = fs.readFileSync("./kuda.public.xml"); // or path to your kuda public key
const privateKey = fs.readFileSync("./path-to-private-key.xml"); // or path to your kuda kuda private key
const clientKey = "name-of-private-key-file"; // name of private key file without the .xml suffix (extension)
const baseUrl = 'https://kuda-openapi.kuda.com/v1​';


const kuda = Kuda({
  publicKey,
  privateKey,
  clientKey,
  baseUrl
}); // this initialize the Kuda function

Making a request

kuda({
  serviceType: "SERVICE_TYPE",
  requestRef: "requestReference",
  data: {
    param: value
  }
});

Sample request

// account creation
const shortid = require("shortid"); // this libarary will generate random id for you. You can install with `yarn add shortid` or `npm i shortid`. You can use any other random key generatring library of your choice

// it can also be called with in an async await fashion like so
const onboardUser = async(email, phoneNumber, firstName, lastName, trackingReference) => {
  const response = await kuda({
    serviceType: 'ADMIN_CREATE_VIRTUAL_ACCOUNT',
    requestRef: Number, // like Math.floor(Math.random() * 1000000000000 + 1)
    data: { email, phoneNumber, firstName, lastName, trackingReference }
  })
}

Refer to documentation for respective data types for each fields in the payload

Contribution & Issues

• Simply fork the repo, make changes and make a pull request
• You can open an issue for support or suggestions

Authors

• Sodiq Alabi
• Ajala Abdulsamii
• Abdulazeez Murainah
• Azeez Adio

Acknowledgements

• Kuda Bank Team
• Ebidhaa Services Tech Team