Node.js

The IremboPay Node.js SDK is a powerful and developer-friendly tool designed to simplify the integration of payment functionality into your Node.js applications. With a comprehensive suite of features, the SDK streamlines transaction management, making it effortless to handle payment processing within the IremboPay ecosystem. Whether you’re building a new application or enhancing an existing one, the IremboPay Node.js SDK ensures seamless integration, robust performance, and a smooth development experience.

Installation

npm install @irembo/irembopay-node-sdk

Initialization

const IremboPay = require("@irembo/irembopay-node-sdk").default;
const iPay = new IremboPay(process.env.IPAY_SECRET_KEY,process.env.IPAY_ENVIRONMENT)

Invoice

Create Invoice

iPay.invoice.createInvoice({
  transactionId: "TST-100236",
  paymentAccountIdentifier: "07808652516",
  customer: {
    email: "[e-mail]",
    phoneNumber: "0780000001",
    name: "Jixle Manzi",
  },
  paymentItems: [
    {
      unitAmount: 2000,
      quantity: 1,
      code: "PC-aaf751b73f",
    },
  ],
  description: "Invoice description",
  expiryAt: "2024-09-30T01:00:00+02:00",
  language: "EN",
}).then((data) => {
    console.log(data);
}).catch((error) => {
    console.log(error);
});

Create batch invoice

iPay.invoice.createBatchInvoice({
    invoiceNumbers: ["880530635201", "880530633460"],
    transactionId: "TST-1001125",
    description: "Batch description",
  })
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    console.log(error);
  });

Get invoice

const invoiceReference = '880530633460'
iPay.invoice.getInvoice(invoiceReference)
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    console.log(error);
  });

Update invoice

iPay.invoice.updateInvoice(880530633460, {
    expiryAt: "2024-10-24T14:15:22Z",
    paymentItems: [
      {
        unitAmount: 2000,
        quantity: 1,
        code: "PC-aaf751b73f",
      },
    ],
  })
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    console.log(error);
  });

Payment

Initiate mobile money push payment

iPay.payment.mobileMoney.initiatePayment({
    accountIdentifier: "0781110011",
    paymentProvider: "MTN",
    invoiceNumber: "880310977877",
    transactionReference: "MTN_001",
  })
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    console.log(error);
  });

Payment Notifications

Verifying the signature

const rawBody = req.body.toString('utf8');
const header = req.headers;
const signature = header['irembopay-signature'];  
const paymentVerification = await iPay.util.verifySignature(rawBody, signature);