delfinance-python-sdk 0.0.4__tar.gz → 0.0.6__tar.gz

delfinance_python_sdk-0.0.6/Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.7-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# Iniciar com debugpy ouvindo na porta 5678 e aguardando conexão
+CMD ["python", "-m", "debugpy", "--listen", "0.0.0.0:5678", "--wait-for-client", "main.py"]

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/Jenkinsfile

@@ -24,7 +24,7 @@ pipeline {
             }
             agent {
                 docker {
-                    image 'python:3.12-slim'
+                    image 'python:3.7-slim'
                     args '--entrypoint="" -u root'
                 }
             }

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delfinance-python-sdk
-Version: 0.0.4
+Version: 0.0.6
 Summary: SDK oficial da Delfinance para Python
 Home-page: https://github.com/delfinance/python-sdk
 Author: Delfinance Team
@@ -124,3 +124,15 @@ Para testes e desenvolvimento local:
 docker-compose up --build
 ```
 Isso iniciará uma aplicação Flask simples que executa um teste de integração e exibe o resultado em `http://localhost:8080`.
+
+## 8. Depuração
+
+O ambiente Docker está configurado para suportar depuração remota via `debugpy` na porta **5678**.
+
+### Usando VS Code
+
+1.  Inicie o ambiente com `docker-compose up --build`.
+2.  No VS Code, abra a aba "Run and Debug" (Ctrl+Shift+D).
+3.  Selecione a configuração **"Docker: Remote Attach"**.
+4.  Pressione **F5** para conectar o depurador ao container.
+5.  Defina breakpoints no código e acesse `http://localhost:8080` para disparar a execução.

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/README.md

@@ -97,3 +97,15 @@ Para testes e desenvolvimento local:
 docker-compose up --build
 ```
 Isso iniciará uma aplicação Flask simples que executa um teste de integração e exibe o resultado em `http://localhost:8080`.
+
+## 8. Depuração
+
+O ambiente Docker está configurado para suportar depuração remota via `debugpy` na porta **5678**.
+
+### Usando VS Code
+
+1.  Inicie o ambiente com `docker-compose up --build`.
+2.  No VS Code, abra a aba "Run and Debug" (Ctrl+Shift+D).
+3.  Selecione a configuração **"Docker: Remote Attach"**.
+4.  Pressione **F5** para conectar o depurador ao container.
+5.  Defina breakpoints no código e acesse `http://localhost:8080` para disparar a execução.

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/docker-compose.yml

@@ -8,5 +8,6 @@ services:
       - .:/app
     ports:
       - "8080:80"
+      - "5678:5678"
     tty: true
     stdin_open: true

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/requirements.txt

@@ -1,4 +1,5 @@
 requests==2.31.0
 python-dotenv==0.21.1
 flask==2.2.5
-setuptools_scm==9.2.2
+debugpy==1.7.0
+setuptools_scm==7.1.0

delfinance_python_sdk-0.0.6/src/delfinance/transfers/interfaces/ipix_service.py

@@ -0,0 +1,25 @@
+from abc import ABC, abstractmethod
+
+class IPixService(ABC):
+    """
+    Interface IPixService
+    """
+    @abstractmethod
+    def payment_initialization(self, request):
+        """
+        Initializes a Pix payment using a DICT key.
+        
+        :param request: PaymentInitializationRequest
+        :return: PaymentInitializationResponse
+        """
+        pass
+
+    @abstractmethod
+    def decode_qr_code(self, request):
+        """
+        Initializes a Pix payment using a QR Code payload.
+        
+        :param request: DecodeQrCodeRequest
+        :return: DecodeQrCodeResponse
+        """
+        pass

delfinance_python_sdk-0.0.6/src/delfinance/transfers/requests/decode_qr_code_request.py

@@ -0,0 +1,10 @@
+class DecodeQrCodeRequest:
+    """
+    Request payload for initializing a Pix payment via QR Code.
+    """
+    def __init__(self, payload: str):
+        """
+        DecodeQrCodeRequest constructor.
+        :param payload: The raw QR Code string
+        """
+        self.payload = payload

delfinance_python_sdk-0.0.6/src/delfinance/transfers/requests/payment_initialization_request.py

@@ -0,0 +1,12 @@
+class PaymentInitializationRequest:
+    """
+    Request payload for initializing a Pix payment.
+    """
+    def __init__(self, key: str, holder_document: str = None):
+        """
+        PaymentInitializationRequest constructor.
+        :param key: The DICT key
+        :param holder_document: (Optional) The document of the key holder
+        """
+        self.key = key
+        self.holder_document = holder_document

delfinance_python_sdk-0.0.6/src/delfinance/transfers/responses/decode_qr_code_response.py

