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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.14b0
+Version: 3.0.16
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -147,3 +147,32 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+The ID in the fallback is different from the merchant ID. You can get the ID from the Payme team.
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id", fallback_id="your-fallback-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=examplelinkgenerated&driver_id=12345&amount=1000
+```

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

@@ -133,3 +133,32 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+The ID in the fallback is different from the merchant ID. You can get the ID from the Payme team.
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id", fallback_id="your-fallback-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=examplelinkgenerated&driver_id=12345&amount=1000
+```

{payme_pkg-3.0.14b0 → payme_pkg-3.0.16}/payme/classes/client.py

@@ -14,6 +14,7 @@ class Payme:
     def __init__(
         self,
         payme_id: str,
+        fallback_id: Union[str, None] = None,
         payme_key: Union[str, None] = None,
         is_test_mode: bool = False
     ):
@@ -25,5 +26,5 @@ class Payme:
             url = Networks.TEST_NET.value
 
         self.cards = Cards(url=url, payme_id=payme_id)
-        self.initializer = Initializer(payme_id=payme_id)
+        self.initializer = Initializer(payme_id=payme_id, fallback_id=fallback_id)
         self.receipts = Receipts(url=url, payme_id=payme_id, payme_key=payme_key)  # noqa

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

@@ -13,8 +13,10 @@ class Initializer:
         The Payme ID associated with your account
     """
 
-    def __init__(self, payme_id: str = None):
+    def __init__(self, payme_id: str = None, fallback_id: str = None):
         self.payme_id = payme_id
+        self.fallback_id = fallback_id
+
 
     def generate_pay_link(
         self,
@@ -55,3 +57,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.fallback_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.16}/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.16}/payme_pkg.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: payme-pkg
-Version: 3.0.14b0
+Version: 3.0.16
 Home-page: https://github.com/Muhammadali-Akbarov/payme-pkg
 Author: Muhammadali Akbarov
 Author-email: muhammadali17abc@gmail.com
@@ -147,3 +147,32 @@ print(pay_link)
 ```
 https://checkout.paycom.uz/bT15b3VyLXBheW1lLWlkO2FjLmlkPTEyMzQ1NjthPTUwMDAwMDtjPWh0dHBzOi8vZXhhbXBsZS5jb20=
 ```
+
+
+## Generate Fallback Link
+
+
+Example to generate fallback link:
+
+- Input
+
+The ID in the fallback is different from the merchant ID. You can get the ID from the Payme team.
+```python
+from payme import Payme
+
+payme = Payme(payme_id="your-payme-id", fallback_id="your-fallback-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=examplelinkgenerated&driver_id=12345&amount=1000
+```

{payme_pkg-3.0.14b0 → payme_pkg-3.0.16}/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.16',
     license='MIT',
     author="Muhammadali Akbarov",
     author_email='muhammadali17abc@gmail.com',