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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.14b0
+Version: 3.0.15
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -147,3 +147,31 @@ 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")
+
+form_fields = {
+    "driver_id": 12345,
+    "amount": 1000
+}
+
+fallback_link = payme.initializer.generate_fallback_link(form_fields) # form field is optional
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=5feb5dd783c40aed047fe655&driver_id=12345&amount=1000
+```

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

@@ -133,3 +133,31 @@ 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")
+
+form_fields = {
+    "driver_id": 12345,
+    "amount": 1000
+}
+
+fallback_link = payme.initializer.generate_fallback_link(form_fields) # form field is optional
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=5feb5dd783c40aed047fe655&driver_id=12345&amount=1000
+```

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

@@ -55,3 +55,26 @@ class Initializer:
         )
         params = base64.b64encode(params.encode("utf-8")).decode("utf-8")
         return f"https://checkout.paycom.uz/{params}"
+
+    def generate_fallback_link(self, form_fields: dict = None):
+        """
+        Generate a fallback URL for the Payme checkout.
+
+        Parameters
+        ----------
+        fields : dict, optional
+            Additional query parameters to be appended to the fallback URL.
+
+        Returns
+        -------
+        str
+            A fallback URL formatted as a URL, ready to be used in the payment
+            process.
+        """
+        result = f"https://payme.uz/fallback/merchant/?id={self.payme_id}"
+
+        if form_fields is not None:
+            for key, value in form_fields.items():
+                result += f"&{key}={value}"
+
+        return result

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

@@ -146,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."
@@ -254,6 +262,7 @@ errors_map = {
     -31301: SmsNotConnectedError,
     -31302: BalanceError,
     -31303: InsufficientFundsError,
+    -31630: InsufficientFundsErrorV2,
     -31300: InvalidCardNumberError,
     -31002: ProcessingServerError,
     -31110: OtpSendError,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.14b0
+Version: 3.0.15
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -147,3 +147,31 @@ 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")
+
+form_fields = {
+    "driver_id": 12345,
+    "amount": 1000
+}
+
+fallback_link = payme.initializer.generate_fallback_link(form_fields) # form field is optional
+print(fallback_link)
+```
+
+- Output
+
+```
+https://payme.uz/fallback/merchant/?id=5feb5dd783c40aed047fe655&driver_id=12345&amount=1000
+```

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

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