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

ItemCost
Single mockup1 credit ($0.01 USD)
One template with several artworks1 credit ($0.01 USD)
Failed request0 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 addCredits receivedMockups
$10.00 USD1,000 credits1,000
$25.00 USD2,500 credits2,500
$40.00 USD4,000 credits4,000
$100.00 USD10,000 credits10,000

If your volume has outgrown this, see the High Volume section below.

Adding Credits

Via Dashboard

  1. Log in to mockupanda.com
  2. Navigate to DashboardBilling
  3. Enter any amount in USD (minimum $5.00, maximum $1,000.00 per payment)
  4. Complete payment via Stripe
  5. 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 each

Via 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.

Next Steps