Official Node.js SDK by Katorymnd (Katorymnd Web Solutions) for PawaPay mobile money API integration in Africa
# pawaPay Node.js SDK
A professional, high-performance Node.js SDK for integrating with the **pawaPay API**.
This SDK provides a streamlined interface for **mobile money deposits, refunds, payouts**, and **real-time transaction verification**, built for production-grade fintech applications.
---
## 🏗️ Architecture
The SDK is designed for maximum reliability and speed. It utilizes a **Native Core Integration** to handle complex cryptographic operations and data normalization, ensuring that your payment processing is both fast and secure across all supported environments.
### Folder Structure
```text
example/ # Implementation samples and workflows
data/ # Localized MNO & API configurations
src/ # SDK Source code
├── api/ # API Request wrappers
├── core/ # Native runtime binaries
└── utils/ # Internal helper logic
tests/ # Automated test suites
scripts/ # SDK management utilities
```
---
## 🚀 Key Features
| Feature | Description |
| :--- | :--- |
| **Native Performance** | Core logic is executed via optimized native bindings. |
| **Hybrid V1/V2 Support** | Toggle between pawaPay API V1 and V2 within the same project. |
| **MNO Intelligence** | Automatic network availability checks before payment initiation. |
| **Enterprise Logging** | Structured logging for successful and failed transaction flows. |
| **Platform Optimized** | Pre-compiled for Windows, Linux, and macOS (Intel & Apple Silicon). |
---
## 📦 Installation
The SDK is cross-platform and will automatically utilize the correct native components for your specific server architecture.
```bash
npm install @katorymnd/pawapay-node-sdk
# or
pnpm add @katorymnd/pawapay-node-sdk
```
---
## 🛠️ Configuration (.env)
Set up your project environment with your pawaPay credentials and SDK access keys.
```bash
# .env.example
# Sandbox API token (for testing environment)
PAWAPAY_SANDBOX_API_TOKEN=your_sandbox_api_token_here
# Production API …