Documentation

AI credits

Shop wallet reserve/capture. Exhaustion is 402.

AI calls debit the shop wallet. Staff do not paste their own provider keys.

Flow

  1. reserve — credits are held before the job starts
  2. The job produces a draft (SEO, content, category, channel attributes)
  3. capture — captured on success; released on failure/cancel
  4. Staff apply the draft; nothing is written automatically

Quota

Plan quotas are listed on /pricing. When the wallet is empty the API returns AI_CREDITS_EXHAUSTED (HTTP 402), not a generic CONFLICT.

Amounts are stored as decimal strings.