nelsius-pay 1.0.0__tar.gz

nelsius_pay-1.0.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: nelsius-pay
+Version: 1.0.0
+Summary: Official Python SDK for the Nelsius Developer API
+Author-email: Nelson Siebi <nelsonsiebi237@gmail.com>
+Project-URL: Homepage, https://nelsius.com
+Project-URL: Bug Tracker, https://github.com/nelson-siebi/nelsius-pay-python/issues
+Project-URL: Source, https://github.com/nelson-siebi/nelsius-pay-python
+Keywords: nelsius,payments,sdk,api
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# Nelsius Python SDK
+
+Official Python SDK for the [Nelsius Developer API](https://nelsius.com/api-doc).
+
+## Installation
+
+```bash
+pip install nelsius-pay
+```
+
+## Quick Start
+
+```python
+from nelsius import Nelsius
+
+# Initialize the client
+nelsius = Nelsius('your_secret_key', {
+    'verify_ssl': False  # Set to False for local development
+})
+
+# 1. Get available payment methods
+methods = nelsius.methods('CM', 'XAF')
+print("Available methods:", methods)
+
+# 2. Create a Checkout Session
+session = nelsius.checkout.create_session({
+    'amount': 5000,
+    'currency': 'XAF',
+    'reference': 'ORDER_12345',
+    'return_url': 'https://yoursite.com/success',
+    'customer': {
+        'email': 'client@example.com',
+        'name': 'Jean Dupont'
+    }
+})
+
+if session.get('success'):
+    print("Checkout URL:", session['data']['checkout_url'])
+
+# 3. Direct Charge (Mobile Money)
+charge = nelsius.charge.create({
+    'amount': 2000,
+    'currency': 'XAF',
+    'payment_method': 'orange_money_cm',
+    'phone': '690000000',
+    'reference': 'REF_999'
+})
+print("Charge Result:", charge)
+```
+
+## Documentation
+
+For full details on the parameters and responses, visit the [official documentation](https://nelsius.com/docs).

nelsius_pay-1.0.0/README.md

@@ -0,0 +1,53 @@
+# Nelsius Python SDK
+
+Official Python SDK for the [Nelsius Developer API](https://nelsius.com/api-doc).
+
+## Installation
+
+```bash
+pip install nelsius-pay
+```
+
+## Quick Start
+
+```python
+from nelsius import Nelsius
+
+# Initialize the client
+nelsius = Nelsius('your_secret_key', {
+    'verify_ssl': False  # Set to False for local development
+})
+
+# 1. Get available payment methods
+methods = nelsius.methods('CM', 'XAF')
+print("Available methods:", methods)
+
+# 2. Create a Checkout Session
+session = nelsius.checkout.create_session({
+    'amount': 5000,
+    'currency': 'XAF',
+    'reference': 'ORDER_12345',
+    'return_url': 'https://yoursite.com/success',
+    'customer': {
+        'email': 'client@example.com',
+        'name': 'Jean Dupont'
+    }
+})
+
+if session.get('success'):
+    print("Checkout URL:", session['data']['checkout_url'])
+
+# 3. Direct Charge (Mobile Money)
+charge = nelsius.charge.create({
+    'amount': 2000,
+    'currency': 'XAF',
+    'payment_method': 'orange_money_cm',
+    'phone': '690000000',
+    'reference': 'REF_999'
+})
+print("Charge Result:", charge)
+```
+
+## Documentation
+
+For full details on the parameters and responses, visit the [official documentation](https://nelsius.com/docs).

nelsius_pay-1.0.0/nelsius/__init__.py

@@ -0,0 +1 @@
+from .client import Nelsius

nelsius_pay-1.0.0/nelsius/cli.py

@@ -0,0 +1,63 @@
+import argparse
+import sys
+import json
+from .client import Nelsius
+
+def main():
+    parser = argparse.ArgumentParser(description="Nelsius Pay CLI - Interface ligne de commande officielle")
+    parser.add_argument('--key', help="Votre Secret Key (ou utilise la variable d'environnement NELSIUS_SECRET_KEY)")
+    
+    subparsers = parser.add_subparsers(dest='command', help='Commandes disponibles')
+
+    # Commande Balance
+    subparsers.add_parser('balance', help='Consulter votre solde')
+
+    # Commande Methods
+    method_parser = subparsers.add_parser('methods', help='Lister les méthodes de paiement')
+    method_parser.add_argument('--country', default='CM', help='Code pays (ex: CM, CI)')
+    method_parser.add_argument('--currency', default='XAF', help='Code devise (ex: XAF, XOF)')
+
+    # Commande Checkout
+    checkout_parser = subparsers.add_parser('checkout', help='Créer une session de paiement')
+    checkout_parser.add_argument('--amount', type=int, required=True, help='Montant')
+    checkout_parser.add_argument('--currency', default='XAF', help='Devise')
+    checkout_parser.add_argument('--ref', required=True, help='Référence unique')
+
+    args = parser.parse_args()
+
+    # Récupération de la clé
+    import os
+    secret_key = args.key or os.environ.get('NELSIUS_SECRET_KEY')
+    
+    if not secret_key:
+        print("Erreur: Clé secrète manquante. Utilisez --key ou positionnez la variable d'environement NELSIUS_SECRET_KEY.")
+        sys.exit(1)
+
+    client = Nelsius(secret_key)
+
+    try:
+        if args.command == 'balance':
+            result = client.balance.retrieve()
+            print(json.dumps(result, indent=2))
+        
+        elif args.command == 'methods':
+            result = client.methods(args.country, args.currency)
+            print(json.dumps(result, indent=2))
+            
+        elif args.command == 'checkout':
+            result = client.checkout.create_session({
+                'amount': args.amount,
+                'currency': args.currency,
+                'reference': args.ref,
+                'return_url': 'https://example.com/success'
+            })
+            print(json.dumps(result, indent=2))
+        else:
+            parser.print_help()
+            
+    except Exception as e:
+        print(f"Erreur lors de l'exécution : {str(e)}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

nelsius_pay-1.0.0/nelsius/client.py

@@ -0,0 +1,61 @@
+import requests
+from .managers.checkout import CheckoutManager
+from .managers.charge import ChargeManager
+from .managers.balance import BalanceManager
+
+class Nelsius:
+    """
+    Nelsius Pay Python SDK Client
+    """
+    def __init__(self, secret_key, options=None):
+        self.secret_key = secret_key
+        self.options = options or {}
+        self.base_url = self.options.get('base_url', 'https://api.nelsius.com')
+        self.verify_ssl = self.options.get('verify_ssl', True)
+        
+        # Initialize Managers
+        self.checkout = CheckoutManager(self)
+        self.charge = ChargeManager(self)
+        self.balance = BalanceManager(self)
+
+    def request(self, method, endpoint, data=None, params=None):
+        url = f"{self.base_url.rstrip('/')}/{endpoint.lstrip('/')}"
+        
+        headers = {
+            'Authorization': f'Bearer {self.secret_key}',
+            'Accept': 'application/json',
+            'Content-Type': 'application/json',
+            'X-SDK-Platform': 'python'
+        }
+        
+        try:
+            response = requests.request(
+                method=method,
+                url=url,
+                json=data,
+                params=params,
+                headers=headers,
+                verify=self.verify_ssl
+            )
+            
+            # Simple error handling (matching Node.js/PHP behavior)
+            return response.json()
+            
+        except requests.exceptions.RequestException as e:
+            return {
+                'success': False,
+                'message': f'Request failed: {str(e)}',
+                'error': str(e)
+            }
+
+    def methods(self, country=None, currency=None):
+        """
+        Get available payment methods
+        """
+        params = {}
+        if country:
+            params['country'] = country
+        if currency:
+            params['currency'] = currency
+            
+        return self.request('GET', '/api/v1/payment-methods', params=params)

nelsius_pay-1.0.0/nelsius/managers/__init__.py

@@ -0,0 +1 @@
+# Managers package

nelsius_pay-1.0.0/nelsius/managers/balance.py

@@ -0,0 +1,9 @@
+class BalanceManager:
+    def __init__(self, client):
+        self.client = client
+
+    def retrieve(self):
+        """
+        Get merchant balance
+        """
+        return self.client.request('GET', '/api/v1/balance')

nelsius_pay-1.0.0/nelsius/managers/charge.py

@@ -0,0 +1,15 @@
+class ChargeManager:
+    def __init__(self, client):
+        self.client = client
+
+    def create(self, data):
+        """
+        Initiate a direct charge (Mobile Money, etc.)
+        """
+        return self.client.request('POST', '/api/v1/charges', data=data)
+
+    def retrieve(self, charge_id):
+        """
+        Retrieve a charge status
+        """
+        return self.client.request('GET', f'/api/v1/charges/{charge_id}')

nelsius_pay-1.0.0/nelsius/managers/checkout.py

@@ -0,0 +1,15 @@
+class CheckoutManager:
+    def __init__(self, client):
+        self.client = client
+
+    def create_session(self, data):
+        """
+        Create a hosted checkout session
+        """
+        return self.client.request('POST', '/api/v1/checkout/sessions', data=data)
+
+    def retrieve(self, session_id):
+        """
+        Retrieve a checkout session status
+        """
+        return self.client.request('GET', f'/api/v1/checkout/sessions/{session_id}')

nelsius_pay-1.0.0/nelsius_pay.egg-info/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: nelsius-pay
+Version: 1.0.0
+Summary: Official Python SDK for the Nelsius Developer API
+Author-email: Nelson Siebi <nelsonsiebi237@gmail.com>
+Project-URL: Homepage, https://nelsius.com
+Project-URL: Bug Tracker, https://github.com/nelson-siebi/nelsius-pay-python/issues
+Project-URL: Source, https://github.com/nelson-siebi/nelsius-pay-python
+Keywords: nelsius,payments,sdk,api
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# Nelsius Python SDK
+
+Official Python SDK for the [Nelsius Developer API](https://nelsius.com/api-doc).
+
+## Installation
+
+```bash
+pip install nelsius-pay
+```
+
+## Quick Start
+
+```python
+from nelsius import Nelsius
+
+# Initialize the client
+nelsius = Nelsius('your_secret_key', {
+    'verify_ssl': False  # Set to False for local development
+})
+
+# 1. Get available payment methods
+methods = nelsius.methods('CM', 'XAF')
+print("Available methods:", methods)
+
+# 2. Create a Checkout Session
+session = nelsius.checkout.create_session({
+    'amount': 5000,
+    'currency': 'XAF',
+    'reference': 'ORDER_12345',
+    'return_url': 'https://yoursite.com/success',
+    'customer': {
+        'email': 'client@example.com',
+        'name': 'Jean Dupont'
+    }
+})
+
+if session.get('success'):
+    print("Checkout URL:", session['data']['checkout_url'])
+
+# 3. Direct Charge (Mobile Money)
+charge = nelsius.charge.create({
+    'amount': 2000,
+    'currency': 'XAF',
+    'payment_method': 'orange_money_cm',
+    'phone': '690000000',
+    'reference': 'REF_999'
+})
+print("Charge Result:", charge)
+```
+
+## Documentation
+
+For full details on the parameters and responses, visit the [official documentation](https://nelsius.com/docs).

nelsius_pay-1.0.0/nelsius_pay.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+nelsius/__init__.py
+nelsius/cli.py
+nelsius/client.py
+nelsius/managers/__init__.py
+nelsius/managers/balance.py
+nelsius/managers/charge.py
+nelsius/managers/checkout.py
+nelsius_pay.egg-info/PKG-INFO
+nelsius_pay.egg-info/SOURCES.txt
+nelsius_pay.egg-info/dependency_links.txt
+nelsius_pay.egg-info/entry_points.txt
+nelsius_pay.egg-info/requires.txt
+nelsius_pay.egg-info/top_level.txt

nelsius_pay-1.0.0/nelsius_pay.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nelsius_pay-1.0.0/nelsius_pay.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nelsius-pay = nelsius.cli:main

nelsius_pay-1.0.0/nelsius_pay.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

nelsius_pay-1.0.0/nelsius_pay.egg-info/top_level.txt

@@ -0,0 +1 @@
+nelsius

nelsius_pay-1.0.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nelsius-pay"
+version = "1.0.0"
+authors = [
+  { name="Nelson Siebi", email="nelsonsiebi237@gmail.com" },
+]
+description = "Official Python SDK for the Nelsius Developer API"
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "requests>=2.25.0",
+]
+keywords = ["nelsius", "payments", "sdk", "api"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+"Homepage" = "https://nelsius.com"
+"Bug Tracker" = "https://github.com/nelson-siebi/nelsius-pay-python/issues"
+"Source" = "https://github.com/nelson-siebi/nelsius-pay-python"
+
+[project.scripts]
+nelsius-pay = "nelsius.cli:main"

nelsius_pay-1.0.0/setup.cfg

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