Python SDK

pip install esaalat

from esaalat import Esaalat

client = Esaalat(
    client_id="your-client-id",      # Your Esaalat client ID
    client_secret="your-client-secret",  # Your client secret
    base_url="https://api.esaalat.com",  # API base URL (api.sandbox.esaalat.com for sandbox)
    timeout=30  # Optional: request timeout in seconds
)

# Get all subscriptions
subscriptions = client.get_subscriptions()

# Filter for active subscriptions that can receive payments
active_subs = [s for s in subscriptions if s.is_active and s.can_receive]

# Use the first active subscription
if active_subs:
    subscription_id = active_subs[0].id
    print(f"Using: {active_subs[0].provider_name} - {active_subs[0].username}")

# Create an order with multiple items
order_id = client.create_order(
    subscription_id="f7430a9b-76c6-4c52-91c7-0337d8ca9e9c",
    items=[
        {
            "name": "T-Shirt",
            "description": "Premium cotton t-shirt",
            "price": 29.99,
            "quantity": 2
        },
        {
            "name": "Mug",
            "description": "Coffee mug",
            "price": 9.99,
            "quantity": 1
        }
    ],
    currency="USD"  # "USD" or "YER"
)

print(f"Order created: {order_id}")

from esaalat import (
    Esaalat,
    ValidationError,
    AuthenticationError,
    OrderNotFoundError,
    APIError
)

client = Esaalat(
    client_id="your-client-id",
    client_secret="your-client-secret",
    base_url="https://api.esaalat.com" # api.sandbox.esaalat.com for sandbox
)

try:
    order_id = client.create_order(
        subscription_id="invalid-id",
        items=[
            {
                "name": "Product",
                "description": "Description",
                "price": -10.50,  # Invalid: negative price
                "quantity": 1
            }
        ],
        currency="USD"
    )
except ValidationError as e:
    print(f"Validation error: {e}")
    # Handle invalid input
except AuthenticationError as e:
    print(f"Authentication failed: {e}")
    # Handle auth issues
except OrderNotFoundError as e:
    print(f"Order not found: {e}")
    # Handle missing order
except APIError as e:
    print(f"API error: {e}")
    print(f"Status code: {e.status_code}")
    # Handle API errors
except Exception as e:
    print(f"Unexpected error: {e}")
    # Handle other errors

from esaalat import Esaalat, OrderItem

# Initialize client
client = Esaalat(
    client_id="your-client-id",
    client_secret="your-client-secret",
    base_url="https://api.esaalat.com" # api.sandbox.esaalat.com for sandbox
)

# 1. Get active subscriptions
subscriptions = client.get_subscriptions()
active_sub = next((s for s in subscriptions if s.is_active and s.can_receive), None)

if not active_sub:
    print("No active subscriptions available")
    exit(1)

print(f"Using subscription: {active_sub.provider_name}")

# 2. Create order with shopping cart items
cart_items = [
    OrderItem(
        name="Premium T-Shirt",
        description="100% cotton, size L",
        price=29.99,
        quantity=2
    ),
    OrderItem(
        name="Coffee Mug",
        description="Ceramic mug, 350ml",
        price=9.99,
        quantity=1
    )
]

order_id = client.create_order(
    subscription_id=active_sub.id,
    items=cart_items,
    currency="USD"
)

print(f"Order created: {order_id}")

# 3. Check order status
order = client.get_order(order_id)

if order.status == "COMPLETED":
    print("✓ Payment received!")
    print(f"Total: {order.total} {order.currency}")
elif order.status == "PENDING":
    print("⏳ Waiting for payment...")
else:
    print(f"Status: {order.status}")