mpesakit 2.0.0__tar.gz → 2.0.2__tar.gz

{mpesakit-2.0.0 → mpesakit-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpesakit
-Version: 2.0.0
+Version: 2.0.2
 Summary: A Python SDK for integrating with M-Pesa APIs
 Project-URL: Homepage, https://github.com/rafaeljohn9/mpesakit
 Project-URL: Repository, https://github.com/rafaeljohn9/mpesakit
@@ -21,6 +21,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Requires-Dist: cryptography>=41.0.7
+Requires-Dist: httpx<1.0.0,>=0.27.0
 Requires-Dist: pydantic<3.0.0,>=2.10.6
 Requires-Dist: pydantic[email]<3.0.0,>=2.10.6
 Requires-Dist: requests<3.0.0,>=2.32.3
@@ -34,6 +35,7 @@ Requires-Dist: hatch-vcs; extra == 'dev'
 Requires-Dist: hatchling; extra == 'dev'
 Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio<1.0.0,>=0.23.6; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: types-requests; extra == 'dev'
@@ -42,18 +44,20 @@ Requires-Dist: bandit; extra == 'test'
 Requires-Dist: mypy; extra == 'test'
 Requires-Dist: pyngrok; extra == 'test'
 Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-asyncio<1.0.0,>=0.23.6; extra == 'test'
 Requires-Dist: pytest-cov; extra == 'test'
 Requires-Dist: types-requests; extra == 'test'
 Description-Content-Type: text/markdown
 
-# mpesa-daraja-sdk
+# mpesakit
 
 > ⚡ **Effortless M-Pesa integration** using Safaricom's Daraja API — built for developers, by developers.
 
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
-<!-- [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]() -->
+[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()
 
+[![PyPI version](https://img.shields.io/pypi/v/mpesakit.svg)](https://pypi.org/project/mpesakit) [![Downloads](https://pepy.tech/badge/mpesakit)](https://pepy.tech/project/mpesakit)
 ---
 
 ## The Problem
@@ -73,7 +77,7 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 ## The Solution
 
-**`mpesa-daraja-sdk`** eliminates the complexity with a **clean, developer-friendly Python SDK** that:
+**`mpesakit`** eliminates the complexity with a **clean, developer-friendly Python SDK** that:
 
 - **Zero-config setup** — just add your credentials and go
 - **Handles authentication automatically** — OAuth2, tokens, and security
@@ -86,13 +90,19 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 | Feature | Status | Description |
 |---------|--------|-------------|
-| **STK Push** | Ready | Lipa na M-Pesa Online payments |
-| **C2B Payments** | Ready | Customer to Business transactions |
-| **B2C Payments** | Ready | Business to Customer payouts |
-| **Token Management** | Ready | Automatic OAuth2 handling |
-| **Account Balance** | Coming Soon | Check account balances |
-|  **Transaction Reversal** | Coming Soon | Reverse transactions |
-| 🎣 **Webhook Validation** | Coming Soon | Secure callback handling |
+| **STK Push (Lipa na M-Pesa)** | Ready | Initiate customer payment prompts (mpesa-express/stk-push.mdx) |
+| **STK Query** | Ready | Query STK push/payment status (mpesa-express/stk-query.mdx) |
+| **C2B Payments** | Ready | Customer-to-Business payments (c2b.mdx) |
+| **B2C Payments** | Ready | Business-to-Customer payouts (b2c.mdx) |
+| **B2C Account Top-up** | Ready | Account top-up flows for B2C (b2c-account-top-up.mdx) |
+| **Business Paybill** | Ready | Paybill integrations for business collections (business-paybill.mdx) |
+| **Business BuyGoods** | Ready | Till/BuyGoods integrations (business-buygoods.mdx) |
+| **Token Management / Auth** | Ready | Automatic OAuth2 handling and auth utilities (auth.mdx) |
+| **Account Balance** | Ready | Check account balances (account-balance.mdx) |
+| **Transaction Reversal** | Ready | Reverse transactions (reversal.mdx) |
+| **Transaction Status** | Ready | Query transaction status (transaction-status.mdx) |
+| **Dynamic QR** | Ready | Generate and manage dynamic QR payments (dynamic-qr.mdx) |
+| **Tax Remittance** | Ready | Tax remittance flows and docs (tax-remittance.mdx) |
 
 > Built on top of [Arlus/mpesa-py](https://github.com/Arlus/mpesa-py) with ❤️ — modernized, cleaned up, and restructured for today's developer needs.
 
@@ -100,41 +110,17 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 ## Quick Start
 
-### Installation (coming soon)
+### Installation (already here :) )
 
 ```bash
-pip install mpesa-daraja-sdk
+pip install mpesakit
 ```
 
 ---
 
 ## 📖 Complete Setup Guide
 
-### 1. Get Safaricom Developer Account
-
-1. Visit [developer.safaricom.co.ke](https://developer.safaricom.co.ke)
-2. **Create account** and verify your email
-3. **Create a new app** to get your credentials:
-   - Consumer Key
-   - Consumer Secret
-
-### 2. Obtain Test Credentials (Sandbox)
-
-1. Navigate to [Test Credentials Page](https://developer.safaricom.co.ke/test_credentials)
-2. Copy the following credentials:
-   - **Shortcode** (Business number)
-   - **Initiator Name** (API operator username)
-   - **Initiator Password** (API operator password)
-   - **Security Credential** (Encrypted password)
-
-### 3. Production Setup
-
-For production deployment:
-
-1. **Get Paybill/Till Number** from Safaricom
-2. **Generate Security Credential** using Safaricom's public certificate
-3. **Switch environment** to `"production"` in your client initialization
-4. **Update callback URLs** to your production domain
+- For the complete setup guide kindly check the documentation at: [https://mpesakit.dev](https://mpesakit.dev)
 
 ---
 
@@ -165,8 +151,8 @@ We welcome contributions from the community! Here's how you can help:
 
 ```bash
 # Clone the repository
-git clone https://github.com/rafaeljohn9/mpesa-daraja-sdk.git
-cd mpesa-daraja-sdk
+git clone https://github.com/rafaeljohn9/mpesakit.git
+cd mpesakit
 
 # Create virtual environment
 python -m venv venv
@@ -176,7 +162,7 @@ source venv/bin/activate  # On Windows: venv\Scripts\activate
 pip install -e ".[dev]"
 
 # Run tests
-pytest tests/
+pytest tests/unit
 ```
 
 ### Code Standards
@@ -191,8 +177,8 @@ pytest tests/
 ## 📞 Support & Community
 
 - 📖 **Documentation**: [Full API docs coming soon]
-- 🐛 **Issues**: [GitHub Issues](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues)
-- 💬 **Discussions**: [GitHub Discussions](https://github.com/rafaeljohn9/mpesa-daraja-sdk/discussions)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/rafaeljohn9/mpesakit/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/rafaeljohn9/mpesakit/discussions)
 - 📧 **Email**: <johnmkagunda@gmail.com>
 
 ---
@@ -203,11 +189,11 @@ This project began as a fork of the fantastic [`Arlus/mpesa-py`](https://github.
 
 **What we've added:**
 
-- 🏗️ **Modular architecture** for better maintainability
-- 🎯 **Developer-first design** with intuitive APIs
-- 🧪 **Comprehensive testing** suite
-- 📚 **Better documentation** and examples
-- 🚀 **Production-ready** features and error handling
+- **Modular architecture** for better maintainability
+- **Developer-first design** with intuitive APIs
+- **Comprehensive testing** suite
+- **Better documentation** and examples
+- **Production-ready** features and error handling
 
 Special thanks to the original contributors and the broader Python community in Kenya.
 
@@ -223,6 +209,6 @@ Licensed under the [Apache 2.0 License](LICENSE) — free for commercial and pri
 
 **Made with ❤️ for the Kenyan developer community**
 
-[⭐ Star this repo](https://github.com/rafaeljohn9/mpesa-daraja-sdk) | [🐛 Report Issue](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues) | [💡 Request Feature](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues/new)
+[⭐ Star this repo](https://github.com/rafaeljohn9/mpesakit) | [🐛 Report Issue](https://github.com/rafaeljohn9/mpesakit/issues) | [💡 Request Feature](https://github.com/rafaeljohn9/mpesakit/issues/new)
 
 </div>

{mpesakit-2.0.0 → mpesakit-2.0.2}/README.md

@@ -1,11 +1,12 @@
-# mpesa-daraja-sdk
+# mpesakit
 
 > ⚡ **Effortless M-Pesa integration** using Safaricom's Daraja API — built for developers, by developers.
 
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
-<!-- [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]() -->
+[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()
 
+[![PyPI version](https://img.shields.io/pypi/v/mpesakit.svg)](https://pypi.org/project/mpesakit) [![Downloads](https://pepy.tech/badge/mpesakit)](https://pepy.tech/project/mpesakit)
 ---
 
 ## The Problem
@@ -25,7 +26,7 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 ## The Solution
 
-**`mpesa-daraja-sdk`** eliminates the complexity with a **clean, developer-friendly Python SDK** that:
+**`mpesakit`** eliminates the complexity with a **clean, developer-friendly Python SDK** that:
 
 - **Zero-config setup** — just add your credentials and go
 - **Handles authentication automatically** — OAuth2, tokens, and security
@@ -38,13 +39,19 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 | Feature | Status | Description |
 |---------|--------|-------------|
-| **STK Push** | Ready | Lipa na M-Pesa Online payments |
-| **C2B Payments** | Ready | Customer to Business transactions |
-| **B2C Payments** | Ready | Business to Customer payouts |
-| **Token Management** | Ready | Automatic OAuth2 handling |
-| **Account Balance** | Coming Soon | Check account balances |
-|  **Transaction Reversal** | Coming Soon | Reverse transactions |
-| 🎣 **Webhook Validation** | Coming Soon | Secure callback handling |
+| **STK Push (Lipa na M-Pesa)** | Ready | Initiate customer payment prompts (mpesa-express/stk-push.mdx) |
+| **STK Query** | Ready | Query STK push/payment status (mpesa-express/stk-query.mdx) |
+| **C2B Payments** | Ready | Customer-to-Business payments (c2b.mdx) |
+| **B2C Payments** | Ready | Business-to-Customer payouts (b2c.mdx) |
+| **B2C Account Top-up** | Ready | Account top-up flows for B2C (b2c-account-top-up.mdx) |
+| **Business Paybill** | Ready | Paybill integrations for business collections (business-paybill.mdx) |
+| **Business BuyGoods** | Ready | Till/BuyGoods integrations (business-buygoods.mdx) |
+| **Token Management / Auth** | Ready | Automatic OAuth2 handling and auth utilities (auth.mdx) |
+| **Account Balance** | Ready | Check account balances (account-balance.mdx) |
+| **Transaction Reversal** | Ready | Reverse transactions (reversal.mdx) |
+| **Transaction Status** | Ready | Query transaction status (transaction-status.mdx) |
+| **Dynamic QR** | Ready | Generate and manage dynamic QR payments (dynamic-qr.mdx) |
+| **Tax Remittance** | Ready | Tax remittance flows and docs (tax-remittance.mdx) |
 
 > Built on top of [Arlus/mpesa-py](https://github.com/Arlus/mpesa-py) with ❤️ — modernized, cleaned up, and restructured for today's developer needs.
 
@@ -52,41 +59,17 @@ For many developers and startups, this becomes a **huge barrier** to adopting M-
 
 ## Quick Start
 
-### Installation (coming soon)
+### Installation (already here :) )
 
 ```bash
-pip install mpesa-daraja-sdk
+pip install mpesakit
 ```
 
 ---
 
 ## 📖 Complete Setup Guide
 
-### 1. Get Safaricom Developer Account
-
-1. Visit [developer.safaricom.co.ke](https://developer.safaricom.co.ke)
-2. **Create account** and verify your email
-3. **Create a new app** to get your credentials:
-   - Consumer Key
-   - Consumer Secret
-
-### 2. Obtain Test Credentials (Sandbox)
-
-1. Navigate to [Test Credentials Page](https://developer.safaricom.co.ke/test_credentials)
-2. Copy the following credentials:
-   - **Shortcode** (Business number)
-   - **Initiator Name** (API operator username)
-   - **Initiator Password** (API operator password)
-   - **Security Credential** (Encrypted password)
-
-### 3. Production Setup
-
-For production deployment:
-
-1. **Get Paybill/Till Number** from Safaricom
-2. **Generate Security Credential** using Safaricom's public certificate
-3. **Switch environment** to `"production"` in your client initialization
-4. **Update callback URLs** to your production domain
+- For the complete setup guide kindly check the documentation at: [https://mpesakit.dev](https://mpesakit.dev)
 
 ---
 
@@ -117,8 +100,8 @@ We welcome contributions from the community! Here's how you can help:
 
 ```bash
 # Clone the repository
-git clone https://github.com/rafaeljohn9/mpesa-daraja-sdk.git
-cd mpesa-daraja-sdk
+git clone https://github.com/rafaeljohn9/mpesakit.git
+cd mpesakit
 
 # Create virtual environment
 python -m venv venv
@@ -128,7 +111,7 @@ source venv/bin/activate  # On Windows: venv\Scripts\activate
 pip install -e ".[dev]"
 
 # Run tests
-pytest tests/
+pytest tests/unit
 ```
 
 ### Code Standards
@@ -143,8 +126,8 @@ pytest tests/
 ## 📞 Support & Community
 
 - 📖 **Documentation**: [Full API docs coming soon]
-- 🐛 **Issues**: [GitHub Issues](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues)
-- 💬 **Discussions**: [GitHub Discussions](https://github.com/rafaeljohn9/mpesa-daraja-sdk/discussions)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/rafaeljohn9/mpesakit/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/rafaeljohn9/mpesakit/discussions)
 - 📧 **Email**: <johnmkagunda@gmail.com>
 
 ---
@@ -155,11 +138,11 @@ This project began as a fork of the fantastic [`Arlus/mpesa-py`](https://github.
 
 **What we've added:**
 
-- 🏗️ **Modular architecture** for better maintainability
-- 🎯 **Developer-first design** with intuitive APIs
-- 🧪 **Comprehensive testing** suite
-- 📚 **Better documentation** and examples
-- 🚀 **Production-ready** features and error handling
+- **Modular architecture** for better maintainability
+- **Developer-first design** with intuitive APIs
+- **Comprehensive testing** suite
+- **Better documentation** and examples
+- **Production-ready** features and error handling
 
 Special thanks to the original contributors and the broader Python community in Kenya.
 
@@ -175,6 +158,6 @@ Licensed under the [Apache 2.0 License](LICENSE) — free for commercial and pri
 
 **Made with ❤️ for the Kenyan developer community**
 
-[⭐ Star this repo](https://github.com/rafaeljohn9/mpesa-daraja-sdk) | [🐛 Report Issue](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues) | [💡 Request Feature](https://github.com/rafaeljohn9/mpesa-daraja-sdk/issues/new)
+[⭐ Star this repo](https://github.com/rafaeljohn9/mpesakit) | [🐛 Report Issue](https://github.com/rafaeljohn9/mpesakit/issues) | [💡 Request Feature](https://github.com/rafaeljohn9/mpesakit/issues/new)
 
 </div>

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/account_balance/account_balance.py

@@ -43,5 +43,5 @@ class AccountBalance(BaseModel):
             "Authorization": f"Bearer {self.token_manager.get_token()}",
             "Content-Type": "application/json",
         }
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
         return AccountBalanceResponse(**response_data)

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/account_balance/schemas.py

@@ -136,7 +136,7 @@ class AccountBalanceResultMetadata(BaseModel):
     """Metadata for Account Balance result notification."""
 
     ResultType: int = Field(..., description="Type of result (0=Success, 1=Waiting).")
-    ResultCode: int = Field(..., description="Result code (0=Success).")
+    ResultCode: int | str = Field(..., description="Result code (0=Success).")
     ResultDesc: str = Field(..., description="Result description.")
     OriginatorConversationID: str = Field(
         ..., description="Originator conversation ID."
@@ -238,7 +238,7 @@ class AccountBalanceResultCallback(BaseModel):
 class AccountBalanceResultCallbackResponse(BaseModel):
     """Schema for response to Account Balance result callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0, description="Result code (0=Success, other=Failure)."
     )
     ResultDesc: str = Field(
@@ -279,7 +279,7 @@ class AccountBalanceTimeoutCallback(BaseModel):
 class AccountBalanceTimeoutCallbackResponse(BaseModel):
     """Schema for response to Account Balance timeout callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0,
         description="Result code (0=Success, other=Failure).",
     )

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/b2b_express_checkout/schemas.py

@@ -108,7 +108,7 @@ class B2BExpressCheckoutCallback(BaseModel):
 class B2BExpressCallbackResponse(BaseModel):
     """Response schema for B2B Express Checkout callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0,
         description="Result code (0=Success, other=Failure).",
     )

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/b2c/b2c.py

@@ -43,5 +43,5 @@ class B2C(BaseModel):
             "Authorization": f"Bearer {self.token_manager.get_token()}",
             "Content-Type": "application/json",
         }
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
         return B2CResponse(**response_data)

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/b2c/schemas.py

@@ -167,7 +167,7 @@ class B2CResultMetadata(BaseModel):
     """Metadata for B2C result notification."""
 
     ResultType: int = Field(..., description="Type of result (0=Success, 1=Failure).")
-    ResultCode: int = Field(..., description="Result code (0=Success).")
+    ResultCode: int | str = Field(..., description="Result code (0=Success).")
     ResultDesc: str = Field(..., description="Result description.")
     OriginatorConversationID: str = Field(
         ..., description="Originator conversation ID."
@@ -279,7 +279,7 @@ class B2CResultCallback(BaseModel):
 class B2CResultCallbackResponse(BaseModel):
     """Schema for response to B2C result callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0, description="Result code (0=Success, other=Failure)."
     )
     ResultDesc: str = Field(
@@ -320,7 +320,7 @@ class B2CTimeoutCallback(BaseModel):
 class B2CTimeoutCallbackResponse(BaseModel):
     """Schema for response to B2C timeout callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0,
         description="Result code (0=Success, other=Failure).",
     )

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/b2c_account_top_up/schemas.py

@@ -120,7 +120,7 @@ class B2CAccountTopUpCallbackResult(BaseModel):
     ResultType: int = Field(
         ..., description="Status code for transaction sent to listener."
     )
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         ..., description="Transaction result status code. 0 means success."
     )
     ResultDesc: str = Field(
@@ -231,13 +231,13 @@ class B2CAccountTopUpCallback(BaseModel):
 
     def is_successful(self) -> bool:
         """Check if the callback indicates a successful transaction."""
-        return self.Result.ResultCode == 0
+        return str(self.Result.ResultCode) == "0"
 
 
 class B2CAccountTopUpCallbackResponse(BaseModel):
     """Response schema for B2C Account TopUp callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0, description="Result code of the callback. 0 indicates success."
     )
     ResultDesc: str = Field(
@@ -297,7 +297,7 @@ class B2CAccountTopUpTimeoutCallback(BaseModel):
 class B2CAccountTopUpTimeoutCallbackResponse(BaseModel):
     """Schema for response to B2C Account TopUp timeout callback."""
 
-    ResultCode: int = Field(
+    ResultCode: int | str = Field(
         default=0,
         description="Result code (0=Success, other=Failure).",
     )

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/business_buy_goods/business_buy_goods.py

@@ -43,5 +43,5 @@ class BusinessBuyGoods(BaseModel):
             "Authorization": f"Bearer {self.token_manager.get_token()}",
             "Content-Type": "application/json",
         }
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
         return BusinessBuyGoodsResponse(**response_data)

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/business_buy_goods/schemas.py

@@ -240,7 +240,7 @@ class BusinessBuyGoodsResultCallback(BaseModel):
 class BusinessBuyGoodsResultCallbackResponse(BaseModel):
     """Response schema for Business Buy Goods result callback."""
 
-    ResultCode: int = 0
+    ResultCode: int | str = 0
     ResultDesc: str = "Callback received successfully."
 
     model_config = ConfigDict(
@@ -289,7 +289,7 @@ class BusinessBuyGoodsTimeoutCallback(BaseModel):
 class BusinessBuyGoodsTimeoutCallbackResponse(BaseModel):
     """Response schema for Business Buy Goods timeout callback."""
 
-    ResultCode: int = 0
+    ResultCode: int | str = 0
     ResultDesc: str = "Timeout notification received successfully."
 
     model_config = ConfigDict(

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/business_paybill/business_paybill.py

@@ -43,5 +43,5 @@ class BusinessPayBill(BaseModel):
             "Authorization": f"Bearer {self.token_manager.get_token()}",
             "Content-Type": "application/json",
         }
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
         return BusinessPayBillResponse(**response_data)

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/business_paybill/schemas.py

@@ -229,13 +229,13 @@ class BusinessPayBillResultCallback(BaseModel):
 
     def is_successful(self) -> bool:
         """Check if the result indicates success."""
-        return self.Result.ResultCode == 0
+        return str(self.Result.ResultCode) == "0"
 
 
 class BusinessPayBillResultCallbackResponse(BaseModel):
     """Response schema for Business PayBill result callback."""
 
-    ResultCode: int = 0
+    ResultCode: int | str = 0
     ResultDesc: str = "Callback received successfully."
 
     model_config = ConfigDict(
@@ -271,7 +271,7 @@ class BusinessPayBillTimeoutCallback(BaseModel):
 class BusinessPayBillTimeoutCallbackResponse(BaseModel):
     """Response schema for Business PayBill timeout callback."""
 
-    ResultCode: int = 0
+    ResultCode: int | str = 0
     ResultDesc: str = "Timeout notification received successfully."
 
     model_config = ConfigDict(

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/c2b/c2b.py

@@ -41,7 +41,7 @@ class C2B(BaseModel):
             "Authorization": f"Bearer {self.token_manager.get_token()}",
             "Content-Type": "application/json",
         }
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
 
         # Safaricom API Bug: There is a typo in the response field name
         # "OriginatorCoversationID" should be "OriginatorConversationID"

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/c2b/schemas.py

@@ -152,7 +152,7 @@ class C2BValidationRequest(BaseModel):
     ThirdPartyTransID: Optional[str] = Field(
         None, description="Partner transaction ID (optional)."
     )
-    MSISDN: int = Field(..., description="Customer mobile number.")
+    MSISDN: int | str = Field(..., description="Customer mobile number.")
     FirstName: Optional[str] = Field(None, description="Customer's first name.")
     MiddleName: Optional[str] = Field(None, description="Customer's middle name.")
     LastName: Optional[str] = Field(None, description="Customer's last name.")
@@ -226,7 +226,7 @@ class C2BValidationResponse(BaseModel):
 class C2BConfirmationResponse(BaseModel):
     """Schema for confirmation acknowledgment from your ConfirmationURL."""
 
-    ResultCode: int = Field(0, description="Always 0 (success).")
+    ResultCode: int | str = Field(0, description="Always 0 (success).")
     ResultDesc: str = Field("Success", description="Usually 'Success'.")
 
     model_config = ConfigDict(

{mpesakit-2.0.0 → mpesakit-2.0.2}/mpesakit/dynamic_qr_code/dynamic_qr_code.py

@@ -44,6 +44,6 @@ class DynamicQRCode(BaseModel):
             "Content-Type": "application/json",
         }
 
-        response_data = self.http_client.post(url, json=dict(request), headers=headers)
+        response_data = self.http_client.post(url, json=request.model_dump(by_alias=True), headers=headers)
 
         return DynamicQRGenerateResponse(**response_data)

mpesakit-2.0.2/mpesakit/http_client/__init__.py

@@ -0,0 +1,5 @@
+from .http_client import HttpClient,AsyncHttpClient
+from .mpesa_http_client import MpesaHttpClient
+from .mpesa_async_http_client import MpesaAsyncHttpClient
+
+__all__ = ["HttpClient", "MpesaHttpClient","AsyncHttpClient","MpesaAsyncHttpClient"]

mpesakit-2.0.2/mpesakit/http_client/http_client.py

@@ -0,0 +1,53 @@
+"""http_client.py: Defines an abstract base HTTP client class for making HTTP requests.
+
+Provides a reusable interface for GET and POST requests.
+"""
+
+from typing import Dict, Any, Optional
+from abc import ABC, abstractmethod
+
+
+class HttpClient(ABC):
+    """Abstract base HTTP client for making GET and POST requests."""
+
+    @abstractmethod
+    def post(
+        self, url: str, json: Dict[str, Any], headers: Dict[str, str]
+    ) -> Dict[str, Any]:
+        """Sends a POST request."""
+        pass
+
+    @abstractmethod
+    def get(
+        self,
+        url: str,
+        params: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
+        """Sends a GET request."""
+        pass
+
+class AsyncHttpClient(ABC):
+    """Abstract base HTTP client for making asynchronous GET and POST requests.
+
+    This is the base class for all asynchronous HTTP client implementations.
+    It provides the foundation for making asynchronous HTTP requests, which are
+    essential for interacting with the Mpesa API non-blockingly.
+    """
+
+    @abstractmethod
+    async def post(
+        self, url: str, json: Dict[str, Any], headers: Dict[str, str]
+    ) -> Dict[str, Any]:
+        """Sends an asynchronous POST request."""
+        pass
+
+    @abstractmethod
+    async def get(
+        self,
+        url: str,
+        params: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
+        """Sends an asynchronous GET request."""
+        pass