Pricing, Billing, And Gas Credits
PayChain pricing has two parts: your plan and your usage. Your plan sets your monthly subscription, invoice fee rate, minimum fee, payout API withdrawal quota, and included sponsored gas allowance. Usage increases when you process invoices, create payout withdrawals, or consume sponsored gas on supported networks.
Important note: Sponsored gas makes supported outbound operations easier, but it does not mean unlimited network usage. PayChain still tracks sponsored gas per business.
Plan comparison
| Plan | Monthly | Invoice fee | Minimum fee | Sponsored gas | Included payout API withdrawals |
|---|
| Free | $0 | 0.95% | $0.10 | Fair-use included | 0 / month |
| Startup | $19 | 0.70% | $0.10 | $10 / month included | 100 / month |
| Growth | $99 | 0.55% | $0.05 | $35 / month included | 1,000 / month |
| Scale | $499 | 0.35% | $0.05 | $150 / month included | 10,000 / month |
| Enterprise | Custom | 0.15%-0.35% | Custom | Custom | Custom |
Enterprise is a commercial plan, not a zero-dollar plan. Use Enterprise when the business needs custom pricing, custom payout volume, rollout support, security review, dedicated support, or negotiated gas and settlement terms.
Operator note: Free and paid plans can still receive payments. Gas-credit exhaustion affects eligible sponsored outbound actions, such as sweeps or sponsored withdrawals.
Payout API note: Free includes 0 / month payout API withdrawals as included quota. This does not block payout API withdrawals; it means the Free payout API fee applies from the first programmatic withdrawal. Startup and higher plans use included payout API quota first, then plan-specific overage pricing where applicable.
Fee types
- Monthly subscription: recurring plan cost.
- Invoice fee: percentage fee on settled invoice volume.
- Minimum fee: smallest fee PayChain charges on an invoice to keep small payments economically safe.
- Payout API withdrawal quota: included API-triggered withdrawals per billing cycle.
- Standalone withdrawal fee: product fee for withdrawals outside standard payment processing.
- Sponsored gas: network cost PayChain sponsors for eligible outbound operations.
Dashboard/manual withdrawals and payout API withdrawals are separate commercial surfaces. A Free plan business can use payment collection, dashboard/manual withdrawal flows, contract-interaction withdrawals where available, and payout API withdrawals. Free just starts at paid payout API usage because it has no included payout API quota.
Withdrawal fee behavior
| Plan | Payout API fee after included quota | Standalone/dashboard withdrawal fee |
|---|
| Free | $0.05 | $0.08 |
| Startup | $0.03 | $0.05 |
| Growth | $0.01 | $0.03 |
| Scale | $0.005 | $0.02 |
| Enterprise | Custom | Custom |
Payout API fees apply to backend-created programmatic withdrawals, dynamic-recipient payout legs, and invoice-linked payout automation after included quota is used. On Free, included quota is zero, so the payout API fee applies immediately.
Invoice fee examples
These examples show the plan fee only. Network behavior and gas-credit usage depend on the rail and operation.
| Plan | Invoice amount | Fee rule | PayChain fee | Merchant net |
|---|
| Free | $10.00 | 0.95%, $0.10 minimum | $0.10 | $9.90 |
| Startup | $10.00 | 0.70%, $0.10 minimum | $0.10 | $9.90 |
| Startup | $100.00 | 0.70%, $0.10 minimum | $0.70 | $99.30 |
| Growth | $100.00 | 0.55%, $0.05 minimum | $0.55 | $99.45 |
| Scale | $1,000.00 | 0.35%, $0.05 minimum | $3.50 | $996.50 |
Minimum-fee note: For very small explicit invoices, the dashboard may warn that the amount is below the recommended minimum for the plan. Explicit invoices can still be created when expected merchant net remains positive.
Sponsored gas keeps outbound payment operations moving without requiring each merchant to hold native network tokens. PayChain may use shared sponsored-gas infrastructure, but usage is attributed per business before operations are submitted.
Included gas vs prepaid gas
| Credit type | How it works |
|---|
| Included gas credits | Granted by plan each billing cycle. Used first. Resets each cycle. |
| Prepaid gas credits | Bought as top-ups. Used after included gas. Does not expire by default. |
Consumption order:
- Included monthly sponsored gas.
- Prepaid gas balance.
- Eligible sponsored outbound operations pause as
gas_blocked.
What uses gas credits
- Automatic sweeps.
- Sponsored withdrawals.
- Payout API withdrawals.
- ATA creation on Solana.
- Token account closing or rent reclaim.
- Contract execution when PayChain sponsors network cost.
The standalone withdrawal fee is a product fee. Gas credits reduce only when PayChain incurs sponsored network cost.
Billing note: A withdrawal fee and sponsored gas consumption are separate things. A withdrawal can have a product fee, and gas credits only reduce when PayChain sponsors network cost.
PayChain records sponsored gas usage on eligible outbound operations even when the API caller does not provide a gas estimate. This keeps dashboard gas usage aligned with actual sponsored execution instead of relying on integrators to supply gas-cost fields.
Gas-credit examples
Included gas first
A Startup business receives $10 included sponsored gas for the billing cycle.
- The business has 10includedgasand0 prepaid gas.
- A sponsored outbound operation costs $0.15.
- PayChain records $0.15 of gas usage.
- Included gas becomes $9.85.
- Prepaid gas remains $0.
Prepaid gas after included gas
- The business has 0.20includedgasand5 prepaid gas.
- A sponsored withdrawal costs $0.35.
- PayChain uses $0.20 included gas first.
- PayChain uses $0.15 prepaid gas for the remainder.
- Included gas becomes 0andprepaidgasbecomes4.85.
Gas-blocked operation
- The business has 0includedgasand0.02 prepaid gas.
- A sponsored payout route leg is estimated to need $0.10.
- PayChain keeps inbound invoice confirmation active.
- The outbound payout operation is marked
gas_blocked.
- The operator buys a top-up pack.
- PayChain resumes queued gas-blocked work oldest-first until credit is insufficient again.
Top-up note: Gas top-ups do not require a plan upgrade. They restore sponsored outbound continuity for the current plan.
What does not stop when gas credits run out
- Inbound payment detection.
- Invoice payment confirmation.
- Webhook delivery.
- Dashboard access.
- Billing invoice payment.
- Gas top-ups.
Gas exhaustion affects eligible sponsored outbound work, not payment collection.
Top-ups
Users can buy 5,10, 25,50, or $100 gas packs without upgrading plan. After a successful top-up, PayChain resumes gas-blocked operations for that business oldest-first until credit is insufficient again.
Billing and usage APIs
Use these endpoints if your own dashboard needs to show plan, fee, quota, gas, or top-up state.
curl "$PAYCHAIN_API_URL/billing/me" \
-H "x-api-key: $PAYCHAIN_API_KEY"
curl "$PAYCHAIN_API_URL/billing/usage" \
-H "x-api-key: $PAYCHAIN_API_KEY"
Expected billing surfaces include:
- Current plan.
- Invoice fee rate and minimum fee.
- Payout API withdrawal quota and usage.
- Included gas granted, used, and remaining.
- Prepaid gas balance.
- Gas top-up options.
- Gas-blocked operation count.
Billing lifecycle
- Paid plans create a renewal invoice 5 days before cycle end.
- If the invoice is paid, the next cycle activates and included gas is granted.
- If unpaid at cycle end, the business enters a 14-day grace / past-due warning period.
- During grace, product access remains unchanged and users see soft warnings.
- If still unpaid after grace, the business downgrades to Free. Data is preserved.
Where users see usage
- Dashboard billing page.
- Gas balance and top-up cards.
- Payout quota usage.
- Blocked settlement state.
GET /api/v1/billing/me.
GET /api/v1/billing/usage.