validpay 0.1.0__tar.gz

validpay-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MiLu Technologies LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

validpay-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: validpay
+Version: 0.1.0
+Summary: Official Python SDK for ValidPay — AI-powered document verification platform
+Project-URL: Homepage, https://validpay.io
+Project-URL: Documentation, https://validpay.io/docs
+Project-URL: Repository, https://github.com/ValidPay-io/validpay-python-sdk
+Project-URL: Issues, https://github.com/ValidPay-io/validpay-python-sdk/issues
+Author-email: MiLu Technologies LLC <mike@validpay.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: check-verification,document-verification,fintech,qr-code,validpay
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25.0
+Description-Content-Type: text/markdown
+
+# ValidPay Python SDK
+
+Official Python SDK for [ValidPay](https://validpay.io) — AI-powered document verification platform.
+
+> **Private Beta** — This SDK is currently in private beta. Contact mike@validpay.io for API access.
+
+## Installation
+
+```bash
+pip install validpay
+```
+
+## Quick Start
+
+```python
+from validpay import ValidPayClient
+
+client = ValidPayClient(api_key="your-api-key")
+
+# Verify a document image
+result = client.verify_document(image_path="check.png")
+print(result["status"])  # "authentic" or "unverified"
+
+# Decode a ValidPay QR code
+decoded = client.decode_qr(qr_data="validpay://...")
+print(decoded["document_type"])
+```
+
+## Features
+
+- Document verification via image upload
+- QR code decoding and validation
+- Check authenticity verification
+- Patent-pending AI-powered analysis
+
+## Requirements
+
+- Python 3.8+
+- Active ValidPay API key
+
+## Links
+
+- Website: https://validpay.io
+- Documentation: https://validpay.io/docs
+- Support: mike@validpay.io
+
+## License
+
+MIT — Copyright (c) 2026 MiLu Technologies LLC

validpay-0.1.0/README.md

@@ -0,0 +1,49 @@
+# ValidPay Python SDK
+
+Official Python SDK for [ValidPay](https://validpay.io) — AI-powered document verification platform.
+
+> **Private Beta** — This SDK is currently in private beta. Contact mike@validpay.io for API access.
+
+## Installation
+
+```bash
+pip install validpay
+```
+
+## Quick Start
+
+```python
+from validpay import ValidPayClient
+
+client = ValidPayClient(api_key="your-api-key")
+
+# Verify a document image
+result = client.verify_document(image_path="check.png")
+print(result["status"])  # "authentic" or "unverified"
+
+# Decode a ValidPay QR code
+decoded = client.decode_qr(qr_data="validpay://...")
+print(decoded["document_type"])
+```
+
+## Features
+
+- Document verification via image upload
+- QR code decoding and validation
+- Check authenticity verification
+- Patent-pending AI-powered analysis
+
+## Requirements
+
+- Python 3.8+
+- Active ValidPay API key
+
+## Links
+
+- Website: https://validpay.io
+- Documentation: https://validpay.io/docs
+- Support: mike@validpay.io
+
+## License
+
+MIT — Copyright (c) 2026 MiLu Technologies LLC

validpay-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "validpay"
+version = "0.1.0"
+description = "Official Python SDK for ValidPay — AI-powered document verification platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "MiLu Technologies LLC", email = "mike@validpay.io" }
+]
+keywords = ["validpay", "document-verification", "check-verification", "qr-code", "fintech"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial",
+    "Topic :: Security",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+Homepage = "https://validpay.io"
+Documentation = "https://validpay.io/docs"
+Repository = "https://github.com/ValidPay-io/validpay-python-sdk"
+Issues = "https://github.com/ValidPay-io/validpay-python-sdk/issues"

validpay-0.1.0/src/validpay/__init__.py

@@ -0,0 +1,15 @@
+"""
+ValidPay Python SDK — AI-powered document verification.
+
+Usage:
+    from validpay import ValidPayClient
+
+    client = ValidPayClient(api_key="your-api-key")
+    result = client.verify_document(image_path="check.png")
+"""
+
+__version__ = "0.1.0"
+
+from .client import ValidPayClient
+
+__all__ = ["ValidPayClient", "__version__"]

validpay-0.1.0/src/validpay/client.py

@@ -0,0 +1,95 @@
+"""ValidPay API client."""
+
+import requests
+from typing import Optional, Dict, Any
+
+
+class ValidPayClient:
+    """
+    Official ValidPay Python client for document verification.
+
+    This SDK is currently in private beta. Contact mike@validpay.io
+    for API access.
+
+    Usage:
+        from validpay import ValidPayClient
+
+        client = ValidPayClient(api_key="your-api-key")
+        result = client.verify_document(image_path="check.png")
+        print(result.status)  # "authentic" or "unverified"
+    """
+
+    BASE_URL = "https://api.validpay.io/v1"
+
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
+        """
+        Initialize the ValidPay client.
+
+        Args:
+            api_key: Your ValidPay API key (contact mike@validpay.io for access)
+            base_url: Optional custom API base URL
+        """
+        self.api_key = api_key
+        self.base_url = base_url or self.BASE_URL
+        self._session = requests.Session()
+        self._session.headers.update({
+            "Authorization": f"Bearer {api_key}",
+            "User-Agent": "validpay-python/0.1.0",
+        })
+
+    def verify_document(
+        self,
+        image_path: Optional[str] = None,
+        qr_data: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Verify a document using ValidPay's AI-powered verification.
+
+        Args:
+            image_path: Path to document image (PNG, JPG, or PDF)
+            qr_data: Raw QR code data string (alternative to image)
+
+        Returns:
+            Dictionary with verification result including status,
+            document_type, confidence, and extracted fields.
+
+        Raises:
+            NotImplementedError: SDK is in private beta.
+        """
+        raise NotImplementedError(
+            "ValidPay Python SDK is in private beta. "
+            "Contact mike@validpay.io for API access."
+        )
+
+    def decode_qr(self, qr_data: str) -> Dict[str, Any]:
+        """
+        Decode and verify a ValidPay QR code.
+
+        Args:
+            qr_data: The raw string data from a scanned QR code
+
+        Returns:
+            Dictionary with decoded document fields and verification status.
+
+        Raises:
+            NotImplementedError: SDK is in private beta.
+        """
+        raise NotImplementedError(
+            "ValidPay Python SDK is in private beta. "
+            "Contact mike@validpay.io for API access."
+        )
+
+    def get_status(self) -> Dict[str, Any]:
+        """
+        Check API connectivity and account status.
+
+        Returns:
+            Dictionary with API status and account info.
+
+        Raises:
+            NotImplementedError: SDK is in private beta.
+        """
+        raise NotImplementedError(
+            "ValidPay Python SDK is in private beta. "
+            "Contact mike@validpay.io for API access."
+        )