Billing & Credits

The Mockupanda API uses a simple pay-per-use credit system. This page explains how credits work, pricing, and how to manage your balance.

How Credits Work

Credit System

1 credit = $0.01 USD (one cent)
1 mockup = 1 credit consumed
Pre-paid credits - Add funds to your wallet before generating mockups
No expiration - Credits never expire
No monthly fees - Only pay for what you use

Wallet Balance

Your API wallet is separate from your web app subscription. Credits are only consumed by API requests, not web app mockup generation.

Check your balance at Dashboard → Billing.

Pricing

API Mockups

| Item | Cost | |------|------| | Single mockup | 1 credit ($0.01 USD) | | Multi-frame mockup | 1 credit ($0.01 USD) | | Failed request | 0 credits |

Example costs:

100 mockups = 100 credits = $1.00 USD
1,000 mockups = 1,000 credits = $10.00 USD
10,000 mockups = 10,000 credits = $100.00 USD

Credit Packs

Purchase credits in packs with volume discounts:

| Pack Size | Cost | Cost Per Credit | Savings | |-----------|------|-----------------|---------| | 100 credits | $1.00 USD | $0.0100 | — | | 1,000 credits | $9.00 USD | $0.0090 | 10% off | | 5,000 credits | $40.00 USD | $0.0080 | 20% off | | 10,000 credits | $70.00 USD | $0.0070 | 30% off |

Purchase at Dashboard → Billing.

Adding Credits

Via Dashboard

Log in to mockupanda.com
Navigate to Dashboard → Billing
Select a credit pack
Complete payment via Stripe
Credits are added instantly

Via API (Programmatic Top-up)

Not currently supported. Credits must be added manually via the dashboard.

Checking Your Balance

Via Dashboard

View your balance at Dashboard → Billing:

API Wallet Balance: 1,250 credits ($12.50)

Via API Response Headers

Every successful mockup generation includes credit headers:

X-Credits-Used: 1
X-Credits-Remaining: 1249

Via API Endpoint

Fetch your current balance:

curl -X GET https://mockupanda.com/api/v1/billing/balance \
-H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "balance_cents": 1250,
  "balance_dollars": "12.50",
  "balance_credits": 1250
}

Insufficient Credits

If your balance is too low, requests fail with a 402 Payment Required error:

{
  "error": "Insufficient account balance. Add funds in Billing to continue.",
  "code": "INSUFFICIENT_CREDITS",
  "details": {
    "required_cents": 1,
    "balance_cents": 0
  },
  "hint": "Top up your API wallet from Dashboard > Billing and retry."
}

Fix: Add credits at Dashboard → Billing, then retry the request.

Credit Consumption

When Credits Are Consumed

Credits are deducted:

On success - When a mockup is successfully generated
200 OK - Only when the response is successful

Credits are NOT deducted:

On failure - When generation fails due to an error
4xx/5xx errors - Any error response (rate limits, invalid params, etc.)

Failed Requests

If a request fails after deducting credits, the credit is automatically refunded. You only pay for successful mockups.

Refunds

Credits are non-refundable once purchased. However, we may issue refunds at our discretion for:

Technical issues preventing mockup generation
Billing errors (duplicate charges, etc.)

Contact support via the feedback button in your dashboard for refund requests.

Usage Tracking

Via Dashboard

View detailed usage history at Dashboard → Billing:

Total requests made
Credits consumed over time
Top templates used
Requests per API key

Via API

Fetch usage statistics:

curl -X GET https://mockupanda.com/api/v1/billing/usage?period=30d \
-H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "period": "30d",
  "total_requests": 1250,
  "successful_requests": 1240,
  "failed_requests": 10,
  "credits_consumed": 1240,
  "credits_refunded": 10,
  "top_templates": [
    { "template_id": "bedroom-poster-01", "count": 450 },
    { "template_id": "canvas-wall-01", "count": 320 },
    { "template_id": "wall-diptych-01", "count": 270 }
  ],
  "requests_by_day": [
    { "date": "2025-01-01", "count": 45 },
    { "date": "2025-01-02", "count": 52 }
  ]
}

Invoices & Receipts

Email Receipts

After each credit purchase, you'll receive an email receipt from Stripe with:

Transaction ID
Amount paid
Credits purchased
Invoice PDF

Invoice History

View all invoices at Dashboard → Billing or via Stripe's customer portal.

Payment Methods

Accepted Payments

Credit Cards: Visa, Mastercard, American Express
Debit Cards: Visa Debit, Mastercard Debit
Digital Wallets: Apple Pay, Google Pay
ACH/Bank Transfer: Available for $1,000+ purchases

Payment Security

All payments are processed securely by Stripe. We never store your card details.

Billing Alerts

Low Balance Alerts

Receive email notifications when your balance drops below:

100 credits - Low balance warning
10 credits - Critical balance warning

Enable alerts at Dashboard → Billing.

Usage Alerts

Get notified when:

You exceed expected usage thresholds
A sudden spike in requests is detected
Repeated failed requests indicate a problem

Budget Management

Setting Budget Limits

Not currently supported. To prevent unexpected charges:

Monitor your balance regularly
Set up low balance alerts
Use separate API keys per project to track usage

Usage Caps

Usage caps are not enforced. You can generate mockups until your balance reaches zero, at which point requests will fail with INSUFFICIENT_CREDITS.

Enterprise Billing

For high-volume customers ($1,000+/month), we offer:

Invoiced billing - Monthly invoices instead of pre-paid credits
Net-30 payment terms - Pay after usage
Volume discounts - Up to 50% off for large volumes
Dedicated support - Priority support channel
Custom contracts - Tailored to your needs

Contact support via the feedback button in your dashboard to discuss enterprise billing.

Tax & VAT

US Customers

Prices are in USD. Sales tax may apply depending on your state.

International Customers

Prices are in USD. VAT or GST may apply depending on your country. Tax ID validation available for EU customers.

Tax Receipts

Tax details are included in your Stripe invoice. Update your billing information at Dashboard → Billing.

Fair Use Policy

The credit system assumes reasonable, good-faith usage. Abuse (e.g., generating the same mockup repeatedly to inflate costs) may result in account suspension.

FAQ

Do credits expire?

No, credits never expire. Use them whenever you need.

Can I get a refund?

Credits are non-refundable. Contact support for billing errors or technical issues.

Can I transfer credits to another account?

No, credits are tied to your account and cannot be transferred.

What happens if I run out of credits mid-request?

The request fails with INSUFFICIENT_CREDITS before any processing begins. No partial charges.

Billing & Credits

How Credits Work

Credit System

Wallet Balance

Pricing

API Mockups

Credit Packs

Adding Credits

Via Dashboard

Via API (Programmatic Top-up)

Checking Your Balance

Via Dashboard

Via API Response Headers

Via API Endpoint

Insufficient Credits

Credit Consumption

When Credits Are Consumed

Failed Requests

Refunds

Usage Tracking

Via Dashboard

Via API

Invoices & Receipts

Email Receipts

Invoice History

Payment Methods

Accepted Payments

Payment Security

Billing Alerts

Low Balance Alerts

Usage Alerts

Budget Management

Setting Budget Limits

Usage Caps

Enterprise Billing

Tax & VAT

US Customers

International Customers

Tax Receipts

Fair Use Policy

FAQ

Do credits expire?

Can I get a refund?

Can I transfer credits to another account?

What happens if I run out of credits mid-request?

Can I set up auto-recharge?

Do failed requests cost credits?

Next Steps