payplus-python 0.1.2__py3-none-any.whl → 0.2.1__py3-none-any.whl

examples/subscription_saas.py

@@ -8,7 +8,7 @@ from decimal import Decimal
 
 from payplus import PayPlus, SubscriptionManager
 from payplus.subscriptions.storage import MongoDBStorage
-from payplus.subscriptions import BillingService
+from payplus.webhooks import WebhookHandler
 
 
 async def main():
@@ -18,7 +18,7 @@ async def main():
         secret_key=os.environ.get("PAYPLUS_SECRET_KEY", "your_secret_key"),
         sandbox=True,
     )
-    
+
     # Setup MongoDB storage
     try:
         from motor.motor_asyncio import AsyncIOMotorClient
@@ -28,33 +28,19 @@ async def main():
     except ImportError:
         print("MongoDB not available, using in-memory storage")
         storage = None
-    
+
     # Create subscription manager
     manager = SubscriptionManager(client, storage)
-    
+
     # Register event handlers
-    manager.on("subscription.created", lambda s: print(f"✅ Subscription created: {s.id}"))
-    manager.on("subscription.activated", lambda s: print(f"🎉 Subscription activated: {s.id}"))
-    manager.on("payment.succeeded", lambda p: print(f"💰 Payment received: {p.amount} {p.currency}"))
-    manager.on("payment.failed", lambda p: print(f"❌ Payment failed: {p.failure_message}"))
-    
+    manager.on("subscription.created", lambda s: print(f"Subscription created: {s.id}"))
+    manager.on("subscription.activated", lambda s: print(f"Subscription activated: {s.id}"))
+    manager.on("subscription.renewed", lambda s: print(f"Subscription renewed: {s.id}"))
+    manager.on("subscription.payment_failed", lambda s: print(f"Payment failed for: {s.id}"))
+
     # ==================== Setup Pricing Tiers ====================
-    print("\n📦 Creating pricing tiers...")
-    
-    # Free tier
-    free_tier = await manager.create_tier(
-        tier_id="free",
-        name="Free",
-        price=Decimal("0"),
-        features=[
-            {"feature_id": "projects", "name": "Projects", "included_quantity": 3},
-            {"feature_id": "storage_gb", "name": "Storage (GB)", "included_quantity": 1},
-            {"feature_id": "team_members", "name": "Team Members", "included_quantity": 1},
-        ],
-    )
-    print(f"  - {free_tier.name}: ₪{free_tier.price}/month")
-    
-    # Basic tier
+    print("\nCreating pricing tiers...")
+
     basic_tier = await manager.create_tier(
         tier_id="basic",
         name="Basic",
@@ -64,141 +50,100 @@ async def main():
             {"feature_id": "projects", "name": "Projects", "included_quantity": 10},
             {"feature_id": "storage_gb", "name": "Storage (GB)", "included_quantity": 10},
             {"feature_id": "team_members", "name": "Team Members", "included_quantity": 5},
-            {"feature_id": "api_access", "name": "API Access"},
         ],
     )
-    print(f"  - {basic_tier.name}: ₪{basic_tier.price}/month (7-day trial)")
-    
-    # Pro tier
+    print(f"  - {basic_tier.name}: ILS {basic_tier.price}/month (7-day trial)")
+
     pro_tier = await manager.create_tier(
         tier_id="pro",
         name="Pro",
         price=Decimal("79"),
         trial_days=14,
         is_popular=True,
-        annual_discount_percent=Decimal("20"),
         features=[
-            {"feature_id": "projects", "name": "Projects", "included_quantity": None},  # Unlimited
+            {"feature_id": "projects", "name": "Projects", "included_quantity": None},
             {"feature_id": "storage_gb", "name": "Storage (GB)", "included_quantity": 100},
             {"feature_id": "team_members", "name": "Team Members", "included_quantity": 20},
             {"feature_id": "api_access", "name": "API Access"},
             {"feature_id": "priority_support", "name": "Priority Support"},
-            {"feature_id": "custom_domain", "name": "Custom Domain"},
-        ],
-    )
-    print(f"  - {pro_tier.name}: ₪{pro_tier.price}/month (14-day trial, 20% annual discount)")
-    
-    # Enterprise tier
-    enterprise_tier = await manager.create_tier(
-        tier_id="enterprise",
-        name="Enterprise",
-        price=Decimal("199"),
-        annual_discount_percent=Decimal("25"),
-        features=[
-            {"feature_id": "projects", "name": "Projects", "included_quantity": None},
-            {"feature_id": "storage_gb", "name": "Storage (GB)", "included_quantity": None},
-            {"feature_id": "team_members", "name": "Team Members", "included_quantity": None},
-            {"feature_id": "api_access", "name": "API Access"},
-            {"feature_id": "priority_support", "name": "Priority Support"},
-            {"feature_id": "custom_domain", "name": "Custom Domain"},
-            {"feature_id": "sso", "name": "SSO Integration"},
-            {"feature_id": "dedicated_support", "name": "Dedicated Account Manager"},
         ],
     )
