Payment Required

Occurs when the user tries to access a feature requiring payment or subscription.

Cause: Account has exceeded free tier limits or subscription payment is required.

Suggested Action: Upgrade your subscription plan or add payment method to continue using the API.

Common Scenarios:

  • Exceeding monthly limits
  • Using premium features on free plan
  • Subscription payment failed or expired

Response Example

{
  "type": "https://developers.leadboxer.com/docs/payment-required",
  "title": "Payment Required",
  "status": 402,
  "detail": "Your account has exceeded the free tier limits",
  "instance": "/v1/users",
  "billing_portal": "https://app.leadboxer.com/billing"
}

HTTP Status

402 Payment Required

Additional Fields

  • billing_portal: Link to manage subscription and billing

Resolution

  1. Visit provided billing portal link
  2. Upgrade subscription plan
  3. Add/update payment method
  4. Contact support for plan options