@@ -0,0 +1,55 @@
+class DecodeQrCodeResponse:
+    """
+    Response object for QR Code decoding.
+    """
+    def __init__(self, data: dict = None):
+        self.key = None
+        self.end_to_end_id = None
+        self.transaction_id = None
+        self.expiration_time = None
+        self.revision = None
+        self.allow_change_amount = None
+        self.category_code = None
+        self.created_at = None
+        self.captured_at = None
+        self.type = None
+        self.status = None
+        self.amount = None
+        self.original_amount = None
+        self.fine_amount = None
+        self.fees_amount = None
+        self.discount_amount = None
+        self.rebate_amount = None
+        self.due_date = None
+        self.payment_deadline = None
+        self.payer = None
+        self.bank_account_recipient = None
+        self.beneficiary = None
+        self.additional_infos = None
+        self.recurrence = None
+
+        if data:
+            self.key = data.get('key')
+            self.end_to_end_id = data.get('endToEndId')
+            self.transaction_id = data.get('transactionId')
+            self.expiration_time = data.get('expirationTime')
+            self.revision = data.get('revision')
+            self.allow_change_amount = data.get('allowChangeAmount')
+            self.category_code = data.get('categoryCode')
+            self.created_at = data.get('createdAt')
+            self.captured_at = data.get('capturedAt')
+            self.type = data.get('type')
+            self.status = data.get('status')
+            self.amount = data.get('amount')
+            self.original_amount = data.get('originalAmount')
+            self.fine_amount = data.get('fineAmount')
+            self.fees_amount = data.get('feesAmount')
+            self.discount_amount = data.get('discountAmount')
+            self.rebate_amount = data.get('rebateAmount')
+            self.due_date = data.get('dueDate')
+            self.payment_deadline = data.get('paymentDeadline')
+            self.payer = data.get('payer')
+            self.bank_account_recipient = data.get('bankAccountRecipient')
+            self.beneficiary = data.get('beneficiary')
+            self.additional_infos = data.get('additionalInfos')
+            self.recurrence = data.get('recurrence')

delfinance_python_sdk-0.0.4/src/delfinance/transfers/dto/transfer_dto.py → delfinance_python_sdk-0.0.6/src/delfinance/transfers/responses/get_transfer_response.py

@@ -1,6 +1,7 @@
-class TransferDto:
+class GetTransferResponse:
     """
-    Represents the data of a transfer.
+    Response object for Get Transfer operation.
+    Represents the data of a transfer directly.
     """
     def __init__(self, data: dict = None):
         self.id = None

delfinance_python_sdk-0.0.6/src/delfinance/transfers/responses/payment_initialization_response.py

@@ -0,0 +1,15 @@
+class PaymentInitializationResponse:
+    """
+    Response object for Pix payment initialization.
+    """
+    def __init__(self, data: dict = None):
+        self.end_to_end_id = None
+        self.key = None
+        self.beneficiary = None
+        self.key_belongs_holder = None
+
+        if data:
+            self.end_to_end_id = data.get('endToEndId')
+            self.key = data.get('key')
+            self.beneficiary = data.get('beneficiary')
+            self.key_belongs_holder = data.get('keyBelongsHolder')

delfinance_python_sdk-0.0.6/src/delfinance/transfers/services/pix_service.py

@@ -0,0 +1,98 @@
+import requests
+import json
+from ...abstractions.startup.delfinance_client import DelfinanceClient
+from ..interfaces.ipix_service import IPixService
+from ..requests.payment_initialization_request import PaymentInitializationRequest
+from ..requests.decode_qr_code_request import DecodeQrCodeRequest
+from ..responses.payment_initialization_response import PaymentInitializationResponse
+from ..responses.decode_qr_code_response import DecodeQrCodeResponse
+
+class PixService(IPixService):
+    """
+    Class PixService
+    """
+    def __init__(self, client: DelfinanceClient):
+        self.client = client
+
+    def payment_initialization(self, request: PaymentInitializationRequest) -> PaymentInitializationResponse:
+        """
+        Initializes a Pix payment using a DICT key.
+        """
+        url = f"{self.client.get_base_url()}/baas/api/v2/pix/dict/payment-initialization"
+        
+        payload = {
+            'key': request.key
+        }
+
+        if request.holder_document:
+            payload['holderDocument'] = request.holder_document
+
+        headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'x-delbank-api-key': self.client.get_api_key(),
+            'x-delfinance-account-id': self.client.get_account_id(),
+        }
+
+        # Setup mTLS if configured
+        cert = None
+        if self.client.get_certificate_path() and self.client.get_private_key_path():
+            cert = (self.client.get_certificate_path(), self.client.get_private_key_path())
+
+        try:
+            response = requests.post(
+                url, 
+                json=payload,
+                headers=headers, 
+                cert=cert,
+                timeout=30
+            )
+            
+            if response.status_code >= 400:
+                raise Exception(f"API Error: {response.text}", response.status_code)
+            
+            data = response.json()
+            return PaymentInitializationResponse(data)
+            
+        except requests.exceptions.RequestException as e:
+            raise Exception(f"Request Error: {str(e)}")
+
+    def decode_qr_code(self, request: DecodeQrCodeRequest) -> DecodeQrCodeResponse:
+        """
+        Initializes a Pix payment using a QR Code payload (decoding the QrCode).
+        """
+        url = f"{self.client.get_base_url()}/baas/api/v2/pix/qrcode/payment-initialization"
+        
+        payload = {
+            'payload': request.payload
+        }
+
+        headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'x-delbank-api-key': self.client.get_api_key(),
+            'x-delfinance-account-id': self.client.get_account_id(),
+        }
+
+        # Setup mTLS if configured
+        cert = None
+        if self.client.get_certificate_path() and self.client.get_private_key_path():
+            cert = (self.client.get_certificate_path(), self.client.get_private_key_path())
+
+        try:
+            response = requests.post(
+                url, 
+                json=payload,
+                headers=headers, 
+                cert=cert,
+                timeout=30
+            )
+            
+            if response.status_code >= 400:
+                raise Exception(f"API Error: {response.text}", response.status_code)
+            
+            data = response.json()
+            return DecodeQrCodeResponse(data)
+            
+        except requests.exceptions.RequestException as e:
+            raise Exception(f"Request Error: {str(e)}")

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/src/delfinance/transfers/services/transfers_service.py