-    print(f"  - {enterprise_tier.name}: ₪{enterprise_tier.price}/month (25% annual discount)")
-    
+    print(f"  - {pro_tier.name}: ILS {pro_tier.price}/month (14-day trial)")
+
     # ==================== Create Customer ====================
-    print("\n👤 Creating customer...")
-    
+    print("\nCreating customer...")
+
     customer = await manager.create_customer(
         email="demo@example.com",
         name="Demo User",
-        metadata={"source": "signup_form", "campaign": "launch_2024"},
     )
     print(f"  Customer ID: {customer.id}")
-    print(f"  Email: {customer.email}")
-    
-    # ==================== Add Payment Method ====================
-    print("\n💳 Adding payment method...")
-    
-    # In production, this token comes from a PayPlus payment page
-    # For demo, we'll simulate with a fake token
-    demo_token = "demo_card_token_xxx"
-    
-    payment_method = await manager.add_payment_method(
-        customer_id=customer.id,
-        token=demo_token,
-        card_brand="Visa",
-        last_four="4242",
-        expiry_month="12",
-        expiry_year="2028",
-    )
-    print(f"  Payment Method: {payment_method.card_brand} ****{payment_method.last_four}")
-    
+
     # ==================== Create Subscription ====================
-    print("\n📋 Creating Pro subscription...")
-    
+    print("\nCreating Pro subscription (generates payment link)...")
+
     subscription = await manager.create_subscription(
         customer_id=customer.id,
         tier_id="pro",
+        callback_url="https://example.com/webhooks/payplus",
+        success_url="https://example.com/success",
+        failure_url="https://example.com/failure",
     )
-    
+
     print(f"  Subscription ID: {subscription.id}")
-    print(f"  Status: {subscription.status}")
-    print(f"  Amount: ₪{subscription.amount}/month")
-    print(f"  Trial ends: {subscription.trial_end}")
-    print(f"  Current period: {subscription.current_period_start} - {subscription.current_period_end}")
-    
+    print(f"  Status: {subscription.status}")  # INCOMPLETE until customer pays
+    print(f"  Amount: ILS {subscription.amount}/month")
+    print(f"  Payment link: {subscription.payment_page_link}")
+    print(f"  -> Redirect customer to this link to complete payment")
+
+    # ==================== Webhook Handling ====================
+    # In production, this happens when PayPlus sends a webhook after the customer pays.
+    # The webhook handler + manager.handle_webhook_event() updates the subscription:
+    #
+    # webhook_handler = WebhookHandler(client)
+    #
+    # @webhook_handler.on("payment.success")
+    # async def on_payment(event):
+    #     sub = await manager.handle_webhook_event(event)
+    #     if sub:
+    #         print(f"Subscription {sub.id} is now {sub.status}")
+    #
+    # @webhook_handler.on("recurring.charged")
+    # async def on_renewal(event):
+    #     await manager.handle_webhook_event(event)
+    #
+    # @webhook_handler.on("recurring.failed")
+    # async def on_failure(event):
+    #     await manager.handle_webhook_event(event)
+
     # ==================== Subscription Operations ====================
-    print("\n⚙️ Subscription operations...")
-    
-    # Check if active
-    print(f"  Is active: {subscription.is_active}")
-    print(f"  Is trialing: {subscription.is_trialing}")
-    
-    # Upgrade to enterprise
-    print("\n  📈 Upgrading to Enterprise...")
-    subscription = await manager.change_tier(subscription.id, "enterprise")
-    print(f"  New tier: {subscription.tier_id}")
-    print(f"  New amount: ₪{subscription.amount}/month")
-    
-    # Pause subscription
-    print("\n  ⏸️ Pausing subscription...")
+    print("\nSubscription operations...")
+
+    # Upgrade to basic (while still incomplete, for demo)
+    print("\n  Upgrading tier...")
+    subscription = await manager.change_tier(subscription.id, "basic")
+    print(f"  New tier: {subscription.tier_id}, amount: ILS {subscription.amount}")
+
+    # Pause
+    print("\n  Pausing subscription...")
     subscription = await manager.pause_subscription(subscription.id)
     print(f"  Status: {subscription.status}")
-    
-    # Resume subscription
-    print("\n  ▶️ Resuming subscription...")
+
+    # Resume
+    print("\n  Resuming subscription...")
     subscription = await manager.resume_subscription(subscription.id)
     print(f"  Status: {subscription.status}")
-    
+
     # Cancel at period end
-    print("\n  🚫 Scheduling cancellation...")
+    print("\n  Scheduling cancellation...")
     subscription = await manager.cancel_subscription(
         subscription.id,
         at_period_end=True,
         reason="Demo completed",
     )
-    print(f"  Will cancel at: {subscription.current_period_end}")
     print(f"  Cancellation reason: {subscription.cancellation_reason}")
