The 402 error code stands for Payment Required: the server understood your request but will not complete it until some payment is made or a paid plan is active. Unlike most codes, 402 was set aside for future use in the official HTTP rules, so there is no single standard way it behaves.
In daily life you meet it in a few places. A web service may send it when a free quota is used up, an unpaid invoice has locked an account, or a card on file was declined. Developers also see it in the answer of a billing or subscription API. If you only want to read a web page and you see a 402, the site is probably misusing the code, and the owner has to look at it. Below are the checks a user can make, then the notes for developers.
Common causes
1Free quota or trial used up
How to tellThe service worked yesterday and stopped after heavy use
What fixes itCheck the usage page of the account, or wait for the quota to reset
2Subscription expired or unpaid invoice
How to tellA billing email arrived, or the account page shows overdue
What fixes itRenew or pay the invoice inside the official account page
3Card declined or payment method expired
How to tellThe last charge failed, and the plan paused after that
What fixes itUpdate the payment method, then retry the request
4Feature locked to a higher plan
How to tellOnly one feature or endpoint returns 402, the rest work
What fixes itCheck what your plan includes, or contact the provider
5API key tied to an unpaid project
How to tellA developer sees 402 in the response body with a billing message
What fixes itOpen the project billing settings and clear the dues
6Website owner using 402 by mistake
How to tellA plain article or image gives 402 and nothing about payment
What fixes itTell the site owner; visitors cannot fix this one
How to fix it, step by step
Read the full message on the screen
A 402 almost always comes with words that explain it, such as a plan limit or an overdue bill. Read the whole page or the response text before doing anything else. That one line tells you whether the issue is money, quota or a mistake.
Sign in and open the billing page
Go to the account, then the billing or plan section of the service itself, typing the address yourself or using the app. Look for a failed payment, an expired card or a plan that ended. Never pay through a link in a message you did not expect.
Check the usage or quota meter
Many services count requests, storage or credits. If the meter is full, the 402 is the service asking you to upgrade or wait. Quotas often reset daily or monthly, so the same action may work again later.
Update the payment method if it failed
Cards expire, hit their limit or get blocked by the bank. Add a working method, then retry. If money was taken but the service still shows 402, keep the receipt and ask the provider to confirm the payment.
Wait a few minutes after paying
After a successful payment, the account may take a short time to unlock. Log out, log in again, and then retry. Hammering the retry button gains nothing and can trip a rate limit, which is a different problem, covered under 429 Too Many Requests.
Contact the provider with the exact text
If billing looks fine, send support a screenshot of the message, the time it happened and what you were doing. Do not share passwords, card numbers or codes sent to your phone.
If you are a visitor on a free page, report it
A normal public page returning 402 is a setup mistake. Try the home page, then tell the site through its contact form. There is nothing on your phone or computer to repair.
What the 402 error code means in plain words
Each reply from a server starts with a three digit number. Codes beginning with 4 say the request cannot go through as sent. The official rules list 402 as reserved, meaning the idea was to let money be handled right inside the web protocol, but that never became a fixed standard. So each company decides what its own 402 means.
An app that turns text into speech suddenly shows 402: monthly credits exhausted. Nothing is broken on the phone. The account simply ran out of credits, and it needs a top up or a new month.
Error code 402 compared with 401 and 403
| Code | Server's message | What you do |
|---|---|---|
| 401 | Prove who you are | Sign in again |
| 402 | Payment or plan needed | Fix billing or quota |
| 403 | You are known, but not allowed | Ask for access |
| 429 | Requests sent faster than allowed | Wait and slow down |
Read the separate guides on 401 Unauthorized and 403 Forbidden. A sign in problem is not a billing problem, even though both stop you at the door.
402 error code in a REST API
Developers meet the 402 error code in REST API work mostly with paid services. The response body usually holds a small JSON message with a reason, such as an unpaid balance or a plan limit. Log that body, not just the number.
- Do not retry in a loop. A 402 will not fix itself in seconds, so back off and alert someone.
- Show a clear message to your own users, such as ask the account owner to check billing.
- Keep payment details out of logs. Never print keys or card data while debugging.
- Separate it from 403. Use 402 only if your billing rules cause the block, and document it.
Money left my account but I still get 402
This page is general information. If you paid and the service did not unlock, raise it with the service's own support. If the money left your bank, use the bank or payment app's in-app help to start a dispute. Never share your PIN or an OTP with anyone.
Keep the payment reference, when it happened, plus a picture of the message. Those three things let support find your case quickly.
Avoiding a surprise payment lock
Turn on usage alerts if the service offers them, keep a card with room on it, and note the renewal date. For teams, put billing emails on a shared address so one missed message does not stop a whole project. See the full list of codes in the HTTP status codes guide.
Frequently asked questions
What does error code 402 mean?
It means Payment Required. The server will not finish your request until a payment is made or a paid plan is active. The exact reason is usually written in the message beside the number.
Is the 402 error code my fault?
Only if it comes from a service you pay for and the bill or quota is the cause. On a normal public web page, a 402 is a mistake by the site owner.
Why do I see a 402 error code in a REST API?
Paid APIs send it when credits ran out, a plan ended or a payment failed. Check the response body, then the billing page of the project.
Is 402 the same as 401?
No. A 401 asks you to sign in or prove who you are. A 402 is about money or plan limits.
How long does it take to clear a 402 after I pay?
Usually within minutes. Sign out and in again. If it stays beyond a few hours, send the provider your receipt.