kobil-payment 1.2.0__tar.gz

kobil_payment-1.2.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: kobil-payment
+Version: 1.2.0
+Summary: KOBIL Pay (mpay-merchant) client for Python with automatic OAuth token management.
+License: MIT
+Project-URL: Repository, https://github.com/uveysservetoglu/kobil-sdks
+Keywords: kobil,payment,mpay,oauth2
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: kobil-core>=1.0
+
+# kobil-payment
+
+KOBIL Pay (mpay-merchant) client for Python, with automatic OAuth token management.
+
+```bash
+pip install kobil-payment
+```
+
+Credentials are shared across modules and read from `KOBIL_*` env vars if omitted.
+`merchant_id` defaults to `client_id`. Amounts are in the smallest currency unit
+(`1300` = 13.00 EUR); timeouts in minutes.
+
+```python
+from kobil.payment import PaymentClient, payment_group
+
+payment = PaymentClient(
+    payment_base_url="https://pay.cloud.kobil.com/mpay-merchant/create/transaction",
+    merchant_name="ISPARK",
+    # credentials optional if KOBIL_* env vars are set:
+    client_id="...", client_secret="...", token_endpoint="https://idp/token",
+)
+
+res = payment.create_transaction(
+    user_id=user_id,
+    amount=1300,
+    payment_content=payment_group(("Service Amount", "10.0 TL"), ("Tax Amount", "3.0 TL")),
+)
+# res["transactionId"], res["status"]
+
+payment.create_pre_auth_transaction(user_id, 1300)
+payment.post_auth(transaction_id, 40)
+payment.get_status(transaction_id)
+payment.cancel(transaction_id, user_id, cancellation_message="Iptal")
+payment.refund(transaction_id, user_id, 5555, currency="USD")
+```
+
+Each operation returns the decoded response dict. Failures raise
+`kobil.payment.KobilPaymentError` (subclass of `kobil.core.KobilError`).
+
+## License
+
+MIT

kobil_payment-1.2.0/README.md

@@ -0,0 +1,42 @@
+# kobil-payment
+
+KOBIL Pay (mpay-merchant) client for Python, with automatic OAuth token management.
+
+```bash
+pip install kobil-payment
+```
+
+Credentials are shared across modules and read from `KOBIL_*` env vars if omitted.
+`merchant_id` defaults to `client_id`. Amounts are in the smallest currency unit
+(`1300` = 13.00 EUR); timeouts in minutes.
+
+```python
+from kobil.payment import PaymentClient, payment_group
+
+payment = PaymentClient(
+    payment_base_url="https://pay.cloud.kobil.com/mpay-merchant/create/transaction",
+    merchant_name="ISPARK",
+    # credentials optional if KOBIL_* env vars are set:
+    client_id="...", client_secret="...", token_endpoint="https://idp/token",
+)
+
+res = payment.create_transaction(
+    user_id=user_id,
+    amount=1300,
+    payment_content=payment_group(("Service Amount", "10.0 TL"), ("Tax Amount", "3.0 TL")),
+)
+# res["transactionId"], res["status"]
+
+payment.create_pre_auth_transaction(user_id, 1300)
+payment.post_auth(transaction_id, 40)
+payment.get_status(transaction_id)
+payment.cancel(transaction_id, user_id, cancellation_message="Iptal")
+payment.refund(transaction_id, user_id, 5555, currency="USD")
+```
+
+Each operation returns the decoded response dict. Failures raise
+`kobil.payment.KobilPaymentError` (subclass of `kobil.core.KobilError`).
+
+## License
+
+MIT

kobil_payment-1.2.0/kobil/payment/__init__.py

