ZibaPaySDK

The ZibaPaySDK is a Node.js package designed to simplify the integration of the Zibapay Payment API. This SDK enables developers to interact with the Zibapay API to initiate MTN Mobile Money (MoMo) payments with minimal setup.

Features

• Easy integration with the Zibapay Payment API.
• Handles API authentication using API key and secret.
• Supports MTN Mobile Money payments.
• Provides robust error handling for API requests.

---

Installation

Install the package using npm or yarn:

1npm install zibapay-sdk
2# or
3yarn add zibapay-sdk
4

---

Usage

Import the sdk

1import ZibaPaySDK from "zibapay-sdk";  

---

Initialize SDK

-To start using the SDK, you need your API key and API secret from Zibapay:

1const zibaPay = new ZibaPaySDK("your-api-key", "your-api-secret");

Initiate MTN Momo Payment

1(async () => {  
2    try {  
3        const paymentResponse = await zibaPay.initiateMtnPayment({  
4            phoneNumber: "250788123456", // Customer's phone number  
5            amount: 1000,               // Payment amount  
6            currency: "RWF",            // Currency (e.g., RWF)  
7            description: "Payment for Order #12345", // Payment description  
8        });  
9
10        console.log("Payment Response:", paymentResponse);  
11    } catch (error) {  
12        console.error("Payment Failed:", error.message);  
13    }  
14})();  
15

API Reference

Constructor

1new ZibaPaySDK(apiKey: string, apiSecret: string)  

• apiKey: Your Zibapay API key.
• apiSecret: Your Zibapay API secret.

Methods

*initiateMtnPayment(params: initiateMtnPayment): Promise Initiates an MTN Mobile Money payment

Parameters

params (object): An object containing payment details: phoneNumber (string): The phone number of the payer (e.g., "250788123456"). amount (number): The payment amount. currency (string): The currency (e.g., "RWF"). description (string): Description of the transaction.

Returns

Promise: A promise resolving to the API response.

Example Response

1{  
2    "status": "success",  
3    "message": "Payment initiated successfully",  
4    "transactionId": "123456789"  
5}  
6

Support

For help with the Zibapay SDK, contact Zibapay Support or create an issue on the project's repository.

License

This project is licensed under the MIT License.