Customer Deposits

from paymanai import Paymanai

client = Paymanai(
    x_payman_api_secret=os.getenv("PAYMAN_API_SECRET"),
    environment="sandbox"
)

response = client.payments.initiate_customer_deposit(
    amount_decimal=10.0,    # required - $10.00 for USD, or 1.000000 for USDC
    customer_id="cust_123", # required - your system's customer ID
    customer_email="[email protected]",  # optional
    customer_name="Jane Smith",         # optional
    memo="Wallet deposit"              # optional
)

# response.checkout_url contains the payment link
print(response.checkout_url)

{
    "checkout_url": "https://app.paymanai.com/checkout..."
}

from typing import Optional, Dict
from paymanai.types import CheckoutResponse

def create_deposit_link(
    amount: float,
    customer_id: str,
    customer_email: Optional[str] = None,
    metadata: Optional[Dict[str, any]] = None
) -> CheckoutResponse:
    return client.payments.initiate_customer_deposit(
        amount_decimal=amount,
        customer_id=customer_id,
        customer_email=customer_email,
        metadata=metadata
    )

# Example usage with error handling
try:
    response = create_deposit_link(
        amount=50.0,
        customer_id="cust_123",
        customer_email="[email protected]"
    )
    print(f"Checkout URL: {response.checkout_url}")
except PaymanError as e:
    print(f"Failed to create deposit link: {e.message}")

# Example with metadata and fee mode
deposit = client.payments.initiate_customer_deposit(
    amount_decimal=100.0,
    customer_id="cust_123",
    fee_mode="ADD_TO_AMOUNT",
    metadata={
        "source": "api",
        "project_id": "proj_456",
        "department": "sales"
    }
)