@@ -2,7 +2,6 @@ import requests
 import json
 from ...abstractions.startup.delfinance_client import DelfinanceClient
 from ..interfaces.itransfers_service import ITransfersService
-from ..dto.transfer_dto import TransferDto
 from ..responses.get_transfer_response import GetTransferResponse
 
 class TransfersService(ITransfersService):
@@ -36,8 +35,7 @@ class TransfersService(ITransfersService):
                 raise Exception(f"API Error: {response.text}", response.status_code)
             
             data = response.json()
-            dto = TransferDto(data)
-            return GetTransferResponse(dto)
+            return GetTransferResponse(data)
             
         except requests.exceptions.RequestException as e:
             raise Exception(f"Request Error: {str(e)}")

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/src/delfinance_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delfinance-python-sdk
-Version: 0.0.4
+Version: 0.0.6
 Summary: SDK oficial da Delfinance para Python
 Home-page: https://github.com/delfinance/python-sdk
 Author: Delfinance Team
@@ -124,3 +124,15 @@ Para testes e desenvolvimento local:
 docker-compose up --build
 ```
 Isso iniciará uma aplicação Flask simples que executa um teste de integração e exibe o resultado em `http://localhost:8080`.
+
+## 8. Depuração
+
+O ambiente Docker está configurado para suportar depuração remota via `debugpy` na porta **5678**.
+
+### Usando VS Code
+
+1.  Inicie o ambiente com `docker-compose up --build`.
+2.  No VS Code, abra a aba "Run and Debug" (Ctrl+Shift+D).
+3.  Selecione a configuração **"Docker: Remote Attach"**.
+4.  Pressione **F5** para conectar o depurador ao container.
+5.  Defina breakpoints no código e acesse `http://localhost:8080` para disparar a execução.

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.0.6}/src/delfinance_python_sdk.egg-info/SOURCES.txt

@@ -15,13 +15,18 @@ src/delfinance/abstractions/enums/__init__.py
 src/delfinance/abstractions/enums/environment.py
 src/delfinance/abstractions/startup/__init__.py
 src/delfinance/abstractions/startup/delfinance_client.py
-src/delfinance/transfers/dto/__init__.py
-src/delfinance/transfers/dto/transfer_dto.py
 src/delfinance/transfers/interfaces/__init__.py
+src/delfinance/transfers/interfaces/ipix_service.py
 src/delfinance/transfers/interfaces/itransfers_service.py
+src/delfinance/transfers/requests/__init__.py
+src/delfinance/transfers/requests/decode_qr_code_request.py
+src/delfinance/transfers/requests/payment_initialization_request.py
 src/delfinance/transfers/responses/__init__.py
+src/delfinance/transfers/responses/decode_qr_code_response.py
 src/delfinance/transfers/responses/get_transfer_response.py
+src/delfinance/transfers/responses/payment_initialization_response.py
 src/delfinance/transfers/services/__init__.py
+src/delfinance/transfers/services/pix_service.py
 src/delfinance/transfers/services/transfers_service.py
 src/delfinance_python_sdk.egg-info/PKG-INFO
 src/delfinance_python_sdk.egg-info/SOURCES.txt

delfinance_python_sdk-0.0.4/Dockerfile

@@ -1,10 +0,0 @@
-FROM python:3.7-slim
-
-WORKDIR /app
-
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
-
-COPY . .
-
-CMD ["python", "main.py"]

delfinance_python_sdk-0.0.4/src/delfinance/transfers/responses/get_transfer_response.py

@@ -1,8 +0,0 @@
-from ..dto.transfer_dto import TransferDto
-
-class GetTransferResponse:
-    """
-    Response wrapper for Get Transfer operation.
-    """
-    def __init__(self, transfer: TransferDto):
-        self.transfer = transfer