@@ -0,0 +1,187 @@
+"""kobil.payment — KOBIL Pay (mpay-merchant) client."""
+
+from __future__ import annotations
+
+import urllib.parse
+from typing import Any, Dict, List, Optional, Sequence, Tuple
+
+from kobil.core import (
+    DefaultTokenProvider,
+    KobilError,
+    ServiceClient,
+    TokenProvider,
+    credentials_from_env,
+    new_uuid,
+)
+
+__all__ = ["PaymentClient", "KobilPaymentError", "payment_group"]
+
+
+class KobilPaymentError(KobilError):
+    """Thrown when a payment operation fails."""
+
+
+def payment_group(*items: Tuple[str, Any]) -> List[List[Dict[str, Any]]]:
+    """Builds a single group of key/value lines.
+
+    Example: payment_group(("Service Amount", "10.0 TL"), ("Tax Amount", "3.0 TL"))
+    """
+    return [[{"key": key, "value": value} for key, value in items]]
+
+
+class PaymentClient(ServiceClient):
+    def __init__(
+        self,
+        *,
+        payment_base_url: str,
+        merchant_name: str,
+        token_endpoint: Optional[str] = None,
+        client_id: Optional[str] = None,
+        client_secret: Optional[str] = None,
+        token_auth_mode: Optional[str] = None,
+        merchant_id: Optional[str] = None,
+        merchant_service_uuid: Optional[str] = None,
+        tenant_id: Optional[str] = None,
+        default_currency: str = "EUR",
+        default_merchant_callback: Optional[str] = None,
+        default_transaction_timeout_minutes: int = 59,
+        version: int = 1,
+        token_provider: Optional[TokenProvider] = None,
+    ) -> None:
+        credentials = credentials_from_env(
+            token_endpoint=token_endpoint,
+            client_id=client_id,
+            client_secret=client_secret,
+            token_auth_mode=token_auth_mode,
+        )
+        super().__init__(token_provider or DefaultTokenProvider(credentials))
+
+        if not payment_base_url:
+            raise KobilPaymentError("payment_base_url is required.")
+        if not merchant_name:
+            raise KobilPaymentError("merchant_name is required.")
+
+        self._base = payment_base_url.rstrip("/")
+        self._client_id = credentials.client_id
+        self._merchant_name = merchant_name
+        self._merchant_id = merchant_id
+        self._merchant_service_uuid = merchant_service_uuid
+        self._tenant_id = tenant_id
+        self._default_currency = default_currency
+        self._default_callback = default_merchant_callback
+        self._default_timeout = default_transaction_timeout_minutes
+        self._version = version
+
+    def _make_error(self, message, status_code=None, response_body=None, cause=None) -> KobilError:
+        return KobilPaymentError(message, status_code, response_body, cause)
+
+    def create_transaction(
+        self,
+        user_id: str,
+        amount: int,
+        payment_content: Optional[Sequence[Sequence[Dict[str, Any]]]] = None,
+        currency: Optional[str] = None,
+        merchant_callback: Optional[str] = None,
+        timeout_minutes: Optional[int] = None,
+        idempotency_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        return self._create(False, user_id, amount, payment_content, currency, merchant_callback, timeout_minutes, idempotency_id)
+
+    def create_pre_auth_transaction(
+        self,
+        user_id: str,
+        amount: int,
+        payment_content: Optional[Sequence[Sequence[Dict[str, Any]]]] = None,
+        currency: Optional[str] = None,
+        merchant_callback: Optional[str] = None,
+        timeout_minutes: Optional[int] = None,
+        idempotency_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        return self._create(True, user_id, amount, payment_content, currency, merchant_callback, timeout_minutes, idempotency_id)
+
+    def _create(self, pre_auth, user_id, amount, payment_content, currency, merchant_callback, timeout_minutes, idempotency_id) -> Dict[str, Any]:
+        if not user_id:
+            raise KobilPaymentError("user_id cannot be empty.")
+        body: Dict[str, Any] = {
+            "version": self._version,
+            "idempotencyId": idempotency_id or new_uuid(),
+            "userId": user_id,
+            "merchantId": self._resolve_merchant_id(),
+            "merchantServiceUUID": self._resolve_service_uuid(),
+            "merchantName": self._merchant_name,
+            "merchantCallback": merchant_callback or self._default_callback,
+            "transactionTimeout": timeout_minutes or self._default_timeout,
+            "tenantId": self._tenant_id,
+            "amount": amount,
+            "currency": (currency or self._default_currency).upper(),
+            "paymentContent": list(payment_content) if payment_content else None,
+        }
+        if pre_auth:
+            body["paymentTenantType"] = "preAuth"
+        return self.send_json("POST", self._base, body)
+
+    def post_auth(self, transaction_id: str, amount: int, merchant_callback: Optional[str] = None, idempotency_id: Optional[str] = None) -> Dict[str, Any]:
+        if not transaction_id:
+            raise KobilPaymentError("transaction_id cannot be empty.")
+        query = {
+            "id": transaction_id,
+            "idempotencyId": idempotency_id or new_uuid(),
+            "amount": str(amount),
+        }
+        callback = merchant_callback or self._default_callback
+        if callback:
+            query["merchantCallback"] = callback
+        return self.send_json("GET", f"{self._base}/postauth?{urllib.parse.urlencode(query)}")
+
+    def get_status(self, transaction_id: str, merchant_callback: Optional[str] = None) -> Dict[str, Any]:
+        if not transaction_id:
+            raise KobilPaymentError("transaction_id cannot be empty.")
+        return self.send_json("POST", f"{self._base}/status", {
+            "merchantId": self._resolve_merchant_id(),
+            "merchantCallback": merchant_callback or self._default_callback,
+            "transactionId": transaction_id,
+        })
+
+    def cancel(self, transaction_id: str, user_id: str, cancellation_message: Optional[str] = None,
+               merchant_callback: Optional[str] = None, timeout_minutes: Optional[int] = None,
+               idempotency_id: Optional[str] = None) -> Dict[str, Any]:
+        if not transaction_id or not user_id:
+            raise KobilPaymentError("transaction_id and user_id are required.")
+        return self.send_json("POST", f"{self._base}/void", {
+            "version": self._version,
+            "userId": user_id,
+            "idempotencyId": idempotency_id or new_uuid(),
+            "merchantServiceUUID": self._resolve_service_uuid(),
+            "merchantCallback": merchant_callback or self._default_callback,
+            "transactionTimeout": timeout_minutes or self._default_timeout,
+            "merchantId": self._resolve_merchant_id(),
+            "paymentTransactionId": transaction_id,
+            "cancellationMessage": cancellation_message,
+        })
+
+    def refund(self, transaction_id: str, user_id: str, amount: int, currency: Optional[str] = None,
+               cancellation_message: Optional[str] = None, merchant_callback: Optional[str] = None,
+               timeout_minutes: Optional[int] = None, idempotency_id: Optional[str] = None) -> Dict[str, Any]:
+        if not transaction_id or not user_id:
+            raise KobilPaymentError("transaction_id and user_id are required.")
+        service_uuid = self._resolve_service_uuid()
+        return self.send_json("POST", f"{self._base}/refund", {
+            "version": self._version,
+            "userId": user_id,
+            "idempotencyId": idempotency_id or new_uuid(),
+            "merchantServiceUUID": service_uuid,
+            "merchantCallback": merchant_callback or self._default_callback,
+            "transactionTimeout": timeout_minutes or self._default_timeout,
+            "merchantId": self._resolve_merchant_id(),
+            "merchantUserId": user_id,
+            "paymentTransactionId": transaction_id,
+            "amount": amount,
+            "currency": (currency or self._default_currency).upper(),
+            "merchantServiceProviderId": service_uuid,
+        })
+
+    def _resolve_merchant_id(self) -> str:
+        return self._merchant_id or self._client_id
+
+    def _resolve_service_uuid(self) -> str:
+        return self._merchant_service_uuid or self._resolve_merchant_id()

kobil_payment-1.2.0/kobil_payment.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: kobil-payment
+Version: 1.2.0
+Summary: KOBIL Pay (mpay-merchant) client for Python with automatic OAuth token management.
+License: MIT
+Project-URL: Repository, https://github.com/uveysservetoglu/kobil-sdks
+Keywords: kobil,payment,mpay,oauth2
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: kobil-core>=1.0
+
+# kobil-payment
+
+KOBIL Pay (mpay-merchant) client for Python, with automatic OAuth token management.
+
+```bash
+pip install kobil-payment
+```
+
+Credentials are shared across modules and read from `KOBIL_*` env vars if omitted.
+`merchant_id` defaults to `client_id`. Amounts are in the smallest currency unit
+(`1300` = 13.00 EUR); timeouts in minutes.
+
+```python
+from kobil.payment import PaymentClient, payment_group
+
+payment = PaymentClient(
+    payment_base_url="https://pay.cloud.kobil.com/mpay-merchant/create/transaction",
+    merchant_name="ISPARK",
+    # credentials optional if KOBIL_* env vars are set:
+    client_id="...", client_secret="...", token_endpoint="https://idp/token",
+)
+
+res = payment.create_transaction(
+    user_id=user_id,
+    amount=1300,
+    payment_content=payment_group(("Service Amount", "10.0 TL"), ("Tax Amount", "3.0 TL")),
+)
+# res["transactionId"], res["status"]
+
+payment.create_pre_auth_transaction(user_id, 1300)
+payment.post_auth(transaction_id, 40)
+payment.get_status(transaction_id)
+payment.cancel(transaction_id, user_id, cancellation_message="Iptal")
+payment.refund(transaction_id, user_id, 5555, currency="USD")
+```
+
+Each operation returns the decoded response dict. Failures raise
+`kobil.payment.KobilPaymentError` (subclass of `kobil.core.KobilError`).
+
+## License
+
+MIT

kobil_payment-1.2.0/kobil_payment.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+kobil/payment/__init__.py
+kobil_payment.egg-info/PKG-INFO
+kobil_payment.egg-info/SOURCES.txt
+kobil_payment.egg-info/dependency_links.txt
+kobil_payment.egg-info/requires.txt
+kobil_payment.egg-info/top_level.txt

kobil_payment-1.2.0/kobil_payment.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kobil_payment-1.2.0/kobil_payment.egg-info/requires.txt

@@ -0,0 +1 @@
+kobil-core>=1.0

kobil_payment-1.2.0/kobil_payment.egg-info/top_level.txt

@@ -0,0 +1 @@
+kobil

kobil_payment-1.2.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kobil-payment"
+version = "1.2.0"
+description = "KOBIL Pay (mpay-merchant) client for Python with automatic OAuth token management."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+keywords = ["kobil", "payment", "mpay", "oauth2"]
+dependencies = ["kobil-core>=1.0"]
+
+[project.urls]
+Repository = "https://github.com/uveysservetoglu/kobil-sdks"
+
+[tool.setuptools.packages.find]
+include = ["kobil*"]
+namespaces = true

kobil_payment-1.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+