Quick Start

Get started with Paygent in less than 5 minutes. Choose your SDK and start tracking AI usage immediately.

Step 1 — Get Your API Key

Sign up at withpaygent.com and get your API key from the dashboard.

Step 2 — Install the SDK

$
pip install paygent-sdk

Step 3 — Set up Agents and Indicators

Define your AI agents and the indicators (actions) they’ll track in the Paygent dashboard. For example, create a chatbot-agent agent and a message-sent indicator.

Creating an Agent

Step 1: Go to Paygent dashboard and click on “Create Agent”

Step 2: Give agent name and external ID. External ID is important, Select other agent

Step 3: Create indicators. Indicators can be activity-based or outcome-based

Step 4: Define your pricing. For example, in the image it’s $2 per call

Step 5: Your agent is created successfully!

Creating a Customer

Step 1: Click on “Create Customer”

Step 2: Define customer and external ID. Tip: Always use your database customer ID as external ID

Step 3: Customer is created successfully!

Step 4 — Send Your First Usage Data

1
import paygent_sdk
2
from openai import OpenAI
3
4
# 1. Initialize Paygent (Automatic Tracking)
5
paygent_sdk.init(api_key="your-paygent-api-key")
6
7
# 2. Use your LLM client normally
8
client = OpenAI(api_key="your-openai-api-key")
9
10
# 3. Add paygent_* kwargs to track usage
11
response = client.chat.completions.create(
12
    model="gpt-4o",
13
    messages=[{"role": "user", "content": "Hello!"}],
14
    
15
    # Paygent tracking parameters
16
    paygent_agent_id="chatbot-agent",
17
    paygent_customer_id="customer-123",
18
    paygent_indicator="message-sent"
19
)
20
21
print(response.choices[0].message.content)

Step 5 — Create an Order (enable billing)

Usage tracking alone does not invoice customers. Create an order to start automatic billing:

1. Orders → Create Order
2. Select your customer and set billing day / payment terms
3. Add line → pick your agent (optional: select a Plan)
4. Click Done, then open the order and click Activate

Only active orders generate invoices on the billing schedule.

Step 6 — Monitor & Bill

View real-time usage in Dashboard → Agent Analytics. On each billing day, Paygent generates itemized invoices from usage, subscription fees, external costs, and taxes.

Send the invoice PDF, generate a Stripe payment link, or mark as paid to release pending wallet credits.