[PAY-7260] add support for disputes endpoints

fintoc/core.py

@@ -8,6 +8,7 @@
     AccountsManager,
     ChargesManager,
     CheckoutSessionsManager,
+    DisputesManager,
     InvoicesManager,
     LinksManager,
     PaymentIntentsManager,
@@ -68,6 +69,7 @@ def __init__(self, api_key, api_version=None, jws_private_key=None):
         )
         self.tax_returns = TaxReturnsManager("/v1/tax_returns", self._client)
         self.invoices = InvoicesManager("/v1/invoices", self._client)
+        self.disputes = DisputesManager("/v1/disputes", self._client)
 
         self.v2 = _FintocV2(self._client)
 

fintoc/managers/__init__.py

@@ -3,6 +3,8 @@
 from .accounts_manager import AccountsManager
 from .charges_manager import ChargesManager
 from .checkout_sessions_manager import CheckoutSessionsManager
+from .dispute_documents_manager import DisputeDocumentsManager
+from .disputes_manager import DisputesManager
 from .invoices_manager import InvoicesManager
 from .links_manager import LinksManager
 from .movements_manager import MovementsManager

fintoc/managers/dispute_documents_manager.py

@@ -0,0 +1,10 @@
+"""Module to hold the dispute documents manager."""
+
+from fintoc.mixins import ManagerMixin
+
+
+class DisputeDocumentsManager(ManagerMixin):
+    """Represents a dispute documents manager."""
+
+    resource = "dispute_document"
+    methods = ["create"]

fintoc/managers/disputes_manager.py

@@ -0,0 +1,35 @@
+"""Module to hold the disputes manager."""
+
+from fintoc.managers.dispute_documents_manager import DisputeDocumentsManager
+from fintoc.mixins import ManagerMixin
+
+
+# pylint: disable=duplicate-code
+class DisputesManager(ManagerMixin):
+    """Represents a disputes manager."""
+
+    resource = "dispute"
+    methods = ["list", "get", "submit_for_review"]
+
+    def __init__(self, path, client):
+        super().__init__(path, client)
+        self.__documents_manager = None
+
+    def _submit_for_review(self, identifier, **kwargs):
+        """Submit a dispute for review."""
+        path = f"{self._build_path(**kwargs)}/{identifier}/submit_for_review"
+        return self._create(path_=path, **kwargs)
+
+    @property
+    def documents(self):
+        """Proxies the dispute documents manager."""
+        if self.__documents_manager is None:
+            self.__documents_manager = DisputeDocumentsManager(
+                "/v1/disputes/{dispute_id}/documents",
+                self._client,
+            )
+        return self.__documents_manager
+
+    @documents.setter
+    def documents(self, new_value):  # pylint: disable=no-self-use
+        raise NameError("Attribute name corresponds to a manager")

fintoc/resources/__init__.py

@@ -4,6 +4,8 @@
 from .balance import Balance
 from .charge import Charge
 from .checkout_session import CheckoutSession
+from .dispute import Dispute
+from .dispute_document import DisputeDocument
 from .generic_fintoc_resource import GenericFintocResource
 from .income import Income
 from .institution import Institution

fintoc/resources/dispute.py

@@ -0,0 +1,11 @@
+"""Module to hold the Dispute resource."""
+
+from fintoc.mixins import ResourceMixin
+
+
+class Dispute(ResourceMixin):
+    """Represents a Fintoc Dispute."""
+
+    mappings = {
+        "documents": "dispute_document",
+    }

fintoc/resources/dispute_document.py

@@ -0,0 +1,7 @@
+"""Module to hold the DisputeDocument resource."""
+
+from fintoc.mixins import ResourceMixin
+
+
+class DisputeDocument(ResourceMixin):
+    """Represents a Fintoc Dispute Document."""

tests/test_integration.py

@@ -882,6 +882,42 @@ def test_checkout_session_expire(self):
         assert result.method == "post"
         assert result.url == f"v1/checkout_sessions/{checkout_session_id}/expire"
 
+    def test_disputes_list(self):
+        """Test getting all disputes."""
+        disputes = list(self.fintoc.disputes.list())
+
+        assert len(disputes) > 0
+        for dispute in disputes:
+            assert dispute.method == "get"
+            assert dispute.url == "v1/disputes"
+
+    def test_dispute_get(self):
+        """Test getting a specific dispute."""
+        dispute_id = "test_dispute_id"
+
+        dispute = self.fintoc.disputes.get(dispute_id)
+
+        assert dispute.method == "get"
+        assert dispute.url == f"v1/disputes/{dispute_id}"
+
+    def test_dispute_submit_for_review(self):
+        """Test submitting a dispute for review."""
+        dispute_id = "test_dispute_id"
+
+        result = self.fintoc.disputes.submit_for_review(dispute_id)
+
+        assert result.method == "post"
+        assert result.url == f"v1/disputes/{dispute_id}/submit_for_review"
+
+    def test_dispute_document_create(self):
+        """Test creating a document for a dispute."""
+        dispute_id = "test_dispute_id"
+
+        document = self.fintoc.disputes.documents.create(dispute_id=dispute_id)
+
+        assert document.method == "post"
+        assert document.url == f"v1/disputes/{dispute_id}/documents"
+
     def test_v2_transfer_return(self):
         """Test returning a transfer using v2 API."""
         transfer_id = "test_transfer_id"