Fees

Fees are fixed charges that complement usage-based billing. Use them for setup costs, platform access, recurring subscriptions, or any charge that doesn’t vary with consumption.

​

Fees vs Billable Metrics

Choose the right tool for the job: Use fees for:

• One-time setup or onboarding charges
• Monthly or annual platform fees
• License fees
• Support tier charges

Use billable metrics for:

• Token consumption
• Compute hours
• Storage usage
• Any metered resource

​

Fee Types

​

One-Time Fees

Charged once when a subscription activates. Perfect for:

• Setup fees - Cover onboarding costs
• Implementation charges - Custom integrations
• Activation fees - Initial account setup

One-time fees appear on the customer’s first invoice only.

​

Recurring Fees

Charged on a schedule throughout the subscription. Options include: Recurring fees are charged when the subscription starts and then on each billing cycle.

​

Payment Terms

Control when customers pay for fees.

​

Prepaid (In Advance)

The customer’s wallet balance is debited right away. As a merchant you receive the fees instantly. Best for:

• Risk management
• Smaller customers
• Self-serve signups

​

Postpaid (In Arrears)

Charges accumulate and appear on the next invoice. No immediate payment required. Best for:

• Enterprise contracts
• Established customers
• Sales-led deals

​

Creating Fees

Fees belong to a product. Create them in the Paygentic dashboard or via API.

​

Required Fields

• Name - Internal identifier (e.g., “Pro Monthly Fee”)
• Description - Explain what this fee covers
• Product - Which product this fee belongs to

​

Pricing Configuration

When adding a fee to a plan, configure:

• Unit Price - The fixed amount to charge (e.g., $50.00)
• Billing Cadence - How often to charge (one-time, monthly, yearly, etc.)
• Payment Term - When to collect (prepaid or postpaid)
• Invoice Display Name - What customers see on invoices

​

Adding Fees to Plans

Fees are attached to plans alongside metric prices. A single plan can include:

• Multiple fees (setup + monthly subscription)
• Fees and usage-based metrics together
• Different payment terms per fee

Example: SaaS Platform Plan

​

Fees on Invoices

Fees appear as line items on customer invoices with:

• The display name you configured
• The charge amount
• Applicable taxes (calculated automatically)

​

API Reference

Manage fees programmatically:

• POST /v0/fees - Create a new fee
• GET /v0/fees - List all fees
• GET /v0/fees/{id} - Get fee details
• PATCH /v0/fees/{id} - Update fee name/description

See the API Reference for complete documentation.

​

Next Steps

• Create plans to bundle fees with usage pricing
• Set up products to organize your offerings
• Configure prices for usage-based metrics