@momofy/sdk

Momofy Node JS SDK

Officially supported momofy package for node Js applications.

Some useful resources

Visit the Documentation

Goto the Dashboard

Installation

To install this package run

  npm install  @momofy/sdk

  yarn add  @momofy/sdk

Environment Variables

To be able to perform transactions using this SDK you need to get your API Secret Key from your Momofy Dashboard.

eg. secret_test_01HPH70VG02DAYJ1N70NP4QWKV

Envronment Types

	Example	Description
Test	secret_test_01HPH70VG02DAYJ1N70NP4QWKV	Use test enviroment during project development
Production	secret_prod_01HPH70VG02DAYJ1N70NP4QWKV	Use production enviroment for live application

Usage

Initiate Transaction

Request a checkout url to received payment from customers

import { Momofy } from "@momofy/sdk"

const momofy = new Momofy("secret_test_01HPH70VG02DAYJ1N70NP4QWKV");

let response = await momofy.transaction.checkout({
    amount: 30,
    redirectUrl: "https://example.com/verify-transaction",
    referenceCode: "",
    transactionNote: "Payment of bills",
  });

Request Response

    {
     success: true,
     message: 'Checkout created successful',
     result: {
       transaction_ref: '00d67012-90b9-45c1-be9f-06ec8d813ddb',
       checkout_url: 'https://app.momofy.com/checkout/c4e1a0e0-80bd-4925-b7bd-c36e48979f13'
    },
    meta: {}
   }

options

Params	Example values	Description
amount	20 or "30"	Amount to be requested from customer
redirectUrl	https://example.com/verify-transaction	A url to be redirected to after successful / failed transaction
reference_code	unique uuidv4 string	Reference code ( will be auto generated when not provided )
transaction_note	Message for transaction	Note to display to user when requesting for payment.

Request Payment

Request payment from your customers

import { Momofy } from "@momofy/sdk"

const momofy = new Momofy("secret_test_01HPH70VG02DAYJ1N70NP4QWKV");

let response = await momofy.transaction.requestPayment({
    amount: 30,
    channel: "mobile_money",
    currency: "GHS",
    customer: {
      email: "[e-mail]",
      name: "Test User",
      phone_number: "024777777",
    },
    provider: "MTN",
    reference_code: "",
    transaction_note: "Payment for DSTV Bill",
  });

Request Response

    {
     success: true,
     message: 'Transaction has been initiated',
     result: { reference_code: 'dee67adb-bcfc-416b-b08b-b7dbb211a210' },
     meta: {}
   }

options

Params	Example values	Description
amount	20 or "30"	Amount to be requested from customer
channel	mobile_money	Only mobile money channel is currently being supported
currency	GHS	The supported currency from the provider
customer	Customer Object	The customer information
provider	MTN or VODAFONE	Network Provider code ( get this from the docs )
reference_code	unique uuidv4 string	Reference code ( will be auto generated when not provided )
transaction_note	Message for transaction	Note to display to user when requesting for payment.

Customer Object

Params	Required	Description
name	Yes	Name of the customer
phone_number	Yes	Momo number of customer to be charged.
email	Yes	Email of the customer (if not available provide organisation email)

Verify Transaction Status

Verify your transaction by providing the transaction ref ID.

import { Momofy } from "@momofy/sdk"

const momofy = new Momofy("secret_test_01HPH70VG02DAYJ1N70NP4QWKV");

let response = await momofy.transaction.verify("dee67adb-bcfc-416b-b08b-b7dbb211a210");

Verification Response

{
  success: true,
  message: 'Transaction retrieved',
  result: {
    id: 17,
    channel: 'mobile_money',
    message: 'Payment for DSTV Bill',
    currency: 'GHS',
    payment_phone: '024777777',
    reference_code: 'a8735819-dbdd-4bf8-a075-8236660ba9d7',
    gateway_status: 'waiting',
    meta_data: null,
    amount: 30,
    status: 'initiated',
    environment: 'test',
  },
  meta: {}
}

Transaction Status Type

Status	Description
initiated	Transaction has been initiated
pending	Transaction has been successfully sent to the provider
success	Transaction was process successfully
failed	Transaction has failed means (may be the user declined the payment request or something bad has happened )

Feedback

If you have any feedback, please feel free to submit an issue.