raqm-core 0.2.0__tar.gz → 0.2.5__tar.gz

{raqm_core-0.2.0 → raqm_core-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: raqm-core
-Version: 0.2.0
+Version: 0.2.5
 Summary: Unified Python SDK for Pakistani payment gateways (EasyPaisa, JazzCash, HBL, ABL, UBL, etc.)
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -19,7 +19,9 @@ Requires-Dist: pydantic>=2.0
 
 One async, type-safe interface across multiple processors — EasyPaisa, JazzCash, HBL, ABL, UBL, and more.
 
-> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. Contributions welcome!
+> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. JazzCash is in progress. Contributions welcome!
+>
+> ⚠️ **Breaking change in v0.2.4** — methods now **raise `PaymentError`** on business-level failures instead of returning a result with a non-success response code. Wrap calls in try/except to handle errors gracefully.
 
 ---
 
@@ -28,7 +30,7 @@ One async, type-safe interface across multiple processors — EasyPaisa, JazzCas
 | Gateway | Status |
 |---------|--------|
 | [EasyPaisa](https://easypaisa.com.pk) | ✅ Live |
-| [JazzCash](https://jazzcash.com.pk) | 🚧 Header utils ready |
+| [JazzCash](https://jazzcash.com.pk) | 🚧 In progress |
 | HBL | 📅 Planned |
 | ABL | 📅 Planned |
 | UBL | 📅 Planned |
@@ -173,6 +175,33 @@ result.paymentMode         # str ("MA", "OTC", "CC")
 
 ---
 
+## Error Handling
+
+All gateway methods raise typed exceptions on failure:
+
+```
+RaqmCoreError          # Base exception for the SDK
+├── NetworkError       # HTTP/transport errors (connection, timeout, 4xx/5xx)
+└── PaymentError       # Business-level failures (non-success response code)
+                      #   .response — the full gateway response object
+```
+
+```python
+from raqm_core.exceptions.exceptions import NetworkError, PaymentError
+
+try:
+    result = await ep.pay_via_ma(...)
+except NetworkError as e:
+    print(f"Network issue: {e}")
+except PaymentError as e:
+    print(f"Payment failed: {e}")
+    print(f"Response code: {e.response.responseCode}")
+```
+
+`PaymentError` carries the gateway's response object in `exc.response`, so you can inspect the raw error details even when the SDK raises.
+
+---
+
 ## Architecture
 
 Each payment gateway follows a consistent 3-layer structure:
@@ -190,15 +219,20 @@ Current structure:
 
 ```
 src/
-├── easypaisa.py              # EasyPaisa client
+├── easypaisa.py               # EasyPaisa client
+├── jazzcash.py                # JazzCash client
+├── exceptions/
+│   └── exceptions.py          # Custom exception hierarchy
 ├── headers/
-│   ├── easypaisa.py          # Basic Auth header
-│   └── jazzcash.py           # SHA-256 secure hash
+│   ├── easypaisa.py           # Basic Auth header
+│   └── jazzcash.py            # SHA-256 secure hash
 └── schemas/
-    └── easypaisa.py          # EasyPaisa Pydantic models
+    ├── easypaisa.py           # EasyPaisa Pydantic models
+    └── jazzcash.py            # JazzCash Pydantic models
 
 tests/
 ├── test_easypaisa.py         # EasyPaisa integration tests
+├── test_jazzcash.py          # JazzCash integration tests
 └── headers/
     ├── test_easypaisa.py     # Auth header unit tests
     └── test_jazzcash.py      # Secure hash unit tests
@@ -302,7 +336,7 @@ Add the new gateway to the **Supported Gateways** table with the appropriate sta
 - [ ] HBL payment gateway
 - [ ] ABL payment gateway
 - [ ] UBL payment gateway
-- [ ] Standardised error handling across gateways
+- [x] Standardised error handling across gateways
 - [ ] Request/response logging middleware
 - [ ] CI/CD + automated testing
 

{raqm_core-0.2.0 → raqm_core-0.2.5}/README.md

@@ -4,7 +4,9 @@
 
 One async, type-safe interface across multiple processors — EasyPaisa, JazzCash, HBL, ABL, UBL, and more.
 
-> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. Contributions welcome!
+> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. JazzCash is in progress. Contributions welcome!
+>
+> ⚠️ **Breaking change in v0.2.4** — methods now **raise `PaymentError`** on business-level failures instead of returning a result with a non-success response code. Wrap calls in try/except to handle errors gracefully.
 
 ---
 
@@ -13,7 +15,7 @@ One async, type-safe interface across multiple processors — EasyPaisa, JazzCas
 | Gateway | Status |
 |---------|--------|
 | [EasyPaisa](https://easypaisa.com.pk) | ✅ Live |
-| [JazzCash](https://jazzcash.com.pk) | 🚧 Header utils ready |
+| [JazzCash](https://jazzcash.com.pk) | 🚧 In progress |
 | HBL | 📅 Planned |
 | ABL | 📅 Planned |
 | UBL | 📅 Planned |
@@ -158,6 +160,33 @@ result.paymentMode         # str ("MA", "OTC", "CC")
 
 ---
 
+## Error Handling
+
+All gateway methods raise typed exceptions on failure:
+
+```
+RaqmCoreError          # Base exception for the SDK
+├── NetworkError       # HTTP/transport errors (connection, timeout, 4xx/5xx)
+└── PaymentError       # Business-level failures (non-success response code)
+                      #   .response — the full gateway response object
+```
+
+```python
+from raqm_core.exceptions.exceptions import NetworkError, PaymentError
+
+try:
+    result = await ep.pay_via_ma(...)
+except NetworkError as e:
+    print(f"Network issue: {e}")
+except PaymentError as e:
+    print(f"Payment failed: {e}")
+    print(f"Response code: {e.response.responseCode}")
+```
+
+`PaymentError` carries the gateway's response object in `exc.response`, so you can inspect the raw error details even when the SDK raises.
+
+---
+
 ## Architecture
 
 Each payment gateway follows a consistent 3-layer structure:
@@ -175,15 +204,20 @@ Current structure:
 
 ```
 src/
-├── easypaisa.py              # EasyPaisa client
+├── easypaisa.py               # EasyPaisa client
+├── jazzcash.py                # JazzCash client
+├── exceptions/
+│   └── exceptions.py          # Custom exception hierarchy
 ├── headers/
-│   ├── easypaisa.py          # Basic Auth header
-│   └── jazzcash.py           # SHA-256 secure hash
+│   ├── easypaisa.py           # Basic Auth header
+│   └── jazzcash.py            # SHA-256 secure hash
 └── schemas/
-    └── easypaisa.py          # EasyPaisa Pydantic models
+    ├── easypaisa.py           # EasyPaisa Pydantic models
+    └── jazzcash.py            # JazzCash Pydantic models
 
 tests/
 ├── test_easypaisa.py         # EasyPaisa integration tests
+├── test_jazzcash.py          # JazzCash integration tests
 └── headers/
     ├── test_easypaisa.py     # Auth header unit tests
     └── test_jazzcash.py      # Secure hash unit tests
@@ -287,7 +321,7 @@ Add the new gateway to the **Supported Gateways** table with the appropriate sta
 - [ ] HBL payment gateway
 - [ ] ABL payment gateway
 - [ ] UBL payment gateway
-- [ ] Standardised error handling across gateways
+- [x] Standardised error handling across gateways
 - [ ] Request/response logging middleware
 - [ ] CI/CD + automated testing
 

{raqm_core-0.2.0 → raqm_core-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raqm-core"
-version = "0.2.0"
+version = "0.2.5"
 description = "Unified Python SDK for Pakistani payment gateways (EasyPaisa, JazzCash, HBL, ABL, UBL, etc.)"
 readme = "README.md"
 requires-python = ">=3.9"

{raqm_core-0.2.0 → raqm_core-0.2.5}/src/raqm_core/easypaisa.py

@@ -2,10 +2,12 @@ from typing import Optional
 
 import httpx
 
+from src.raqm_core.exceptions.exceptions import NetworkError, PaymentError
+
 from .headers.easypaisa import generate_auth_header
 from .schemas.easypaisa import (
+    EasyaisaMAResponse,
     EasyPaisaInquireTransactionResponse,
-    EasyPaisaMAResponse,
     EasyPaisaOTCResponse,
 )
 
@@ -32,13 +34,19 @@ class EasyPaisa:
         )
 
     async def _post(self, endpoint: str, payload: dict) -> dict:
-        header = generate_auth_header(self.username, self.password)
-        response = await self._client.post(
-            self.base_url + endpoint,
-            json=payload,
-            headers={"Authorization": header},
-        )
-        return response.json()
+        try:
+            header = generate_auth_header(self.username, self.password)
+            response = await self._client.post(
+                self.base_url + endpoint,
+                json=payload,
+                headers={"Authorization": header},
+            )
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            raise NetworkError(str(e)) from e
+        except httpx.RequestError as e:
+            raise NetworkError(str(e)) from e
 
     async def pay_via_otc(
         self, order_id: str, amount: str, email: str, msisdn: str, token_expiry: str
@@ -53,7 +61,13 @@ class EasyPaisa:
             "tokenExpiry": token_expiry,
         }
         data = await self._post("initiate-otc-transaction", request_payload)
-        return EasyPaisaOTCResponse(**data)
+        result = EasyPaisaOTCResponse(**data)
+
+        if result.responseCode != "0000":
+            raise PaymentError(
+                f"Payment failed: {result.responseCode}", response=result
+            )
+        return result
 
     async def pay_via_ma(
         self, order_id: str, amount: str, email: str, mobile_number: str
@@ -67,7 +81,13 @@ class EasyPaisa:
             "emailAddress": email,
         }
         data = await self._post("initiate-ma-transaction", request_payload)
-        return EasyPaisaMAResponse(**data)
+        result = EasyaisaMAResponse(**data)
+
+        if result.responseCode != "0000":
+            raise PaymentError(
+                f"Payment failed: {result.responseCode}", response=result
+            )
+        return result
 
     async def inquire_transaction_status(self, order_id: str, account_number: str):
         request_payload = {
@@ -76,4 +96,10 @@ class EasyPaisa:
             "accountNum": account_number,
         }
         data = await self._post("inquire-transaction", request_payload)
-        return EasyPaisaInquireTransactionResponse(**data)
+        result = EasyPaisaInquireTransactionResponse(**data)
+
+        if result.responseCode != "0000":
+            raise PaymentError(
+                f"Payment failed: {result.responseCode}", response=result
+            )
+        return result

raqm_core-0.2.5/src/raqm_core/exceptions/exceptions.py

@@ -0,0 +1,12 @@
+class RaqmCoreError(Exception):
+    pass
+
+
+class NetworkError(RaqmCoreError):
+    pass
+
+
+class PaymentError(RaqmCoreError):
+    def __init__(self, message: str, response=None):
+        self.response = response
+        super().__init__(message)

{raqm_core-0.2.0 → raqm_core-0.2.5}/src/raqm_core/headers/jazzcash.py

@@ -2,8 +2,9 @@ from hashlib import sha256
 
 
 def generate_secure_hash(hash_key: str, params: dict) -> str:
-    values = "&".join(param[1] for param in sorted(params.items()))
-    my_str = hash_key + "&" + values
+
+    values = "&".join(param[1] for param in sorted(params.items()) if param[1])
+    my_str = hash_key + ("&" + values if values else "")
 
     my_bytes = str.encode(my_str)
     my_sha256 = sha256(my_bytes)

raqm_core-0.2.5/src/raqm_core/jazzcash.py

@@ -0,0 +1,88 @@
+from datetime import datetime, timedelta
+from typing import Optional
+
+import httpx
+
+from src.raqm_core.exceptions.exceptions import NetworkError, PaymentError
+from src.raqm_core.headers.jazzcash import generate_secure_hash
+from src.raqm_core.schemas.jazzcash import JazzcashMWalletRequest, JazzcashResponse
+
+
+class JazzCash:
+    def __init__(
+        self,
+        merchant_id: str,
+        sub_merchant_id: str,
+        hash_key: str,
+        password: str,
+        sandbox: bool,
+        client: Optional[httpx.AsyncClient] = None,
+    ):
+        self.merchant_id = merchant_id
+        self.sub_merchant_id = sub_merchant_id
+        self.password = password
+        self.sandbox = sandbox
+        self._client = client or httpx.AsyncClient()
+        self.hash_key = hash_key
+        self.base_url = (
+            "https://sandbox.jazzcash.com.pk/ApplicationAPI/API/2.0/"
+            if self.sandbox
+            else "https://payments.jazzcash.com.pk/ApplicationAPI/API/2.0/"
+        )
+
+    async def _post(self, endpoint: str, payload: dict) -> dict:
+        try:
+            response = await self._client.post(
+                self.base_url + endpoint,
+                json=payload,
+            )
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            raise NetworkError(str(e)) from e
+        except httpx.RequestError as e:
+            raise NetworkError(str(e)) from e
+
+    async def pay_via_mwallet(
+        self,
+        mobile_number: str,
+        amount: str,
+        description: str,
+        bill_reference: str,
+        txn_ref_no: str,
+    ) -> (
+        JazzcashResponse
+    ):  # txn_ref_no — unique transaction ID, developer generates this
+        now = datetime.now()
+
+        pp_TxnDateTime = now.strftime("%Y%m%d%H%M%S")
+        pp_TxnExpiryDateTime = (now + timedelta(hours=1)).strftime("%Y%m%d%H%M%S")
+
+        request = JazzcashMWalletRequest(
+            pp_Language="EN",
+            pp_MerchantID=self.merchant_id,
+            pp_SubMerchantID=self.sub_merchant_id,
+            pp_Password=self.password,
+            pp_TxnRefNo=txn_ref_no,
+            pp_Amount=amount,
+            pp_TxnCurrency="PKR",
+            pp_TxnDateTime=pp_TxnDateTime,
+            pp_BillReference=bill_reference,
+            pp_Description=description,
+            pp_TxnExpiryDateTime=pp_TxnExpiryDateTime,
+            pp_MobileNumber=mobile_number,
+        )  # type: ignore
+
+        payload = request.model_dump()
+        secure_hash = generate_secure_hash(hash_key=self.hash_key, params=payload)
+
+        payload["pp_SecureHash"] = secure_hash
+        data = await self._post(endpoint="DoMWalletTransaction", payload=payload)
+
+        result = JazzcashResponse(**data)
+
+        if result.pp_ResponseCode != "000":
+            raise PaymentError(
+                f"Payment failed: {result.pp_ResponseCode}", response=result
+            )
+        return result

{raqm_core-0.2.0 → raqm_core-0.2.5}/src/raqm_core/schemas/easypaisa.py

@@ -19,7 +19,7 @@ class EasypaisaResponseCode(str, Enum):
     INVALID_EXPIRY = "0016"  # date should be future date
 
 
-class EasyPaisaResponse(BaseModel):
+class EasypaisaResponse(BaseModel):
     orderId: str = Field(
         ..., min_length=1, description="Merchant’s system generated Order ID"
     )
@@ -40,18 +40,18 @@ class EasyPaisaResponse(BaseModel):
     )
 
 
-class EasyPaisaMAResponse(EasyPaisaResponse):
+class EasyaisaMAResponse(EasypaisaResponse):
     transactionId: str = Field(..., description="Transaction ID of Ericsson (EWP ID)")
 
 
-class EasyPaisaOTCResponse(EasyPaisaResponse):
+class EasyPaisaOTCResponse(EasypaisaResponse):
     paymentToken: str = Field(..., min_length=1, description="Token generated by OTC")
     paymentTokenExpiryDateTime: str = Field(
         ..., description="Format = dd/MM/yyyy hh:mm [AM/PM]"
     )
 
 
-class EasyPaisaInquireTransactionResponse(EasyPaisaResponse):
+class EasyPaisaInquireTransactionResponse(EasypaisaResponse):
     accountNum: str = Field(
         ..., min_length=1, description="Merchant’s EWP Account Number"
     )

raqm_core-0.2.5/src/raqm_core/schemas/jazzcash.py

@@ -0,0 +1,93 @@
+from enum import Enum
+from typing import Optional, Union
+
+from pydantic import BaseModel, Field
+
+
+class JazzCashResponseCode(str, Enum):
+    SUCCESS = "000"
+    LIMIT_EXCEEDED = "001"
+    ACCOUNT_NOT_FOUND = "002"
+    ACCOUNT_INACTIVE = "003"
+    LOW_BALANCE = "004"
+    INVALID_HASH = "115"
+    SYSTEM_ERROR = "199"
+    TRANSACTION_TIMED_OUT = "403"
+    INSUFFICIENT_BALANCE = "405"
+
+
+# ── REQUEST MODELS ────────────────────────────────────────────────────────────
+
+
+class JazzcashRequest(BaseModel):
+    pp_Version: str = Field("1.1", description="Payment Portal Version.")
+    pp_Language: str = Field("EN", description="Display language. Fixed value 'EN'.")
+    pp_MerchantID: str = Field(
+        ..., description="Unique merchant ID assigned by JazzCash."
+    )
+    pp_SubMerchantID: str = Field(
+        "", description="Sub merchant ID, leave empty if unused."
+    )
+    pp_Password: str = Field(..., description="Password assigned by JazzCash.")
+    pp_BankID: str = Field("", description="Bank identifier, leave empty if unused.")
+    pp_ProductID: str = Field(
+        "", description="Product identifier, leave empty if unused."
+    )
+    pp_TxnRefNo: str = Field(..., description="Unique transaction reference number.")
+    pp_Amount: str = Field(..., description="Transaction amount, no decimal places.")
+    pp_TxnCurrency: str = Field(
+        "PKR", description="Transaction currency. Fixed value 'PKR'."
+    )
+    pp_TxnDateTime: str = Field(
+        ..., description="Transaction datetime. Format: yyyyMMddHHmmss."
+    )
+    pp_BillReference: str = Field(..., description="Bill/invoice number being settled.")
+    pp_Description: str = Field(..., description="Transaction description.")
+    pp_TxnExpiryDateTime: str = Field(
+        ..., description="Expiry datetime. Format: yyyyMMddHHmmss."
+    )
+    ppmpf_1: str = ""
+    ppmpf_2: str = ""
+    ppmpf_3: str = ""
+    ppmpf_4: str = ""
+    ppmpf_5: str = ""
+
+
+class JazzcashMWalletRequest(JazzcashRequest):
+    pp_TxnType: str = Field("MWALLET", description="Transaction type.")
+    pp_MobileNumber: str = Field(..., description="Customer's JazzCash mobile number.")
+
+
+# ── RESPONSE MODELS ───────────────────────────────────────────────────────────
+
+
+class JazzcashResponse(BaseModel):
+    pp_Amount: str = Field(..., description="Transaction amount.")
+    pp_AuthCode: Optional[str] = None
+    pp_BankID: Optional[str] = None
+    pp_BillReference: Optional[str] = None
+    pp_Language: Optional[str] = None
+    pp_MerchantID: str = Field(..., description="Merchant ID.")
+    pp_ResponseCode: Union[JazzCashResponseCode, str] = Field(
+        ..., description="Response code."
+    )
+    pp_ResponseMessage: str = Field(..., description="Response message.")
+    pp_RetreivalReferenceNo: Optional[str] = None
+    pp_SubMerchantId: Optional[str] = None
+    pp_TxnCurrency: Optional[str] = None
+    pp_TxnDateTime: Optional[str] = None
+    pp_TxnRefNo: str = Field(..., description="Transaction reference number.")
+    pp_SettlementExpiry: Optional[str] = None
+    pp_TxnType: Optional[str] = None
+    pp_Version: Optional[str] = None
+    ppmbf_1: Optional[str] = None
+    ppmbf_2: Optional[str] = None
+    ppmbf_3: Optional[str] = None
+    ppmbf_4: Optional[str] = None
+    ppmbf_5: Optional[str] = None
+    ppmpf_1: Optional[str] = None
+    ppmpf_2: Optional[str] = None
+    ppmpf_3: Optional[str] = None
+    ppmpf_4: Optional[str] = None
+    ppmpf_5: Optional[str] = None
+    pp_SecureHash: Optional[str] = None

{raqm_core-0.2.0 → raqm_core-0.2.5}/src/raqm_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: raqm-core
-Version: 0.2.0
+Version: 0.2.5
 Summary: Unified Python SDK for Pakistani payment gateways (EasyPaisa, JazzCash, HBL, ABL, UBL, etc.)
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -19,7 +19,9 @@ Requires-Dist: pydantic>=2.0
 
 One async, type-safe interface across multiple processors — EasyPaisa, JazzCash, HBL, ABL, UBL, and more.
 
-> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. Contributions welcome!
+> ⚠️ **Work in progress.** Currently only EasyPaisa is fully implemented. JazzCash is in progress. Contributions welcome!
+>
+> ⚠️ **Breaking change in v0.2.4** — methods now **raise `PaymentError`** on business-level failures instead of returning a result with a non-success response code. Wrap calls in try/except to handle errors gracefully.
 
 ---
 
@@ -28,7 +30,7 @@ One async, type-safe interface across multiple processors — EasyPaisa, JazzCas
 | Gateway | Status |
 |---------|--------|
 | [EasyPaisa](https://easypaisa.com.pk) | ✅ Live |
-| [JazzCash](https://jazzcash.com.pk) | 🚧 Header utils ready |
+| [JazzCash](https://jazzcash.com.pk) | 🚧 In progress |
 | HBL | 📅 Planned |
 | ABL | 📅 Planned |
 | UBL | 📅 Planned |
@@ -173,6 +175,33 @@ result.paymentMode         # str ("MA", "OTC", "CC")
 
 ---
 
+## Error Handling
+
+All gateway methods raise typed exceptions on failure:
+
+```
+RaqmCoreError          # Base exception for the SDK
+├── NetworkError       # HTTP/transport errors (connection, timeout, 4xx/5xx)
+└── PaymentError       # Business-level failures (non-success response code)
+                      #   .response — the full gateway response object
+```
+
+```python
+from raqm_core.exceptions.exceptions import NetworkError, PaymentError
+
+try:
+    result = await ep.pay_via_ma(...)
+except NetworkError as e:
+    print(f"Network issue: {e}")
+except PaymentError as e:
+    print(f"Payment failed: {e}")
+    print(f"Response code: {e.response.responseCode}")
+```
+
+`PaymentError` carries the gateway's response object in `exc.response`, so you can inspect the raw error details even when the SDK raises.
+
+---
+
 ## Architecture
 
 Each payment gateway follows a consistent 3-layer structure:
@@ -190,15 +219,20 @@ Current structure:
 
 ```
 src/
-├── easypaisa.py              # EasyPaisa client
+├── easypaisa.py               # EasyPaisa client
+├── jazzcash.py                # JazzCash client
+├── exceptions/
+│   └── exceptions.py          # Custom exception hierarchy
 ├── headers/
-│   ├── easypaisa.py          # Basic Auth header
-│   └── jazzcash.py           # SHA-256 secure hash
+│   ├── easypaisa.py           # Basic Auth header
+│   └── jazzcash.py            # SHA-256 secure hash
 └── schemas/
-    └── easypaisa.py          # EasyPaisa Pydantic models
+    ├── easypaisa.py           # EasyPaisa Pydantic models
+    └── jazzcash.py            # JazzCash Pydantic models
 
 tests/
 ├── test_easypaisa.py         # EasyPaisa integration tests
+├── test_jazzcash.py          # JazzCash integration tests
 └── headers/
     ├── test_easypaisa.py     # Auth header unit tests
     └── test_jazzcash.py      # Secure hash unit tests
@@ -302,7 +336,7 @@ Add the new gateway to the **Supported Gateways** table with the appropriate sta
 - [ ] HBL payment gateway
 - [ ] ABL payment gateway
 - [ ] UBL payment gateway
-- [ ] Standardised error handling across gateways
+- [x] Standardised error handling across gateways
 - [ ] Request/response logging middleware
 - [ ] CI/CD + automated testing
 

{raqm_core-0.2.0 → raqm_core-0.2.5}/src/raqm_core.egg-info/SOURCES.txt

@@ -2,14 +2,18 @@ README.md
 pyproject.toml
 src/raqm_core/__init__.py
 src/raqm_core/easypaisa.py
+src/raqm_core/jazzcash.py
 src/raqm_core.egg-info/PKG-INFO
 src/raqm_core.egg-info/SOURCES.txt
 src/raqm_core.egg-info/dependency_links.txt
 src/raqm_core.egg-info/requires.txt
 src/raqm_core.egg-info/top_level.txt
+src/raqm_core/exceptions/exceptions.py
 src/raqm_core/headers/__init__.py
 src/raqm_core/headers/easypaisa.py
 src/raqm_core/headers/jazzcash.py
 src/raqm_core/schemas/__init__.py
 src/raqm_core/schemas/easypaisa.py
-tests/test_easypaisa.py
+src/raqm_core/schemas/jazzcash.py
+tests/test_easypaisa.py
+tests/test_jazzcash.py

{raqm_core-0.2.0 → raqm_core-0.2.5}/tests/test_easypaisa.py

@@ -1,6 +1,7 @@
 import httpx
 import pytest
 
+from src.raqm_core.exceptions.exceptions import NetworkError, PaymentError
 from src.raqm_core.easypaisa import EasyPaisa
 
 MA_SUCCESS_BODY = {
@@ -40,9 +41,9 @@ INQUIRE_SUCCESS_BODY = {
 }
 
 
-def make_client(response_body: dict) -> httpx.AsyncClient:
+def make_client(response_body: dict, status_code: int = 200) -> httpx.AsyncClient:
     def handler(request: httpx.Request) -> httpx.Response:
-        return httpx.Response(status_code=200, json=response_body)
+        return httpx.Response(status_code=status_code, json=response_body)
 
     return httpx.AsyncClient(transport=httpx.MockTransport(handler))
 
@@ -83,13 +84,14 @@ class TestPayViaMA:
     async def test_error_codes(self, body, expected_code):
         payload = {**MA_SUCCESS_BODY, **body}
         ep = make_ep(payload)
-        result = await ep.pay_via_ma(
-            order_id="abc123",
-            amount="1.23",
-            email="test@example.com",
-            mobile_number="03458508726",
-        )
-        assert result.responseCode == expected_code
+        with pytest.raises(PaymentError) as exc_info:
+            await ep.pay_via_ma(
+                order_id="abc123",
+                amount="1.23",
+                email="test@example.com",
+                mobile_number="03458508726",
+            )
+        assert exc_info.value.response.responseCode == expected_code
 
 
 class TestPayViaOTC:
@@ -119,14 +121,15 @@ class TestPayViaOTC:
     async def test_error_codes(self, body, expected_code):
         payload = {**OTC_SUCCESS_BODY, **body}
         ep = make_ep(payload)
-        result = await ep.pay_via_otc(
-            order_id="abc123",
-            amount="1.23",
-            email="test@example.com",
-            msisdn="03458508726",
-            token_expiry="11/12/2018 11:30 PM",
-        )
-        assert result.responseCode == expected_code
+        with pytest.raises(PaymentError) as exc_info:
+            await ep.pay_via_otc(
+                order_id="abc123",
+                amount="1.23",
+                email="test@example.com",
+                msisdn="03458508726",
+                token_expiry="11/12/2018 11:30 PM",
+            )
+        assert exc_info.value.response.responseCode == expected_code
 
 
 class TestInquireTransaction:
@@ -156,7 +159,26 @@ class TestInquireTransaction:
     async def test_error_codes(self, body, expected_code):
         payload = {**INQUIRE_SUCCESS_BODY, **body}
         ep = make_ep(payload)
-        result = await ep.inquire_transaction_status(
-            order_id="abc123", account_number="123456789"
+        with pytest.raises(PaymentError) as exc_info:
+            await ep.inquire_transaction_status(
+                order_id="abc123", account_number="123456789"
+            )
+        assert exc_info.value.response.responseCode == expected_code
+
+
+@pytest.mark.asyncio
+async def test_network_error():
+    ep = EasyPaisa(
+        store_id="43",
+        username="admin",
+        password="123",
+        sandbox=True,
+        client=make_client({"error": "Internal Server Error"}, status_code=500),
+    )
+    with pytest.raises(NetworkError):
+        await ep.pay_via_ma(
+            order_id="abc123",
+            amount="1.23",
+            email="test@example.com",
+            mobile_number="03458508726",
         )
-        assert result.responseCode == expected_code

raqm_core-0.2.5/tests/test_jazzcash.py

@@ -0,0 +1,105 @@
+import httpx
+import pytest
+
+from src.raqm_core.exceptions.exceptions import NetworkError, PaymentError
+from src.raqm_core.jazzcash import JazzCash
+
+MWALLET_SUCCESS_BODY = {
+    "pp_Amount": "1000",
+    "pp_AuthCode": "123456",
+    "pp_BankID": "",
+    "pp_BillReference": "bill123",
+    "pp_Language": "EN",
+    "pp_MerchantID": "MERCH123",
+    "pp_ResponseCode": "000",
+    "pp_ResponseMessage": "Success",
+    "pp_RetreivalReferenceNo": "RET123",
+    "pp_SubMerchantId": "SUBMERCH123",
+    "pp_TxnCurrency": "PKR",
+    "pp_TxnDateTime": "20260101120000",
+    "pp_TxnRefNo": "TXN123456",
+    "pp_SettlementExpiry": "20260101130000",
+    "pp_TxnType": "MWALLET",
+    "pp_Version": "1.1",
+    "pp_SecureHash": "abc123hash",
+}
+
+
+def make_client(response_body: dict, status_code: int = 200) -> httpx.AsyncClient:
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(status_code=status_code, json=response_body)
+
+    return httpx.AsyncClient(transport=httpx.MockTransport(handler))
+
+
+def make_jc(response_body: dict) -> JazzCash:
+    return JazzCash(
+        merchant_id="MERCH123",
+        sub_merchant_id="SUBMERCH123",
+        hash_key="test_hash_key",
+        password="test_password",
+        sandbox=True,
+        client=make_client(response_body),
+    )
+
+
+class TestPayViaMWallet:
+    @pytest.mark.asyncio
+    async def test_success(self):
+        jc = make_jc(MWALLET_SUCCESS_BODY)
+        result = await jc.pay_via_mwallet(
+            mobile_number="03001234567",
+            amount="1000",
+            description="Test payment",
+            bill_reference="bill123",
+            txn_ref_no="TXN123456",
+        )
+        assert result.pp_ResponseCode == "000"
+        assert result.pp_ResponseMessage == "Success"
+        assert result.pp_TxnRefNo == "TXN123456"
+        assert result.pp_Amount == "1000"
+        assert result.pp_MerchantID == "MERCH123"
+
+    @pytest.mark.parametrize(
+        ("body", "expected_code"),
+        [
+            ({"pp_ResponseCode": "001", "pp_ResponseMessage": "LIMIT EXCEEDED"}, "001"),
+            ({"pp_ResponseCode": "002", "pp_ResponseMessage": "ACCOUNT NOT FOUND"}, "002"),
+            ({"pp_ResponseCode": "115", "pp_ResponseMessage": "INVALID HASH"}, "115"),
+            ({"pp_ResponseCode": "199", "pp_ResponseMessage": "SYSTEM ERROR"}, "199"),
+            ({"pp_ResponseCode": "403", "pp_ResponseMessage": "TRANSACTION TIMED OUT"}, "403"),
+            ({"pp_ResponseCode": "405", "pp_ResponseMessage": "INSUFFICIENT BALANCE"}, "405"),
+        ],
+    )
+    @pytest.mark.asyncio
+    async def test_error_codes(self, body, expected_code):
+        payload = {**MWALLET_SUCCESS_BODY, **body}
+        jc = make_jc(payload)
+        with pytest.raises(PaymentError) as exc_info:
+            await jc.pay_via_mwallet(
+                mobile_number="03001234567",
+                amount="1000",
+                description="Test payment",
+                bill_reference="bill123",
+                txn_ref_no="TXN123456",
+            )
+        assert exc_info.value.response.pp_ResponseCode == expected_code
+
+    @pytest.mark.asyncio
+    async def test_network_error(self):
+        jc = JazzCash(
+            merchant_id="MERCH123",
+            sub_merchant_id="SUBMERCH123",
+            hash_key="test_hash_key",
+            password="test_password",
+            sandbox=True,
+            client=make_client({"error": "Internal Server Error"}, status_code=500),
+        )
+        with pytest.raises(NetworkError):
+            await jc.pay_via_mwallet(
+                mobile_number="03001234567",
+                amount="1000",
+                description="Test payment",
+                bill_reference="bill123",
+                txn_ref_no="TXN123456",
+            )