Usage and billing overview

Fee sponsorship lets an app cover network gas and swap provider fees for eligible wallet activity. It is available self-serve from the Privy Dashboard using prepaid credits. Privy supports two billing models. Prepaid billing uses credits purchased in advance. Postpaid billing meters usage and invoices it at the end of the month.

Setup

Choosing your plan

Model	How it works	When usage is paid for
Prepaid	Sponsored gas and swap provider fees use the account’s prepaid credit balance.	In advance, as a top-up
Postpaid	Privy meters each charge and adds it to a monthly invoice.	In arrears, at the end of the month

Postpaid billing is available on the Enterprise plan. Contact [email protected] to enable it for an account.

Purchasing credits (prepaid)

Prepaid credits cover gas and swap provider fee sponsorship across the account’s apps.

Add credits

Open Billing > Fee sponsorship and select Add credits. Choose an amount and confirm the purchase. Add a payment method when prompted, if one is not already saved.

Configure sponsorship for an app

Open the app’s Fee sponsorship page. Enable Sponsor gas fees, Sponsor swap provider fees, or both.

The available balance must cover the sponsored fees. If credits are insufficient, add credits before retrying the transaction. Manage the balance, Automated credit refill, and notification settings from Billing > Fee sponsorship.

To query prepaid gas credit consumption for a set of wallets, use the gas spend endpoint.

Sponsored fees

Both billing models support the following fees. On postpaid accounts, each usage type appears separately on the monthly invoice.

Usage type	What it covers
Gas sponsorship	Network gas the app sponsored for a transaction, on apps that use gas sponsorship.
Swap provider fees	Routing and swap fees on all supported routes for transfers, swaps, and crypto deposit addresses with fee sponsorship. Slippage is covered only for fixed-rate routes.

A single wallet action can produce more than one charge. A transfer with both sponsorship settings enabled incurs gas and swap provider fee charges.

Consuming charge events

Usage webhooks help apps track sponsored gas and swap provider fee charges. Each event includes the charge amount and the wallet action that incurred it.

Usage webhooks

Review event availability, payloads, and guidance for reconciling charges against wallet actions.

Gas management