python-getpaid-payu 0.1.0__tar.gz → 3.0.0a3__tar.gz

python_getpaid_payu-3.0.0a3/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint with ruff
+        run: uv run ruff check .
+
+      - name: Run tests
+        run: uv run pytest --tb=short

python_getpaid_payu-3.0.0a3/.sisyphus/evidence/task-26-readme-payu.txt

@@ -0,0 +1,3 @@
+86 README.md
+1
+8

python_getpaid_payu-3.0.0a3/.sisyphus/evidence/task-5-baseline-payu.txt

@@ -0,0 +1,200 @@
+================================================================================
+TASK 5 BASELINE: python-getpaid-payu
+Executed: 2026-02-18
+================================================================================
+
+DIRECTORY: /home/minder/projekty/python-getpaid/getpaid-payu/
+
+================================================================================
+1. PYTEST RESULTS
+================================================================================
+
+Command: uv run pytest
+
+Output:
+============================= test session starts ==============================
+platform linux -- Python 3.12.10, pytest-9.0.2, pluggy-1.6.0
+rootdir: /home/minder/projekty/python-getpaid/getpaid-payu
+configfile: pyproject.toml
+testpaths: tests
+plugins: asyncio-1.3.0, cov-7.0.0, anyio-4.12.1, respx-0.22.0
+asyncio: mode=Mode.AUTO, debug=False, asyncio_default_fixture_loop_scope=None, asyncio_default_test_fixture_scope=function
+collected 115 items
+
+tests/test_callback.py ...................               [ 16%]
+tests/test_client.py ................................................... [ 60%]
+.........                                                                [ 68%]
+tests/test_processor.py .........................        [ 90%]
+tests/test_types.py ...........                          [100%]
+
+============================= 115 passed in 2.57s ==============================
+
+STATUS: ✓ ALL TESTS PASSED
+
+================================================================================
+2. BUILD RESULTS
+================================================================================
+
+Command: uv build
+
+Output:
+Building source distribution...
+Building wheel from source distribution...
+Successfully built dist/python_getpaid_payu-0.1.1.tar.gz
+Successfully built dist/python_getpaid_payu-0.1.1-py3-none-any.whl
+
+STATUS: ✓ BUILD SUCCESSFUL
+
+Artifacts:
+  - dist/python_getpaid_payu-0.1.1.tar.gz (source distribution)
+  - dist/python_getpaid_payu-0.1.1-py3-none-any.whl (wheel)
+
+================================================================================
+3. PACKAGE METADATA INVENTORY
+================================================================================
+
+Project Name:           python-getpaid-payu
+Version:                0.1.1
+Python Requirement:     >= 3.12
+License:                MIT (text format)
+Authors:                Dominik Kozaczko <dominik@kozaczko.info>
+
+Description:            PayU payment gateway integration for python-getpaid ecosystem.
+
+Dependencies:
+  - python-getpaid-core >= 0.1.0
+  - httpx >= 0.27.0
+
+Development Dependencies:
+  - pytest >= 8.0
+  - pytest-asyncio >= 0.24.0
+  - pytest-cov >= 5.0
+  - respx >= 0.22.0
+  - ruff >= 0.9.0
+  - pre-commit >= 4.0
+  - ty >= 0.0.16
+
+Documentation Dependencies:
+  - furo >= 2024.8.6
+  - sphinx >= 8.0
+  - myst-parser >= 4.0
+
+URLs:
+  - Homepage: https://github.com/django-getpaid/python-getpaid-payu
+  - Repository: https://github.com/django-getpaid/python-getpaid-payu
+  - Documentation: https://getpaid-payu.readthedocs.io/
+  - Changelog: https://github.com/django-getpaid/python-getpaid-payu/releases
+
+Build System:           hatchling
+
+Classifiers:
+  - Development Status :: 3 - Alpha
+  - Intended Audience :: Developers
+  - License :: OSI Approved :: MIT License
+  - Programming Language :: Python :: 3.12
+  - Programming Language :: Python :: 3.13
+  - Topic :: Office/Business :: Financial
+  - Topic :: Office/Business :: Financial :: Point-Of-Sale
+  - Typing :: Typed
+
+================================================================================
+4. LICENSE CHECK
+================================================================================
+
+LICENSE File Status:    ✓ PRESENT
+Format:                 MIT License
+Copyright:              2022-2026 Dominik Kozaczko
+Consistency:            ✓ Matches pyproject.toml declaration (MIT)
+
+================================================================================
+5. README.MD CHECK
+================================================================================
+
+README File Status:     ✓ PRESENT
+Size:                   ~4.5 KB (129 lines)
+Content Verification:
+  ✓ Project description (PayU payment gateway plugin)
+  ✓ Architecture section (PayUClient + PayUProcessor)
+  ✓ Key features listed
+  ✓ Quick usage examples (async context manager)
+  ✓ Configuration table with all parameters
+  ✓ Supported currencies listed
+  ✓ Requirements section
+  ✓ Related projects links
+  ✓ License information
+  ✓ Disclaimer section
+  ✓ Credits
+
+================================================================================
+6. GITHUB WORKFLOWS (.github/workflows/)
+================================================================================
+
+Status:                 ✗ NOT PRESENT
+
+No .github/workflows/ directory found in the repository.
+Note: Project is part of the python-getpaid umbrella but does not have its own CI configuration.
+
+================================================================================
+7. ENTRY-POINTS ANALYSIS [CRITICAL]
+================================================================================
+
+Section Name:           [project.entry-points."getpaid.backends"]
+Status:                 ✗ ENTRY-POINTS NOT DEFINED
+
+Current State:
+  - pyproject.toml does NOT contain any [project.entry-points] section
+  - grep search: "No entry-points found in pyproject.toml"
+
+Impact Analysis:
+  The PayUProcessor is the main integration point with getpaid-core.
+  Entry-points are REQUIRED for plugin auto-discovery by framework adapters
+  (e.g., django-getpaid).
+
+Expected Entry-Point (if needed):
+  [project.entry-points."getpaid.backends"]
+  payu = "getpaid_payu.processor:PayUProcessor"
+
+  OR (if supporting multiple backends):
+  [project.entry-points."getpaid.backends"]
+  payu = "getpaid_payu.processor:PayUProcessor"
+
+Recommendation:
+  TASK 10 (Add entry-points configuration) IS REQUIRED
+  Current state prevents framework adapters from auto-discovering PayUProcessor.
+
+================================================================================
+8. PYPROJECT.TOML STRUCTURE
+================================================================================
+
+Build Section:          ✓ Present (hatchling)
+Test Configuration:     ✓ Present (pytest)
+Coverage Config:        ✓ Present
+Linter Config (ruff):   ✓ Present
+Type Checker (ty):      ✓ Present
+Project Metadata:       ✓ Complete
+
+Entry-Points Section:   ✗ MISSING (BLOCKING FOR TASK 10)
+
+================================================================================
+SUMMARY
+================================================================================
+
+✓ Pytest: 115 passed (2.57s)
+✓ Build: Successful (tarball + wheel)
+✓ License: MIT, properly formatted
+✓ README: Comprehensive documentation
+✓ Version: 0.1.1 (consistent across build artifacts)
+✓ Metadata: Complete and correct
+
+✗ Entry-Points: NOT DEFINED
+  → PayUProcessor cannot be auto-discovered by framework adapters
+  → Task 10 required to add: [project.entry-points."getpaid.backends"]
+
+BLOCKERS: Entry-points missing (expected, noted in Metis feedback)
+
+NEXT STEPS:
+  - Task 10: Add entry-points configuration
+  - Ensure PayUProcessor class is properly exported for discovery
+
+================================================================================
+EOF

