USPS (PRIORITY) error: 80040B23 API Authorization failure API RateV4

-- url of the page with the problem -- : langecraft.com/
-- HikaShop version -- : 5.1.0
-- Joomla version -- : 4.4.5
-- PHP version -- : 8.0.28
-- Browser(s) name and version -- : Chrome
-- Error-message(debug-mod must be tuned on) -- : USPS (PRIORITY) error: 80040B23 API Authorization failure. User xxxxxxLANGExx is not authorized to use API RateV4.

USPS plugin stopped working, website is only displaying "Best Way" shipping rates.

USPS (PRIORITY) error: 80040B23 API Authorization failure. User xxxxxxLANGExx is not authorized to use API RateV4.
USPS (FIRST CLASS) error: 80040B23 API Authorization failure. User xxxxxxLANGExx is not authorized to use API RateV4.
USPS (GROUND ADVANTAGE) error: 80040B23 API Authorization failure. User xxxxxxLANGExx is not authorized to use API RateV4.

I saw where you uploaded a new version of the plugin on another post and uploaded that with no help.
I went to USPS website and created a new account and still not working.

Hi,

Indeed the only reference I can find online for this error is this one:
wordpress.org/support/topic/there-are-no...r-address-has-bee-4/
And since you mention that you already tried to use a new account and it didn't help, I suppose you must have already found it.
But since there is no other information available online for this error, we can't do anything.
Could you contact the USPS tech support for help ? Maybe something special needs to be activated on their end for your USPS account ?

Hey did you ever get a resolution for this error. I'm currently going through the same exact headache. I contacted support@webtools.usps.gov several times and NOBODY replies or calls. If your managed to sort the issue out, could you please share it with the forum. I'm certain many are getting the same error as well.

Hi,

I would recommend phoning someone at USPS and see if they can redirect you to the correct person.
Here is a list of a lot of contacts at USPS, with their phone numbers for many:
postalpro.usps.com/support
For example, the guys at the "Parcel Data Exchange (PDX) API" might be colleagues of the ones for the webtools API.

Now, the error message being "User xxxxxxLANGExx is not authorized to use API RateV4", it sounds to me that your USPS account needs to have something activated to be able to use the API.
And looking again online about it, I can see another page talking about it, also mentioning to contact USPS to have it activated for your account:
wordpress.org/support/topic/api-authoriz...d-to-use-api-ratev4/

So I'm afraid we can't do much on our end besides redirecting you to USPS.

Out of curiosity, is this related to the Web Tools API being retired on January 25, 2026, per postalpro.usps.com/node/13834 ?

USPS says to migrate to the new USPS APIs by then.

All of HikaShop's documentation and plugin language are still using Web Tools, so I am a little confused about whether we need to do anything.

Hi,

Thank you for your feedback on this. We were not aware of this change.
I don't think it is linked. You should still be able to use the Web Tools API for a year.
On our end, it will require the development of a brand new shipping plugin from scratch for USPS so that users can migrate to it until January 2026.

Glad I mentioned it then.

I first heard of it yesterday when I found an email from USPS API Communications xczpk0@usps.gov> dated 3/6 in my spam folder.

Apparently, they sent one back on 2/14, too, which was also in my spam folder.

Hi,

The new USPS plugin has been developed. It has been released today and is now available here:
www.hikashop.com/marketplace/product/290-usps.html

Is there any documentation, or are the options and settings very similar to those of the current USPS plugin, just using the new API?

I'm asking because the USPS.com Apps area is a bit different now, and you get a "Consumer Key" and "Consumer Secret."

I assume we don't need a callback URL either, and that "Public Access I" APIs are fine (all I see).

Thanks!

Hi,

The settings are very similar. It's quite simple to setup, as explained on the link I gave.
But it's indeed true that they use a different terminology for the client id and the client secret.
In their developer documentation they only talk about client id and client secret, while in their "apps" area they decided to use consumer key and consumer secret, instead of using the same words.
So yes, you just need to use the consumer key and the consumer secret as the client id and client secret.
No need for a callback URL.

I'm now getting around to testing out the new plugin, and I can see in the USPS dev dashboard that API calls are being made.

However, I'm getting no results in HikaShop.

A couple of things are confusing - I cannot find a "USPS Account Number" anywhere in my profile, and I'm unsure what to set the USPS Account type to.

Some options that seem to be missing from the old USPS plugin, which were important before and I think might still be, are:

I'm assuming it is using developers.usps.com/domesticpricesv3#tag...st-base-rates-search :
So I'm not sure what if these required variables are being set statically: rateIndicator, processingCategory, destinationEntryFacilityType, and priceType

I think Container might be processingCategory now, but no way to set it, so I'm not sure what it's defaulting to if it is.

FYI for anyone else, it appears that First Class is now also USPS_GROUND_ADVANTAGE.

I'm not sure if this is due to missing language file entries or something else.


I'm not sure where or what the debug information goes when it's turned on.

Hi,

Here is a page with explanations and instructions to get a USPS account number:
elextensions.com/how-to-get-a-usps-account-number/
Without one, its normal you don't get any results on your website.

Regarding the account type, I'm not sure. You'll have to check with USPS.

The plugin implements this API:
developers.usps.com/domesticpricesv3#tag...ation/post-rate-list
There are no rateIndicator, processingCategory, destinationEntryFacilityType, and priceType for it.
So it's not set statically.

The debug data goes in the "payment log file" setting of the HikaShop configuration. So please look in there.

Thanks for the feedback of the service names. We'll be adding translations for it in the next version of the plugin.

I highly recommend incorporating the hasNonstandardCharacteristics option if you are using the API that requires it due to nonstandard packages:

Package is nonstandard. Nonstandard packages include cylindrical tubes and rolls, certain high-density items, cartons containing more than 24 ounces of liquids in one or more glass containers, cartons containing 1 gallon or more of liquid in metal or plastic containers, and items in 201.7.6.2.

That is common in several of the clients I work with.

I'll see if I can obtain a USPS account number, as it appears that this is only available to business accounts, not regular USPS or developer accounts.

Hi,

Thanks for your feedback. That's something we can add. We'll look into it. Note that this flag is only available for domestic shipping. The international rates API doesn't have that flag (which is why we didn't add it in the first version of the plugin): developers.usps.com/internationalpricesv...ration/get-rate-list

Regarding the USPS account number, you can try the change I proposed a few hours ago here:
www.hikashop.com/forum/19-hikamarket/909...s/368326.html#368330
Maybe it can help use the plugin without a USPS account number.