Metadata-Version: 2.4
Name: famapi-verify
Version: 0.2.0
Summary: FamAPI Verify API — Python SDK
Home-page: https://provider.akiru.online
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Dynamic: home-page
Dynamic: requires-python

# FamAPI Verify — Python SDK

```bash
pip install famapi-verify
```

## Usage

### Payment API (api_key from dashboard)

```python
from famapi import FamAPI

client = FamAPI(api_key="your_api_key_here")

payment = client.create_payment(amount=100)
print(payment["purpose"], payment["qr_image_url"])

result = client.verify_payment(purpose=payment["purpose"])
print(result["status"], result["message"])

client.complete_payment(purpose=payment["purpose"])

payments = client.get_payments(status="pending", limit=10)

time_info = client.get_payment_time(purpose=payment["purpose"])

csv = client.export_payments()
```

### Session API (access_token from browser dev tools)

Get your Supabase access_token from your browser's Application → Local Storage → `sb-kqmmbjtlaixncqlldgqo-auth-token` → copy the `access_token` field.

```python
client = FamAPI(session_token="your_supabase_access_token")

data = client.get_dashboard_data()
usage = client.get_dashboard_usage()
logs = client.get_webhook_logs()

client.create_subscription(plan="starter")
client.verify_subscription(purpose="SUB_...")

status = client.get_gmail_status()
client.disconnect_gmail()

new_key = client.reset_api_key()
result = client.update_settings(webhook_url="https://example.com/hook")
```

### Webhook endpoint

```python
client = FamAPI(webhook_secret="your_webhook_secret")

result = client.handle_webhook_payment_verified(purpose="FAM_...")
```
