Javascript Payment Gateway API for BML and MIB
this PHP library by Ahmed Khusaam.
This is an approximate javascript port ofThis library provides a class with methods to generate transaction requests to the bank's endpoint and parse subsequent responses from the bank posted to the merchant's callback url.
Warning
Although this is a javascript library, it is meant to be used on the server-side, specifically in a node js environment. Please do NOT attempt to use this in a client-side application as it would expose the shared secret between you and the bank to the client.
Installation
npm install gateway-mv-js
Usage
Configuration and Instantiation
The main class can be imported by simply requiring the package. The class can be instantiated by calling it with the new
operator. The constructor expects two arguments. The first argument is a string that represents the bank, which can be either 'BML' for the Bank of Maldives endpoint, or 'MIB' for the Maldives Islamic Bank endpoint. The second argument is a configuration object.
const Gateway = require const config =
Preparing a New Transaction Request
A new transaction request can be generated by calling generateTransactionRequest
. It expects the first argument to be the value of the transaction in the currency that was set in the configuration step. The second argument is a unique transaction ID. The transaction ID should never be repeated, even for transactions that are being retried. The function returns an object containing the POST parameters that should be included in the POST request to the bank's endpoint
const transaction = gateway.generateTransactionRequest
Verifying the bank's response to a given transaction
The verification method, verifyResponseSignature
is called once the bank calls back with its response to a particular transaction request. The first argument is the relevant transaction id. The second argument is an object containing POST parameters sent back by the bank to the callback url. The function returns a boolean; true if the signature sent by the bank checks out, false if not.
const verified = gateway.verifyResponseSignature