Billing & Credits
The Mockupanda API uses a simple pay as you go 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
- Prepaid 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 DashboardBilling.
Pricing
API Mockups
| Item | Cost |
|---|---|
| Single mockup | 1 credit ($0.01 USD) |
| One template with several artworks | 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
Volume Discounts
There are no volume discounts or bonus credits. Every payment converts at the same flat rate:
| You add | Credits received | Mockups |
|---|---|---|
| $10.00 USD | 1,000 credits | 1,000 |
| $25.00 USD | 2,500 credits | 2,500 |
| $40.00 USD | 4,000 credits | 4,000 |
| $100.00 USD | 10,000 credits | 10,000 |
If your volume has outgrown this, see the High Volume section below.
Adding Credits
Via Dashboard
- Log in to mockupanda.com
- Navigate to DashboardBilling
- Enter any amount in USD (minimum $5.00, maximum $1,000.00 per payment)
- Complete payment via Stripe
- Credits are added to your wallet as soon as the payment is confirmed
Automatic Refills
Your balance can refill on its own, so a batch never stops halfway because it ran out. In DashboardBilling, pick a balance to refill at and an amount to add, and your saved card is charged whenever your balance drops below it. It stays off until you turn it on.
Via API
Not currently supported. Add credits from the dashboard, by hand or with automatic refills.
Checking Your Balance
Via Dashboard
View your balance at DashboardBilling, shown in USD alongside an estimate of how many mockups it covers:
$12.50
Estimated remaining: 1250 mockups at $0.01 eachVia API
GET /api/v1/billing/wallet returns your balance and recent transactions:
curl -X GET https://www.mockupanda.com/api/v1/billing/wallet \
-H "Authorization: Bearer YOUR_SUPABASE_ACCESS_TOKEN"This endpoint works with the session you get by signing in to the dashboard, not with an API key. Sending an mk_ API key returns 401, so it cannot be called from your own server.
Response:
{
"wallet": {
"balance_cents": 1250,
"lifetime_topup_cents": 5000,
"lifetime_spent_cents": 3750
},
"mockup_cost_cents": 1,
"transactions": [
{
"id": "b1f2c3d4-5678-90ab-cdef-1234567890ab",
"type": "usage",
"amount_cents": -1,
"status": "completed",
"description": "Mockup generation (bedroom-poster-01)",
"created_at": "2025-01-02T10:31:44.512Z"
},
{
"id": "a0e1b2c3-4567-89ab-cdef-0123456789ab",
"type": "topup",
"amount_cents": 2500,
"status": "completed",
"description": "Wallet top-up",
"created_at": "2025-01-01T09:12:03.004Z"
}
]
}mockup_cost_cents is the current price of one mockup, so your remaining mockups are balance_cents / mockup_cost_cents.
There is no way to read your balance with an API key alone. A request that would exceed your balance fails with INSUFFICIENT_CREDITS before any processing or charge.
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,
"template_count": 1
},
"hint": "Top up your API wallet from Dashboard > Billing and retry."
}Fix: Add credits at DashboardBilling, 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 (invalid params, missing artwork, etc.)
Failed Requests
Credits are deducted only after a mockup has been generated successfully, so a failed request never reaches the deduction step. You only pay for successful mockups.
Batch Requests
A request with multiple template_ids is charged 1 credit per template. The full amount is checked against your balance before generation starts, and deducted once all mockups in the batch have been generated.
Refunds
Credits can't be refunded 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
DashboardBilling lists your recent wallet activity:
- Funds added, with amount and date
- Usage charges with the template or batch that was generated
- Total added and total spent over the life of the account
Via API
A programmatic usage endpoint is not currently available.
Invoices & Receipts
Email Receipts
Each time you add funds, you'll receive an email receipt from Stripe with:
- Transaction ID
- Amount paid
- Invoice PDF
Invoice History
Receipts are available from the links in your Stripe email receipts. DashboardBilling shows the matching wallet transactions.
Payment Methods
Accepted Payments
- Credit Cards: Visa, Mastercard, American Express
- Debit Cards: Visa Debit, Mastercard Debit
- Digital Wallets: Apple Pay, Google Pay
Payment Security
All payments are processed securely by Stripe. We never store your card details.
Billing Alerts
Low balance and usage alerts are not currently available. To avoid running out in the middle of a job, check your balance in the dashboard and handle the INSUFFICIENT_CREDITS error in your code.
Budget Management
Setting Budget Limits
Not currently supported. To prevent unexpected charges:
- Monitor your balance regularly
- Top up in smaller amounts so your balance acts as a natural spending cap
- 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.
High Volume
You can add up to $1,000.00 per payment. If you need more than that, add funds more than once.
If your volume has outgrown the prepaid wallet, contact support via the feedback button in your dashboard and we will work something out with you.
Tax & VAT
Prices are in USD. Depending on where you are, sales tax, VAT, or GST may apply. Any tax details that apply to your payment appear on the receipt Stripe sends you.
Fair Use Policy
The credit system assumes reasonable use in good faith. Abuse (e.g., generating the same mockup repeatedly to inflate costs) may result in account suspension.
FAQ
No, credits never expire. Use them whenever you need.
Credits can't be refunded. Contact support for billing errors or technical issues.
No, credits are tied to your account and cannot be transferred.
The request fails with INSUFFICIENT_CREDITS before any processing begins. No partial charges.
Yes. In Dashboard → Billing, pick a balance to refill at and an amount to add. Your saved card is charged whenever your balance drops below it.
No, only successful mockup generation consumes credits.