payme-pkg 3.3.0__cp312-cp312-macosx_10_13_universal2.whl

payme/types/response/receipts.py

@@ -0,0 +1,242 @@
+import inspect
+import typing as t
+
+from dataclasses import dataclass
+
+
+@dataclass
+class Common:
+    """
+    The common response structure.
+    """
+
+    jsonrpc: str
+    id: int
+
+    @classmethod
+    def from_dict(cls, data: t.Dict):
+        """
+        Prepare fields for nested dataclasses
+        """
+        field_values = {}
+        for field in cls.__dataclass_fields__:
+            field_type = cls.__dataclass_fields__[field].type
+            field_data = data.get(field)
+
+            # Check if field_type is a class and subclass of Common
+            if isinstance(field_data, dict) and inspect.isclass(field_type) and issubclass(field_type, Common):
+                field_values[field] = field_type.from_dict(field_data)
+            else:
+                field_values[field] = field_data
+
+        return cls(**field_values)
+
+
+@dataclass
+class Account(Common):
+    """
+    The account object represents a user's banking account.
+    """
+
+    _id: str
+    account_number: str
+    account_name: str
+    account_type: str
+    bank_name: str
+    currency: str
+    status: str
+
+
+@dataclass
+class PaymentMethod(Common):
+    """
+    The payment method object represents a user's payment method.
+    """
+
+    name: str
+    title: str
+    value: str
+    main: t.Optional[bool] = None
+
+
+@dataclass
+class Detail(Common):
+    """
+    The detail object represents additional details for a receipt.
+    """
+
+    discount: t.Optional[str] = None
+    shipping: t.Optional[str] = None
+    items: t.Optional[str] = None
+
+
+# pylint: disable=C0103
+@dataclass
+class MerchantEpos(Common):
+    """
+    The merchantEpos object represents a user's ePOS.
+    """
+
+    eposId: str
+    eposName: str
+    eposType: str
+    eposTerminalId: str
+
+
+@dataclass
+class Meta(Common):
+    """
+    The meta object represents additional metadata for a receipt.
+    """
+
+    source: t.Any = None
+    owner: t.Any = None
+    host: t.Any = None
+
+
+@dataclass
+class Merchant:
+    """
+    The merchant object represents a user's merchant.
+    """
+
+    _id: str
+    name: str
+    organization: str
+    address: t.Optional[str] = None
+    business_id: t.Optional[str] = None
+    epos: t.Optional[MerchantEpos] = None
+    restrictions: t.Optional[str] = None
+    date: t.Optional[int] = None
+    logo: t.Optional[str] = None
+    type: t.Optional[str] = None
+    terms: t.Optional[str] = None
+
+
+@dataclass
+class Payer(Common):
+    """
+    The payer object represents a user's payer.
+    """
+
+    phone: str
+
+
+@dataclass
+class Receipt(Common):
+    """
+    The receipt object represents a payment receipt.
+    """
+
+    _id: str
+    create_time: int
+    pay_time: int
+    cancel_time: int
+    state: int
+    type: int
+    external: bool
+    operation: int
+    error: t.Any = None
+    description: t.Optional[str] = None
+    detail: t.Optional[Detail] = None
+    currency: t.Optional[int] = None
+    commission: t.Optional[int] = None
+    card: t.Optional[str] = None
+    creator: t.Optional[str] = None
+    payer: t.Optional[Payer] = None
+    amount: t.Optional[t.Union[float, int]] = None
+    account: t.Optional[t.List[Account]] = None
+    merchant: t.Optional[Merchant] = None
+    processing_id: t.Optional[str] = None
+    meta: t.Optional[Meta] = None
+
+
+@dataclass
+class CreateResult(Common):
+    """
+    The result object for the create response.
+    """
+
+    receipt: Receipt
+
+
+@dataclass
+class CreateResponse(Common):
+    """
+    The create response structure.
+    """
+
+    result: CreateResult
+
+
+@dataclass
+class PayResponse(CreateResponse):
+    """
+    The pay response structure.
+    """
+
+
+@dataclass
+class SendResult(Common):
+    """
+    The result object for the send response.
+    """
+
+    success: bool
+
+
+@dataclass
+class SendResponse(Common):
+    """
+    The send response structure.
+    """
+
+    result: SendResult
+
+
+@dataclass
+class CancelResponse(CreateResponse):
+    """
+    The cancel response structure.
+    """
+
+
+@dataclass
+class CheckResult(Common):
+    """
+    The result object for the check response.
+    """
+
+    state: int
+
+
+@dataclass
+class CheckResponse(Common):
+    """
+    The check response structure.
+    """
+
+    result: CheckResult
+
+
+@dataclass
+class GetResponse(CreateResponse):
+    """
+    The result object for the get response.
+    """
+
+
+@dataclass
+class GetAllResponse(Common):
+    """
+    The result object for the get all response.
+    """
+    result: list[Receipt] = None
+
+
+@dataclass
+class SetFiscalDataResponse(Common):
+    """
+    The result object for the set_fiscal_data response.
+    """
+    result: SendResult

