Prepaid Balance

​

How it works

1. Top up. Pick a pack in Settings → Billing and pay by card. The balance updates a few seconds after payment.
2. Use your plan first. Monthly plan credits are always spent before the balance.
3. Pay from balance. When a monthly quota runs out, a feature keeps working and is paid from your balance, as long as its switch is on and the balance covers the cost.
4. Track it. Every top-up, charge and refund shows in Recent activity.

​

Top-up packs

​

What the balance pays for

​

Pay-from-balance switches

​

Good to know

• API & MCP. A request is let through only when the balance covers its whole shortfall. The charge is made after the response succeeds. The response carries X-Wallet-Overage-Units and X-Wallet-Overage-Feature when the balance paid for part of it. GET /v1/auth/usage and the get_api_usage MCP tool show how many credits your balance can still buy (walletCredits) and your balance in USD.
• Dashboard, desktop and mobile app use doesn’t spend API & MCP credits, so it never charges your balance for them.
• UGC media. Credits bought from your balance become media credits that don’t expire. If a generation fails, its credits go back to your media credits, not to your balance.
• AI Visibility. Scan charges never take your balance below zero.
• Creator Discovery. Creators who fail to load, or don’t make it into the results, are refunded automatically. See Creator Discovery.

​

Refunds

• Failed work. When paid work fails, such as a Creator Discovery run, its charge is returned to your balance automatically and shows as Refund in your activity. Failed UGC generations return their media credits instead (see above).
• Refunded payments. If a top-up payment is refunded or disputed, that amount is removed from your balance, together with the matching share of its bonus. This shows as Payment refunded. If a dispute is decided in your favor, the amount is added back.

​

Teams

​

API

​

Get your balance

curl https://api.appeeky.com/v1/wallet \
  -H "X-API-Key: $APPEEKY_API_KEY"

{
  "data": {
    "balanceMicros": 26250000,
    "settings": { "media": true, "api": true, "ai_visibility": true, "reddit": false },
    "packs": [
      { "amountCents": 1000, "bonusCents": 0 },
      { "amountCents": 2500, "bonusCents": 125 },
      { "amountCents": 5000, "bonusCents": 400 },
      { "amountCents": 10000, "bonusCents": 1000 }
    ],
    "prices": [
      { "feature": "api_credit", "unit": "API/MCP credit", "priceMicros": 5000 },
      { "feature": "creator_analysis", "unit": "analyzed creator", "priceMicros": 10000 }
    ]
  }
}

​

Change switches

curl -X PATCH https://api.appeeky.com/v1/wallet/settings \
  -H "X-API-Key: $APPEEKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reddit": false }'

​

Top up

curl -X POST https://api.appeeky.com/v1/wallet/topup \
  -H "X-API-Key: $APPEEKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amountCents": 2500 }'

​

Activity

​

Related

• Rate Limits & Credits: plans, monthly credits and 429 responses
• Creator Discovery: pay-per-creator search
• Workspaces: who pays in a team