Payment Required

HTTP Status: 402

{
  "code": "payment_required",
  "message": "Your plan's monthly credits are used up. Top up, enable Auto Recharge, upgrade, or wait for the cycle reset.",
  "request_id": "req_3f6a2c1e-9b0d-4e7a-8c21-5d1f0a9b7e42",
  "doc_url": "https://docs.poof.bg/errors/payment-required"
}

Reasons and How to Fix

Monthly Credits Used Up

You’ve used all of your plan’s credits for the current billing cycle. Every successful image request costs 1 credit; failed requests (including this one) are not billed. Video costs 5 credits per second of source video (10 above 30 fps; animated GIF input is billed at 5 credits per second whatever its frame rate), charged when the job is accepted, so a /remove request with a video is rejected with this error when the remaining balance does not cover the whole clip. Credits for a job that later fails are refunded. To fix, do one of the following:

Top up — buy extra credits at dash.poof.bg (available on Pro and above). Top-up credits are valid until the end of the current cycle.
Enable Auto Recharge — in Billing settings, turn on Auto Recharge so a top-up is bought automatically when you reach a chosen fraction of your plan limit.
Upgrade — move to a plan with a larger monthly allocation.
Wait for the cycle reset — your monthly credits are restored at the start of the next billing cycle. Unused credits do not roll over.

Not Enough Credits Left for This Video

You still have credits, but fewer than the clip costs. The response says how many are needed and how many are left:

{
  "code": "payment_required",
  "message": "This video costs 65 credits but only 40 are left in this billing cycle. Top up, enable Auto Recharge, upgrade, or wait for the next billing cycle.",
  "request_id": "req_8b1d4f2a-6c3e-4a9b-9e05-2f7c1d8a4b63",
  "doc_url": "https://docs.poof.bg/errors/payment-required",
  "details": { "credits_required": 65, "credits_remaining": 40 }
}

Nothing is charged. The check covers one request at a time, so clips submitted at the same moment can together exceed the remaining credits. Send a shorter clip, or add credits in one of the ways above.

Check Your Usage

Use the /me endpoint to compare usedCredits with maxCredits. This endpoint is free and not rate limited:

curl https://api.poof.bg/v1/me -H "x-api-key: pk_your_api_key"

{
  "organizationId": "org_abc123",
  "plan": "Pro",
  "maxCredits": 2000,
  "usedCredits": 2000,
  "autoRechargeThreshold": 0.9
}

See Get Account Info for the full response.

Getting Started

Video guides

API Reference

Payment Required

Reasons and How to Fix

Monthly Credits Used Up

Not Enough Credits Left for This Video

Check Your Usage

Need Help?

​Reasons and How to Fix

​Monthly Credits Used Up

​Not Enough Credits Left for This Video

​Check Your Usage

​Need Help?

Reasons and How to Fix

Monthly Credits Used Up

Not Enough Credits Left for This Video

Check Your Usage

Need Help?