-    
-    # ==================== Billing Service ====================
-    print("\n💵 Billing service...")
-    
-    billing = BillingService(manager)
-    
-    # In production, these would run on a schedule
-    print("  Processing due renewals...")
-    renewed = await billing.process_due_renewals()
-    print(f"  Renewed: {len(renewed)} subscriptions")
-    
-    print("  Processing trial endings...")
-    converted = await billing.process_trial_endings()
-    print(f"  Converted: {len(converted)} trials")
-    
-    print("\n✅ Demo completed!")
-    
-    # Cleanup
+
+    print("\nDemo completed!")
     client.close()
 
 

payplus/__init__.py

@@ -3,18 +3,16 @@ PayPlus Python SDK - Payment gateway integration with subscription management fo
 """
 
 from payplus.client import PayPlus
-from payplus.subscriptions.manager import SubscriptionManager
+from payplus.models.customer import Customer
 from payplus.models.subscription import (
+    BillingCycle,
     Subscription,
     SubscriptionStatus,
-    BillingCycle,
 )
-from payplus.models.customer import Customer
-from payplus.models.payment import Payment, PaymentStatus
-from payplus.models.invoice import Invoice, InvoiceStatus
 from payplus.models.tier import Tier
+from payplus.subscriptions.manager import SubscriptionManager
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 __all__ = [
     "PayPlus",
     "SubscriptionManager",
@@ -22,9 +20,5 @@ __all__ = [
     "SubscriptionStatus",
     "BillingCycle",
     "Customer",
-    "Payment",
-    "PaymentStatus",
-    "Invoice",
-    "InvoiceStatus",
     "Tier",
 ]

payplus/api/customers.py

@@ -0,0 +1,114 @@
+"""
+PayPlus Customers API.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from payplus.api.base import BaseAPI
+
+
+class CustomersAPI(BaseAPI):
+    """
+    Customers API for creating and managing customers on PayPlus.
+    """
+
+    def add(
+        self,
+        customer_name: str,
+        email: str,
+        phone: Optional[str] = None,
+        vat_number: Optional[int] = None,
+        paying_vat: bool = True,
+        customer_number: Optional[str] = None,
+        notes: Optional[str] = None,
+        contacts: Optional[list[dict[str, Any]]] = None,
+        business_address: Optional[str] = None,
+        business_city: Optional[str] = None,
+        business_postal_code: Optional[str] = None,
+        business_country_iso: str = "IL",
+        subject_code: Optional[str] = None,
+        communication_email: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        """
+        Create a new customer on PayPlus.
+
+        Args:
+            customer_name: Customer name (required)
+            email: Customer email (required)
+            phone: Customer phone number
+            vat_number: Customer or company VAT number
+            paying_vat: Whether customer pays VAT
+            customer_number: Internal customer number
+            notes: Notes about the customer
+            contacts: List of contact dicts
+            business_address: Business address
+            business_city: Business city
+            business_postal_code: Business postal code
+            business_country_iso: Business country code (default: IL)
+            subject_code: External customer number from ERP
+            communication_email: Email for communication
+
+        Returns:
+            API response with customer_uid in data
+        """
+        data: dict[str, Any] = {
+            "customer_name": customer_name,
+            "email": email,
+            "paying_vat": paying_vat,
+        }
+
+        if phone is not None:
+            data["phone"] = phone
+        if vat_number is not None:
+            data["vat_number"] = vat_number
+        if customer_number is not None:
+            data["customer_number"] = customer_number
+        if notes is not None:
+            data["notes"] = notes
+        if contacts is not None:
+            data["contacts"] = contacts
+        if business_address is not None:
+            data["business_address"] = business_address
+        if business_city is not None:
+            data["business_city"] = business_city
+        if business_postal_code is not None:
+            data["business_postal_code"] = business_postal_code
+        if business_country_iso != "IL":
+            data["business_country_iso"] = business_country_iso
+        if subject_code is not None:
+            data["subject_code"] = subject_code
+        if communication_email is not None:
+            data["communication_email"] = communication_email
+
+        for key, value in kwargs.items():
+            if key not in data and value is not None:
+                data[key] = value
+
+        return self._request("POST", "Customers/Add", data)
+
+    async def async_add(
+        self,
+        customer_name: str,
+        email: str,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        """Async version of add."""
+        data: dict[str, Any] = {
+            "customer_name": customer_name,
+            "email": email,
+            "paying_vat": kwargs.pop("paying_vat", True),
+        }
+
+        if kwargs.get("phone") is not None:
+            data["phone"] = kwargs.pop("phone")
+        if kwargs.get("vat_number") is not None:
+            data["vat_number"] = kwargs.pop("vat_number")
+
+        for key, value in kwargs.items():
+            if key not in data and value is not None:
+                data[key] = value
+
+        return await self._async_request("POST", "Customers/Add", data)