payme-pkg 3.0.13b0__tar.gz → 3.0.14__tar.gz

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.13b0
+Version: 3.0.14
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -36,7 +36,7 @@ Requires-Dist: djangorestframework==3.*
 </a>
 
 <p align="center">
-  <a href="https://youtu.be/xxiIggu_RNk?si=Idpg8omFvFDCYtcm" target="_blank">Watch the YouTube Demo</a>
+  <a href="https://youtu.be/7q7-c72tHpc?si=Sr0EAmEawWAFRk1m" target="_blank">Watch the YouTube Demo</a>
 </p>
 
 ## Installation
@@ -147,3 +147,25 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id")
+fallback_link = payme.initializer.generate_fallback_link()
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=59f9ca12dsadaa1717
+```

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/README.md

@@ -22,7 +22,7 @@
 </a>
 
 <p align="center">
-  <a href="https://youtu.be/xxiIggu_RNk?si=Idpg8omFvFDCYtcm" target="_blank">Watch the YouTube Demo</a>
+  <a href="https://youtu.be/7q7-c72tHpc?si=Sr0EAmEawWAFRk1m" target="_blank">Watch the YouTube Demo</a>
 </p>
 
 ## Installation
@@ -133,3 +133,25 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id")
+fallback_link = payme.initializer.generate_fallback_link()
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=59f9ca12dsadaa1717
+```

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/payme/classes/initializer.py

@@ -55,3 +55,15 @@ class Initializer:
         )
         params = base64.b64encode(params.encode("utf-8")).decode("utf-8")
         return f"https://checkout.paycom.uz/{params}"
+
+    def generate_fallback_link(self):
+        """
+        Generate a fallback URL for the Payme checkout.
+
+        Returns
+        -------
+        str
+            A fallback URL formatted as a URL, ready to be used in the payment
+            process.
+        """
+        return f"https://payme.uz/fallback/merchant/?id={self.payme_id}"

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/payme/exceptions/general.py

@@ -2,51 +2,16 @@ import logging
 
 
 class BaseError(Exception):
-    """
-    Base class for all errors in the payment system.
-
-    Attributes:
-        code (str or int): Error code identifying the type of error.
-        message (str): A human-readable error message.
-        data (dict, optional): Additional context or metadata for the error.
-    """
+    """Base class for all errors in the payment system."""
     logger = logging.getLogger(__name__)
 
-    def __init__(self, code=None, message=None, data=None, *args, **kwargs):
-        """
-        Initialize the BaseError instance.
-
-        Args:
-            code (str or int, optional): Error code identifying the error type.
-            message (str, optional): Human-readable error description.
-            data (dict, optional): Additional context or metadata.
-            *args: Additional positional arguments for exception context.
-            **kwargs: Additional keyword arguments for exception context.
-        """
-        # Use default values if none provided
-        code = code or "UNKNOWN_ERROR"
-        message = message or "An unspecified error occurred."
-
+    def __init__(self, code, message, data=None):
         super().__init__(message)
-
         self.code = code
         self.data = data
-        self.args = args
-        self.kwargs = kwargs
-
-        # Structured logging for better insights
-        self.logger.error(
-            f"[{self.__class__.__name__}] Code: {code}, Message: {message}, "
-            f"Data: {data}, Args: {args}, Kwargs: {kwargs}",
-            exc_info=True
-        )
 
-    def __repr__(self):
-        """Provide a developer-friendly string representation."""
-        return (
-            f"<{self.__class__.__name__} code={self.code!r} message={self.message!r} "
-            f"data={self.data!r}>"
-        )
+        # pylint: disable=W1203
+        self.logger.error(f"Error {code}: {message}. Data: {data}")
 
 
 class CardError(BaseError):
@@ -181,6 +146,14 @@ class InsufficientFundsError(CardError):
         super().__init__(-31303, self.message, data)
 
 
+class InsufficientFundsErrorV2(CardError):
+    """Insufficient funds on the card."""
+    message = "Insufficient funds on the card."
+
+    def __init__(self, data=None):
+        super().__init__(-31630, self.message, data)
+
+
 class InvalidCardNumberError(CardError):
     """Invalid card number provided."""
     message = "Invalid card number."
@@ -278,12 +251,6 @@ class UnknownPartnerError(BaseException):
         super().__init__(message, data)
 
 
-class UnknownError(BaseException):
-    """An unknown error occurred."""
-    def __init__(self, message="An unknown error occurred.", data=None):
-        super().__init__(message, data)
-
-
 errors_map = {
     -32300: TransportError,
     -32700: ParseError,
@@ -295,6 +262,7 @@ errors_map = {
     -31301: SmsNotConnectedError,
     -31302: BalanceError,
     -31303: InsufficientFundsError,
+    -31630: InsufficientFundsErrorV2,
     -31300: InvalidCardNumberError,
     -31002: ProcessingServerError,
     -31110: OtpSendError,
@@ -304,5 +272,4 @@ errors_map = {
     -31602: ReceiptsNotFoundError,
     -32500: InvalidTokenFormat,
     -31601: UnknownPartnerError,
-    "UNKNOWN_ERROR": UnknownError
 }

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/payme/types/response/receipts.py

@@ -123,7 +123,6 @@ class Receipt(Common):
     type: int
     external: bool
     operation: int
-    category: any = None
     error: any = None
     description: str = None
     detail: Detail = None

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/payme_pkg.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.13b0
+Version: 3.0.14
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -36,7 +36,7 @@ Requires-Dist: djangorestframework==3.*
 </a>
 
 <p align="center">
-  <a href="https://youtu.be/xxiIggu_RNk?si=Idpg8omFvFDCYtcm" target="_blank">Watch the YouTube Demo</a>
+  <a href="https://youtu.be/7q7-c72tHpc?si=Sr0EAmEawWAFRk1m" target="_blank">Watch the YouTube Demo</a>
 </p>
 
 ## Installation
@@ -147,3 +147,25 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id")
+fallback_link = payme.initializer.generate_fallback_link()
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=59f9ca12dsadaa1717
+```

{payme_pkg-3.0.13b0 → payme_pkg-3.0.14}/setup.py

@@ -7,7 +7,7 @@ long_description = (here / "README.md").read_text(encoding="utf-8")
 
 setup(
     name='payme-pkg',
-    version='3.0.13b',
+    version='3.0.14',
     license='MIT',
     author="Muhammadali Akbarov",
     author_email='muhammadali17abc@gmail.com',