python_getpaid_payu-3.0.0a3/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: python-getpaid-payu
+Version: 3.0.0a3
+Summary: PayU payment gateway integration for python-getpaid ecosystem.
+Project-URL: Homepage, https://github.com/django-getpaid/python-getpaid-payu
+Project-URL: Repository, https://github.com/django-getpaid/python-getpaid-payu
+Project-URL: Documentation, https://getpaid-payu.readthedocs.io/
+Project-URL: Changelog, https://github.com/django-getpaid/python-getpaid-payu/releases
+Author-email: Dominik Kozaczko <dominik@kozaczko.info>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-getpaid-core>=3.0.0a3
+Description-Content-Type: text/markdown
+
+# python-getpaid-payu
+
+[![PyPI version](https://img.shields.io/pypi/v/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PayU payment processor plugin for the [python-getpaid](https://github.com/django-getpaid/python-getpaid-core) ecosystem.
+
+Provides a fully async HTTP client (`PayUClient`) and a payment processor (`PayUProcessor`) implementing the [getpaid-core](https://github.com/django-getpaid/python-getpaid-core) `BaseProcessor` interface. Communicates with PayU via their REST API v2.1 using OAuth2 authentication.
+
+## Features
+
+- **Full Payment Lifecycle**: Supports prepared, locked, paid, failed, and refunded states.
+- **Pre-authorization**: Reserve funds on customer's card (lock) and capture them later (charge).
+- **Refunds**: Full and partial refund support via API.
+- **Multiple Currencies**: Support for 15 currencies across Europe and beyond.
+- **Asynchronous**: Built with `httpx` for non-blocking API communication.
+- **Security**: Robust callback signature verification (SHA-256 and MD5).
+- **Comprehensive API**: Wraps every PayU REST API v2.1 endpoint.
+
+## Supported Currencies
+
+The following 15 currencies are supported:
+BGN, CHF, CZK, DKK, EUR, GBP, HRK, HUF, NOK, PLN, RON, RUB, SEK, UAH, USD.
+
+## Installation
+
+```bash
+pip install python-getpaid-payu
+```
+
+## Configuration
+
+To use the PayU backend, register it in your `getpaid` configuration and provide the following settings:
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `pos_id` | `int` | — | PayU POS (point of sale) identifier |
+| `second_key` | `str` | — | Second key (MD5) from PayU panel, used for signature verification |
+| `oauth_id` | `int` | — | OAuth client ID from PayU panel |
+| `oauth_secret` | `str` | — | OAuth client secret from PayU panel |
+| `sandbox` | `bool` | `True` | Use sandbox (`secure.snd.payu.com`) or production (`secure.payu.com`) |
+| `notify_url` | `str` | `None` | Notification callback URL template, e.g. `https://example.com/payments/{payment_id}/notify` |
+| `continue_url` | `str` | `None` | Redirect URL template after payment, e.g. `https://example.com/payments/{payment_id}/continue` |
+
+Example configuration:
+
+```python
+GETPAID_BACKENDS = {
+    "payu": {
+        "pos_id": "300746",
+        "second_key": "b6ca15b0d1020e8094d9b5f8d163db54",
+        "oauth_id": "300746",
+        "oauth_secret": "2ee86a66e5d97e3fadc400c9f19b065d",
+        "notify_url": "https://your-domain.com/payments/payu/callback/",
+        "continue_url": "https://your-domain.com/payments/payu/success/",
+        "sandbox": True,
+    }
+}
+```
+
+### Sandbox Mode
+
+PayU provides a sandbox environment for testing. You can use the example keys provided above for testing in PLN.
+
+## Ecosystem
+
+`python-getpaid-payu` is part of the larger `python-getpaid` ecosystem. Use it with one of our web framework wrappers:
+
+- [django-getpaid](https://github.com/django-getpaid/django-getpaid)
+- [litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)
+- [fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)
+
+## Requirements
+
+- Python 3.12+
+- `python-getpaid-core >= 3.0.0a3`
+- `httpx >= 0.27.0`
+
+## License
+
+MIT
+
+## Credits
+
+Created by [Dominik Kozaczko](https://github.com/dekoza).

python_getpaid_payu-3.0.0a3/README.md

@@ -0,0 +1,86 @@
+# python-getpaid-payu
+
+[![PyPI version](https://img.shields.io/pypi/v/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PayU payment processor plugin for the [python-getpaid](https://github.com/django-getpaid/python-getpaid-core) ecosystem.
+
+Provides a fully async HTTP client (`PayUClient`) and a payment processor (`PayUProcessor`) implementing the [getpaid-core](https://github.com/django-getpaid/python-getpaid-core) `BaseProcessor` interface. Communicates with PayU via their REST API v2.1 using OAuth2 authentication.
+
+## Features
+
+- **Full Payment Lifecycle**: Supports prepared, locked, paid, failed, and refunded states.
+- **Pre-authorization**: Reserve funds on customer's card (lock) and capture them later (charge).
+- **Refunds**: Full and partial refund support via API.
+- **Multiple Currencies**: Support for 15 currencies across Europe and beyond.
+- **Asynchronous**: Built with `httpx` for non-blocking API communication.
+- **Security**: Robust callback signature verification (SHA-256 and MD5).
+- **Comprehensive API**: Wraps every PayU REST API v2.1 endpoint.
+
+## Supported Currencies
+
+The following 15 currencies are supported:
+BGN, CHF, CZK, DKK, EUR, GBP, HRK, HUF, NOK, PLN, RON, RUB, SEK, UAH, USD.
+
+## Installation
+
+```bash
+pip install python-getpaid-payu
+```
+
+## Configuration
+
+To use the PayU backend, register it in your `getpaid` configuration and provide the following settings:
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `pos_id` | `int` | — | PayU POS (point of sale) identifier |
+| `second_key` | `str` | — | Second key (MD5) from PayU panel, used for signature verification |
+| `oauth_id` | `int` | — | OAuth client ID from PayU panel |
+| `oauth_secret` | `str` | — | OAuth client secret from PayU panel |
+| `sandbox` | `bool` | `True` | Use sandbox (`secure.snd.payu.com`) or production (`secure.payu.com`) |
+| `notify_url` | `str` | `None` | Notification callback URL template, e.g. `https://example.com/payments/{payment_id}/notify` |
+| `continue_url` | `str` | `None` | Redirect URL template after payment, e.g. `https://example.com/payments/{payment_id}/continue` |
+
+Example configuration:
+
+```python
+GETPAID_BACKENDS = {
+    "payu": {
+        "pos_id": "300746",
+        "second_key": "b6ca15b0d1020e8094d9b5f8d163db54",
+        "oauth_id": "300746",
+        "oauth_secret": "2ee86a66e5d97e3fadc400c9f19b065d",
+        "notify_url": "https://your-domain.com/payments/payu/callback/",
+        "continue_url": "https://your-domain.com/payments/payu/success/",
+        "sandbox": True,
+    }
+}
+```
+
+### Sandbox Mode
+
+PayU provides a sandbox environment for testing. You can use the example keys provided above for testing in PLN.
+
+## Ecosystem
+
+`python-getpaid-payu` is part of the larger `python-getpaid` ecosystem. Use it with one of our web framework wrappers:
+
+- [django-getpaid](https://github.com/django-getpaid/django-getpaid)
+- [litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)
+- [fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)
+
+## Requirements
+
+- Python 3.12+
+- `python-getpaid-core >= 3.0.0a3`
+- `httpx >= 0.27.0`
+
+## License
+
+MIT
+
+## Credits
+
+Created by [Dominik Kozaczko](https://github.com/dekoza).

{python_getpaid_payu-0.1.0 → python_getpaid_payu-3.0.0a3}/docs/changelog.md

@@ -17,6 +17,6 @@ Initial release.
 - Token deletion
 - Automatic amount centification/normalization
 - Signature verification (MD5 and SHA-256)
-- PUSH callback handling with FSM integration
+- PUSH callback handling with semantic payment updates
 - PULL status polling
 - Full pre-authorization support (lock, charge, release)

{python_getpaid_payu-0.1.0 → python_getpaid_payu-3.0.0a3}/docs/concepts.md

@@ -17,9 +17,9 @@ The standard payment flow with PayU:
                          └── PayUProcessor.verify_callback()
                               └── Signature verification
                          └── PayUProcessor.handle_callback()
-                              └── FSM transitions:
-                                  COMPLETED → confirm_payment → mark_as_paid
-                                  CANCELED  → fail
+                              └── semantic updates:
+                                  COMPLETED → payment_captured
+                                  CANCELED  → failed
 ```
 
 ### Step by Step
@@ -33,11 +33,11 @@ The standard payment flow with PayU:
 
 3. **Notification** — PayU sends a PUSH notification (HTTP POST) to the
    `notify_url` with the order status. The framework adapter passes this to
-   `verify_callback()` (signature check) and then `handle_callback()` (FSM
-   state transitions).
+   `verify_callback()` (signature check) and then `handle_callback()` (semantic
+   update generation).
 
-4. **Status update** — The payment status is updated via FSM transitions
-   based on the PayU order status.
+4. **Status update** — The payment status is updated by applying semantic
+   payment events based on the PayU order status.
 
 ## Pre-authorization Flow
 
@@ -49,7 +49,7 @@ locked on the buyer's account first, then charged or released later:
                          └── PayU returns WAITING_FOR_CONFIRMATION status
 
 2. PayU callback         handle_callback()
-                         └── WAITING_FOR_CONFIRMATION → confirm_lock
+                         └── WAITING_FOR_CONFIRMATION → locked
 
 3a. Capture (charge)     PayUProcessor.charge()
                          └── PayUClient.capture()
@@ -73,9 +73,9 @@ Refunds can be full or partial:
 
 3. PayU callback         handle_callback()
                          └── refund.status == FINALIZED
-                              → confirm_refund → mark_as_refunded
+                              → refund_confirmed
                          └── refund.status == CANCELED
-                              → cancel_refund → mark_as_paid
+                              → refund_cancelled
 ```
 
 ## OAuth2 Authentication

{python_getpaid_payu-0.1.0 → python_getpaid_payu-3.0.0a3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = 'python-getpaid-payu'
-version = '0.1.0'
+dynamic = ["version"]
 description = 'PayU payment gateway integration for python-getpaid ecosystem.'
 readme = 'README.md'
 license = {text = 'MIT'}
@@ -19,7 +19,7 @@ classifiers = [
     'Typing :: Typed',
 ]
 dependencies = [
-    'python-getpaid-core>=0.1.0',
+    'python-getpaid-core>=3.0.0a3',
     'httpx>=0.27.0',
 ]
 
@@ -45,6 +45,9 @@ Repository = 'https://github.com/django-getpaid/python-getpaid-payu'
 Documentation = 'https://getpaid-payu.readthedocs.io/'
 Changelog = 'https://github.com/django-getpaid/python-getpaid-payu/releases'
 
+[project.entry-points."getpaid.backends"]
+payu = 'getpaid_payu.processor:PayUProcessor'
+
 [build-system]
 requires = ['hatchling']
 build-backend = 'hatchling.build'
@@ -52,6 +55,9 @@ build-backend = 'hatchling.build'
 [tool.hatch.build.targets.wheel]
 packages = ['src/getpaid_payu']
 
+[tool.hatch.version]
+path = "src/getpaid_payu/__init__.py"
+
 [tool.pytest.ini_options]
 testpaths = ['tests']
 asyncio_mode = 'auto'

python_getpaid_payu-3.0.0a3/sandbox_keys.txt

@@ -0,0 +1,17 @@
+*** PLN Sandbox Keys ***
+POS ID (pos_id):                    300746
+Second key (MD5):                   b6ca15b0d1020e8094d9b5f8d163db54
+OAuth protocol - client_id:         300746
+OAuth protocol - client_secret:     2ee86a66e5d97e3fadc400c9f19b065d
+
+*** BGN Sandbox Keys ***
+POS ID (pos_id):                    404815
+Second key (MD5):                   87f410056e1ec5ff64f6bea777a0e694
+OAuth protocol - client_id:         404815
+OAuth protocol - client_secret:     89e263df5657cccfe7d1d2a0f50b6e41
+
+*** RON Sandbox Keys ***
+POS ID (pos_id):                    491057
+Second key (MD5):                   bac30a8686d9a31cbc9f3a25553e2f62
+OAuth protocol - client_id:         491057
+OAuth protocol - client_secret:     d807005b11ca38eea8a3c1a794635b4f

{python_getpaid_payu-0.1.0 → python_getpaid_payu-3.0.0a3}/src/getpaid_payu/__init__.py

@@ -9,4 +9,4 @@ __all__ = [
     "PayUProcessor",
 ]
 
-__version__ = "0.1.0"
+__version__ = "3.0.0a3"