payme/types/response/webhook.py

@@ -0,0 +1,154 @@
+import typing as t
+from dataclasses import dataclass, field
+
+
+class CommonResponse:
+    """
+    The common response structure
+    """
+
+    def as_resp(self):
+        response = {"result": {}}
+        for key, value in self.__dict__.items():
+            response["result"][key] = value
+        return response
+
+
+@dataclass
+class Shipping(CommonResponse):
+    """
+    Shipping information response structure
+    """
+
+    title: str
+    price: int
+
+
+@dataclass
+class Item(CommonResponse):
+    """
+    Item information response structure
+    """
+
+    discount: int
+    title: str
+    price: int
+    count: int
+    code: str
+    units: int
+    vat_percent: int
+    package_code: str
+
+    def as_resp(self):
+        return {
+            "discount": self.discount,
+            "title": self.title,
+            "price": self.price,
+            "count": self.count,
+            "code": self.code,
+            "units": self.units,
+            "vat_percent": self.vat_percent,
+            "package_code": self.package_code,
+        }
+
+
+@dataclass
+class CheckPerformTransaction(CommonResponse):
+    """
+    Receipt information response structure for transaction checks.
+    """
+
+    allow: bool
+    additional: t.Optional[t.Dict[str, str]] = None
+    receipt_type: t.Optional[int] = None
+    shipping: t.Optional[Shipping] = None
+    items: t.List[Item] = field(default_factory=list)
+
+    def add_item(self, item: Item):
+        self.items.append(item)
+
+    def as_resp(self):
+        detail_dict = {}
+        receipt_dict = {"allow": self.allow}
+
+        if self.additional:
+            receipt_dict["additional"] = self.additional
+
+        if isinstance(self.receipt_type, int):
+            detail_dict["receipt_type"] = self.receipt_type
+
+        if self.shipping:
+            detail_dict["shipping"] = self.shipping.as_resp()
+
+        if self.items:
+            detail_dict["items"] = [item.as_resp() for item in self.items]
+
+        if detail_dict:
+            receipt_dict["detail"] = detail_dict
+
+        return {"result": receipt_dict}
+
+
+@dataclass
+class CreateTransaction(CommonResponse):
+    """
+    The create transaction request
+    """
+
+    transaction: str
+    state: str
+    create_time: int
+
+
+@dataclass
+class PerformTransaction(CommonResponse):
+    """
+    The perform transaction response
+    """
+
+    transaction: str
+    state: str
+    perform_time: int
+
+
+@dataclass
+class CancelTransaction(CommonResponse):
+    """
+    The cancel transaction request
+    """
+
+    transaction: str
+    state: str
+    cancel_time: str
+
+
+@dataclass
+class CheckTransaction(CommonResponse):
+    """
+    The check transaction request
+    """
+
+    transaction: str
+    state: str
+    reason: str
+    create_time: int
+    perform_time: t.Optional[int] = None
+    cancel_time: t.Optional[int] = None
+
+
+@dataclass
+class GetStatement(CommonResponse):
+    """
+    The check perform transactions response
+    """
+
+    transactions: t.List[t.Dict[str, str | int | t.Dict[str, str | int]]]
+
+
+@dataclass
+class SetFiscalData(CommonResponse):
+    """
+    The set fiscal data request
+    """
+
+    success: bool

payme/views/__init__.py

@@ -0,0 +1,5 @@
+from payme.views.payme import PaymeWebHookAPIView
+
+__all__ = [
+    'PaymeWebHookAPIView',
+]

payme/views/payme.py

@@ -0,0 +1,31 @@
+from payme.views.base import BasePaymeWebHookAPIView
+
+
+class PaymeWebHookAPIView(BasePaymeWebHookAPIView):
+    """
+    A webhook view for Payme with callback handlers.
+    """
+
+    def handle_pre_payment(self, params, result, *args, **kwargs):
+        """
+        Handle the pre_create_transaction action. You can override this method
+        """
+        print(f"Transaction pre_created for this params: {params} and pre_created_result: {result}")
+
+    def handle_created_payment(self, params, result, *args, **kwargs):
+        """
+        Handle the successful payment. You can override this method
+        """
+        print(f"Transaction created for this params: {params} and cr_result: {result}")
+
+    def handle_successfully_payment(self, params, result, *args, **kwargs):
+        """
+        Handle the successful payment. You can override this method
+        """
+        print(f"Transaction successfully performed for this params: {params} and performed_result: {result}")
+
+    def handle_cancelled_payment(self, params, result, *args, **kwargs):
+        """
+        Handle the cancelled payment. You can override this method
+        """
+        print(f"Transaction cancelled for this params: {params} and cancelled_result: {result}")