zaincash v1.0.5

ZainCash Nodejs Package

A nodejs package that will help you adding ZainCash as a payment method in your website. This package works with express & jesonwebtoken.

Installation

Install the zaincash package by running this command:

  $ npm i zaincash

Other Packages to install

• You have to install express.js to have a running server for your website.
• You also need to install JWT.
• And install request library in order to get redirected to ZainCash payment page.

Quick Start !

• You have to create a route handler that will handle the payment process.
• Require zaincash package inside your app.
• ZainCash package exporting a class so you will have to create a new instance from it
• Call zaincash init function to initialize the payment, this function will return a promise so you will have to handle it.
• init function will return a ZainCash transaction id that you can send as a parameter to pay function in order to get redirected to ZainCash payment page.

plase check the simple code below

const express = require('express');
const app = express();
const ZC = require('zaincash');

// preparing payment data
const paymentData = {
  amount: 250,
  orderId: 'some id',
  serviceType: 'some serviceType',
  redirectUrl: 'example.com/redirect',
  production: false,
  msisdn: '964****',
  merchantId: '5a647d843321dcd9cbc771c',
  secret: '$2y$10$9eaqimBisY15ZJZSSvC3Z.Ar1ET1.7Kgm8p7jysY1X.I8.RuwS.',
  lang: 'ar'
}

// payment route handler
app.post('/pay', (req, res) => {
  let zc = new ZC(paymentData);
  zc.init().then(transactionId => {
    //  Save the transactionId in your DB
    console.log(transactionId);
    zc.pay(transactionId, res);
  }).catch(err => {
    res.status(400).send(err);
  });
});
//  starting a server
app.listen(3000);

Payment Data

There are some data that you have to get it from ZainCash and there are others that you are free to fill them

What to do more

You will have to create a redirect handler, this will work as an endpoint you will send it to zaincash by setting it to the redirectUrl it will be such as 'http://yourhost/redierct' zaincash will return a token contains the payment status to this endpoint, ie: 'http://yourhost/redierct?token=XXXX' You will have to decode this JWT token and check the payment status Check the simple code below:

const jwt = require('jsonwebtoken');

//  Handeling the redierct
app.get('redirect', (req, res) => {
  const token = req.body.token;
  if(token){
    try {
      var decoded = jwt.verify(token, process.env.SECRET);
    } catch(err) {
      // err
    }
    if(decoded.status == 'success'){
      // Do whatever you like
    }else {
      //  Do other things
    }
  }
});

Redirect Token Content

The Token will be encoded with the same secret shared by ZainCash, and it will contain: