sincpro-payments-sdk 0.2.1__tar.gz

sincpro_payments_sdk-0.2.1/LICENSE.md

@@ -0,0 +1,61 @@
+Copyright (c) 2024 Sincpro S.R.L
+LICENCIA EMPRESARIAL DE USO DE SOFTWARE
+
+Términos y Condiciones
+
+1. Definiciones
+   
+   1.1. "Software" hace referencia a cualquier programa de computadora y su documentación relacionada desarrollados
+   por Sincpro Developers.
+
+   1.2. "Cliente" se refiere a cualquier entidad o individuo que obtiene una licencia para utilizar el Software bajo
+   los términos y condiciones establecidos en este documento.
+
+2. Concesión de Licencia
+   Sincpro Developers otorga al Cliente una licencia no exclusiva, no transferible y limitada para utilizar el Software
+   de acuerdo con los términos y condiciones establecidos en este documento.
+
+3. Propiedad y Derechos de Autor
+
+   3.1. El Software es propiedad exclusiva de Sincpro Developers y está protegido por leyes de derechos de autor y otras
+    leyes de propiedad intelectual.
+
+   3.2. El Cliente reconoce y acepta que no adquiere ningún derecho de propiedad sobre el Software, excepto los derechos
+   limitados otorgados por esta licencia.
+
+4. Alcance de Uso
+
+   4.1. El Cliente está autorizado a utilizar el Software únicamente para los fines y en la forma especificados en la
+   documentación proporcionada por Sincpro Developers.
+
+   4.2. El uso del Software por parte del Cliente está limitado al número de usuarios y ubicaciones geográficas
+   especificados en la documentación.
+
+5. Restricciones
+
+   5.1. Queda estrictamente prohibido al Cliente: (a) copiar, modificar o crear trabajos derivados del Software;
+   (b) sublicenciar, transferir o distribuir el Software a terceros;
+   (c) utilizar el Software de manera que infrinja las leyes aplicables.
+
+6. Sanciones y Consecuencias
+
+   6.1. El uso no autorizado o en violación de los términos de esta licencia puede resultar en acciones legales y
+   sanciones que Sincpro Developers considera necesarias y apropiadas.
+
+7. Protección Legal
+
+   7.1. Estos términos y condiciones están sujetos a las leyes y regulaciones aplicables. El Cliente acepta someterse
+   a la jurisdicción de los tribunales competentes en caso de disputa relacionada con el uso del Software.
+
+8. Cambios y Actualizaciones
+
+   8.1. Sincpro Developers se reserva el derecho de actualizar o modificar estos términos y condiciones en cualquier
+    momento. Dichos cambios serán efectivos a partir de la fecha de notificación al Cliente.
+
+9. Aceptación
+
+   9.1. Al utilizar el Software, el Cliente acepta y se compromete a cumplir con los términos y condiciones establecidos
+   en este documento.
+
+Para cualquier consulta sobre esta licencia o para solicitar permisos adicionales, comuníquese con Sincpro Developers
+en Bolivia, Cochabamba Mayor rocha #161 y ayacucho o informacion@sincpro.com.bo

sincpro_payments_sdk-0.2.1/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.1
+Name: sincpro-payments-sdk
+Version: 0.2.1
+Summary: Agnostic SDK for payments like cybersource, Paypal and local payments
+License: Sincpro S.R.L.
+Author: Gutierrez, Andres
+Author-email: andru1236@gmail.com
+Requires-Python: >=3.12,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: pydantic (>=2.9.2,<3.0.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: sincpro-framework (>=1.2.0,<2.0.0)
+Description-Content-Type: text/markdown
+
+## Sincpro payments
+
+> Allow easy interface to interact with the payment gateway

sincpro_payments_sdk-0.2.1/README.md

@@ -0,0 +1,3 @@
+## Sincpro payments
+
+> Allow easy interface to interact with the payment gateway

sincpro_payments_sdk-0.2.1/pyproject.toml

@@ -0,0 +1,44 @@
+[tool.poetry]
+name = "sincpro-payments-sdk"
+version = "0.2.1"
+description = "Agnostic SDK for payments like cybersource, Paypal and local payments"
+authors = ["Gutierrez, Andres <andru1236@gmail.com>"]
+license = "Sincpro S.R.L."
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.12"
+requests = "^2.32.3"
+pydantic = "^2.9.2"
+sincpro-framework = "^1.2.0"
+
+[tool.poetry.group.dev.dependencies]
+isort = "^5.12.0"
+black = "^24.8.0"
+pytest = "^8.3.3"
+ipython = "^8.28.0"
+autoflake = "^2.3.1"
+jupyterlab = "^4.2.5"
+icecream = "^2.1.3"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pylint]
+disable = [
+    "missing-docstring",
+    "fixme",
+    "C0103",
+    "C0301",
+    "R0903",
+    "C0413",
+    "W1203",
+    "I1101",
+    "W1309",
+    "R0902",
+    "C0415",
+]
+
+[tool.black]
+line-length = 94

sincpro_payments_sdk-0.2.1/sincpro_payments_sdk/apps/cybersource/adapters/cybersource_rest_api/common.py

@@ -0,0 +1,25 @@
+"""Common DTOs for CyberSource REST API."""
+
+from sincpro_payments_sdk.apps.cybersource.domain import LinkSerMMDRequired
+from sincpro_payments_sdk.infrastructure.client_api import ApiResponse
+from sincpro_payments_sdk.infrastructure.pydantic import BaseModel
+
+
+class CyberSourceBaseResponse(ApiResponse):
+    id: str
+
+
+class LinkResponse(BaseModel):
+    """Link response."""
+
+    href: str
+    method: str
+
+
+def create_merchant_def_map(merchant_defined_data: LinkSerMMDRequired) -> list[dict]:
+    """Create a map of merchant defined data."""
+    format_merchant_defined_data = list()
+    for key, value in merchant_defined_data.model_dump().items():
+        last_word = key.split("_")[-1]
+        format_merchant_defined_data.append({"key": last_word, "value": value})
+    return format_merchant_defined_data

sincpro_payments_sdk-0.2.1/sincpro_payments_sdk/apps/cybersource/adapters/cybersource_rest_api/payer_auth_adapter.py

@@ -0,0 +1,228 @@
+"""Payer Auth API adapter."""
+
+from typing import Literal
+
+from sincpro_payments_sdk.apps.cybersource.domain import (
+    CardMonthOrDay,
+    CardNumber,
+    CardType,
+    CardYear4Digits,
+    LinkSerMMDRequired,
+)
+from sincpro_payments_sdk.infrastructure.client_api import ClientAPI
+
+# isort: off
+from sincpro_payments_sdk.apps.cybersource.infrastructure import (
+    CyberSourceAuth,
+    get_credential,
+)
+from .common import CyberSourceBaseResponse, create_merchant_def_map
+
+# isort: on
+
+
+class SetupAuthenticationResponse(CyberSourceBaseResponse):
+    client_ref_info: str
+    access_token: str
+    device_data_collection_url: str
+    reference_id: str
+    token: str
+    status: Literal["COMPLETED", "FAILED"]
+
+
+class AuthenticationResponse(CyberSourceBaseResponse):
+    status: Literal[
+        "AUTHENTICATION_SUCCESSFUL", "PENDING_AUTHENTICATION", "PENDING_AUTHENTICATION"
+    ]
+    auth_transaction_id: str
+    client_ref_info: str
+    cavv: str | None = None
+    challenge_required: str | None = None
+    access_token: str | None = None
+    step_up_url: str | None = None
+    token: str | None = None
+
+
+class PayerAuthenticationAdapter(ClientAPI):
+    """Adapter for CyberSource Payer Authentication API requests.
+
+    Steps to execute the process Payer Authentication:
+        - Setup Payer Authentication
+        - Authenticate Enrollment
+        - Validate Authentication
+    """
+
+    ROUTE_SETUP_PAYER_AUTH = "/risk/v1/authentication-setups"
+    ROUTE_AUTH_ENROLLMENT = "/risk/v1/authentications"
+    ROUTE_VALIDATE_AUTH = "/risk/v1/authentication-results"
+
+    def __init__(self):
+        """Initialize with a CyberSource client."""
+        self.ssl = "https://"
+        self.host = "apitest.cybersource.com"
+        super().__init__(self.base_url, auth=CyberSourceAuth(get_credential()))
+
+    @property
+    def base_url(self):
+        """Get the base URL for the CyberSource API."""
+        return f"{self.ssl}{self.host}"
+
+    def setup_payer_auth(
+        self,
+        card_number: CardNumber,
+        month: CardMonthOrDay,
+        year: CardYear4Digits,
+        card_type: CardType,
+        transaction_ref: str,
+    ) -> SetupAuthenticationResponse:
+        """Setup Payer Authentication with CyberSource."""
+        payload = {
+            "clientReferenceInformation": {"code": transaction_ref},
+            "paymentInformation": {
+                "card": {
+                    "type": card_type,
+                    "expirationMonth": month,
+                    "expirationYear": year,
+                    "number": card_number,
+                }
+            },
+        }
+
+        response = self.execute_request(
+            self.ROUTE_SETUP_PAYER_AUTH,
+            "POST",
+            data=payload,
+        )
+        dict_response = response.json()
+        if "errorInformation" in dict_response:
+            raise Exception(str(dict_response["errorInformation"]))
+
+        return SetupAuthenticationResponse(
+            raw_response=dict_response,
+            id=dict_response.get("id"),
+            client_ref_info=dict_response["clientReferenceInformation"]["code"],
+            access_token=dict_response["consumerAuthenticationInformation"]["accessToken"],
+            device_data_collection_url=dict_response["consumerAuthenticationInformation"][
+                "deviceDataCollectionUrl"
+            ],
+            reference_id=dict_response["consumerAuthenticationInformation"]["referenceId"],
+            token=dict_response["consumerAuthenticationInformation"]["token"],
+            status=dict_response.get("status"),
+        )
+
+    def auth_enrollment(
+        self,
+        card_number: CardNumber,
+        month: CardMonthOrDay,
+        year: CardYear4Digits,
+        card_type: CardType,
+        transaction_ref: str,
+        reference_id: str,
+        amount: str | float,
+        currency: str,
+        linkser_merchant_def: LinkSerMMDRequired | None = None,
+    ) -> AuthenticationResponse:
+        """Authenticate enrollment with CyberSource."""
+        payload = {
+            "paymentInformation": {
+                "card": {
+                    "type": card_type,
+                    "expirationMonth": month,
+                    "expirationYear": year,
+                    "number": card_number,
+                }
+            },
+            "clientReferenceInformation": {"code": transaction_ref},
+            "consumerAuthenticationInformation": {
+                "referenceId": reference_id,
+                "deviceChannel": "Browser",
+            },
+            "orderInformation": {
+                "amountDetails": {
+                    "totalAmount": amount,
+                    "currency": currency,
+                },
+            },
+        }
+
+        if linkser_merchant_def:
+            payload["merchantDefinedInformation"] = create_merchant_def_map(
+                linkser_merchant_def
+            )
+
+        response = self.execute_request(
+            self.ROUTE_AUTH_ENROLLMENT,
+            "POST",
+            data=payload,
+        )
+        dict_response = response.json()
+
+        return AuthenticationResponse(
+            raw_response=dict_response,
+            id=dict_response.get("id"),
+            status=dict_response.get("status"),
+            auth_transaction_id=dict_response["consumerAuthenticationInformation"][
+                "authenticationTransactionId"
+            ],
+            client_ref_info=dict_response["clientReferenceInformation"]["code"],
+            cavv=dict_response["consumerAuthenticationInformation"].get("cavv", None),
+            challenge_required=dict_response["consumerAuthenticationInformation"].get(
+                "challengeRequired", None
+            ),
+            access_token=dict_response["consumerAuthenticationInformation"].get(
+                "accessToken", None
+            ),
+            step_up_url=dict_response["consumerAuthenticationInformation"].get(
+                "stepUpUrl", None
+            ),
+            token=dict_response["consumerAuthenticationInformation"].get("token", None),
+        )
+
+    def validate_auth(
+        self,
+        card_number: CardNumber,
+        month: CardMonthOrDay,
+        year: CardMonthOrDay,
+        card_type: CardType,
+        auth_transaction_id: str,
+        amount: str | float,
+        currency: str,
+    ) -> AuthenticationResponse:
+        """Validate authentication with CyberSource."""
+        response = self.execute_request(
+            self.ROUTE_AUTH_ENROLLMENT,
+            "POST",
+            data={
+                "paymentInformation": {
+                    "card": {
+                        "type": card_type,
+                        "expirationMonth": month,
+                        "expirationYear": year,
+                        "number": card_number,
+                    }
+                },
+                "consumerAuthenticationInformation": {
+                    "authenticationTransactionId": auth_transaction_id
+                },
+                "orderInformation": {
+                    "amountDetails": {
+                        "totalAmount": amount,
+                        "currency": currency,
+                    },
+                },
+            },
+        )
+
+        dict_response = response.json()
+        if "errorInformation" in dict_response:
+            raise Exception(str(dict_response["errorInformation"]))
+
+        return AuthenticationResponse(
+            raw_response=dict_response,
+            id=dict_response.get("id"),
+            status=dict_response.get("status"),
+            auth_transaction_id=dict_response["consumerAuthenticationInformation"][
+                "authenticationTransactionId"
+            ],
+            client_ref_info=dict_response["clientReferenceInformation"]["code"],
+        )