Changelog

​

Migration: billingInterval → billingCadence

​

Mapping

​

Input (create/update plan)

• New: send billingCadence: "P3M" for quarterly billing
• The old billingInterval field is still accepted for backwards compatibility
• When both are provided, billingCadence takes precedence

​

Output (plan response)

• Both fields are present in responses during the deprecation window
• billingCadence is the source of truth (ISO 8601 duration)
• billingInterval is derived from billingCadence and marked deprecated

​

SDK update

​

Revenue Analytics

• New revenue dashboard for billing v1 — visualize revenue by hour, day, or as a cumulative total
• Drill into revenue by customer or subscription, and track financials from a single consolidated view

​

Payment Links

• Payment links can now be created and managed directly from the dashboard
• Supports line items, customer assignment, and status tracking

​

Payments API

• New Payments API to process payments programmatically
• Subscribe to payment lifecycle events via webhooks

​

Grants API

• Manage grants mid-cycle: create, list, retrieve, and void grants on any entitlement via REST
  • POST /v1/entitlements/{entitlementId}/grants
  • GET /v1/entitlements/{entitlementId}/grants
  • DELETE /v1/entitlements/{entitlementId}/grants/{grantId}
• Grant purchase and direct creation are now available in the public API and SDK

​

Webhooks

• New invoice.issued.v0 webhook event fires when an invoice is issued

​

API

• New endpoint to manually create line items on an invoice
• listCustomers now supports filtering by name and email

​

Platform

• Duplicate any plan (including all its prices) from the plan actions menu
• New usage onboarding flow with a metric wizard for usage-based plan setup
• Customers list now paginates for large customer counts

​

Python SDK

• Official Paygentic Python SDK now available, powered by Speakeasy
• Full parity with the TypeScript SDK for all API interactions

​

Metered Entitlements

• Metered entitlements now supported — charge customers based on actual usage of features
• Metered line items automatically collected and synced to invoices on your billing schedule
• New GET /v2/invoices/lineItems endpoint to retrieve detailed line item breakdowns per invoice
• SDK updated to support metered entitlements and subscription-scoped entitlement listing

​

API Enhancements

​

Currencies

• Added support for GBP and AUD as merchant billing currencies

​

Customers

• New endpoint to delete customers — historical data is preserved

​

Billing Metrics

• Billable metric meter endpoint now available in the public API and SDK — query real-time usage data for a given customer and metric

​

Entitlements

• Filter entitlement checks by subscription when a customer has multiple active subscriptions

​

Email Notifications

• Custom email routing: configure a custom “from” address for billing notification emails sent to your customers
• Invoice and portal links in emails now expire after 7 days for security

​

Plans

• Plans now include a billingVersion field distinguishing legacy and line-item-based billing

​

Customer Portal

• Customers can now add and remove their own payment methods directly in the portal
• New entitlements view showing customers their active features and usage entitlements
• Address fields on the customer creation form now support autocompletion

​

Platform Updates

• “Show exact balance” toggle replaces nano-unit labels for clearer wallet balance display
• Streamlined merchant onboarding — the consumer/merchant type selection step has been removed for a simpler signup flow

​

Bug Fixes

• Fixed metered line items to correctly apply payment term in_arrears
• Fixed sandbox invite links to preserve the return URL after login
• Standardized required field indicators across all platform forms

​

Multi-Currency Support

• Notifications for invoices, payments, and subscriptions now display amounts in the merchant’s configured currency
• Payment sessions updated with multi-currency support
• Tax provider contact details now kept automatically in sync

​

Platform Updates

​

Customer Portal

• Refreshed customer portal UI
• Enhanced wallet balance display with a new balance header

​

Bug Fixes

• Fixed inconsistent address autocomplete behavior

​

SDK

• Official Paygentic TypeScript SDK now available (beta) with automated publishing

​

Major Release: Features & Entitlements

​

Feature Management

• Define features that can be gated for your customers (e.g., “SSO Access”, “Premium Support”)
• New Feature Management UI to create and manage features directly in the dashboard
• Link features to prices when creating or editing pricing plans
• Automatic entitlement provisioning when customers subscribe to plans with linked features

​

Entitlement Access API

• New public API endpoint (/v1/entitlements) to check if a customer has access to a specific feature
• Support for static (config-based) and boolean (on/off) feature types

​

API Enhancements

​

Webhooks

• New subscription.renewed.v0 webhook event when subscriptions enter a new billing period

​

Customer Management

• Customer name and email now editable directly from the customer detail page
• Fee management endpoints added to public API documentation

​

Payments

• Expired payment session links now automatically regenerate with a new email sent to customers
• Added Australia to merchant eligible countries

​

Email Notifications

• Email notification when invoice is issued (for manual payment invoices)
• Email notification when invoice is paid with links to invoice and receipt
• Email reminder before subscription renewal

​

Bug Fixes

• Fixed micro-pricing truncation in percentage-based prices
• Fixed payment retry flow when initial payment attempt fails
• Fixed fee dropdown showing fees from other products

​

API Improvements

​

Enhanced Invoice Management

• Added merchantId field to all invoice V2 endpoint responses for better multi-merchant support
• Improved manual Event Source sync capabilities with rate limiting for better integration control

​

Security & Environment Management

• API keys now include environment prefixes for clearer identification across different environments
• Enhanced security for API key management

​

Platform Updates

​

User Experience Improvements

• Added pagination to subscriptions table for better performance with large datasets
• Fixed return URL configuration for payment topups
• Minor bug fixes

​

Environment Awareness

• New banner displays current environment (sandbox, staging, production) for clearer context
• Added quick navigation links to sandbox environment

​

Major Release: Tax Integration

​

Paygentic Tax

• Complete tax automation with Paygentic Tax integration
• Automatic tax calculation and reporting
• Support for international tax compliance

​

API Enhancements

​

Customer Management

• Enabled tax ID and tax rate updates for merchant-managed customers
• Added address modification capabilities for merchant-managed consumers
• Enhanced subscription and customer ID tracking in source event responses

​

Data Integrity

• Prevented duplicate prices per billable metric in plans
• Improved conflict detection for existing subscriptions

​

Platform Features

​

Payment Methods Portal

• New self-service payment methods management in customer portal
• Improved payment method handling and invoice card filtering
• Enhanced off-session payment flow for automatic billing

​

Documentation Updates

• Comprehensive documentation for payment terms
• Detailed metric modes explanation
• Updated billing guides