Forums / Addon Shipping Modules / Shipstation email requiring immediate update.

Shipstation email requiring immediate update.

Started by spyderrobotics on 21 Oct 2026, 10:12 PM · Views: 205

Results 1 to 14 of 14
21 Oct 2026, 10:12 PM
#1
spyderrobotics avatar

spyderrobotics

New Zenner

Join Date:
Oct 2007
Posts:
80
Plugin Contributions:
0

Shipstation email requiring immediate update.

I received the following email this afternoon

We strongly recommend that you immediately update the ShipStation application plugin on your account on Zen Cart to the latest version to patch a critical issue.

 

During our routine security assessment and review of our services, we identified the issue that impacts the ShipStation plugin currently used by your business.

 

In order to maintain protection of data related to your customers and your business, we strongly recommend that you promptly upgrade to the latest plugin version 2026.10.20 available at https://ss.shipstation.com/content/integration/ZenCart/shipstation_zc.zip

We will cease support of the older version on Oct 26th, 2026.

I am running zencart 2.2.2 and version 2.3 of the pluggin released oct 30 2025 and everything has been working great. Looking at their download it appears to be for the older zencart sites. It doesn't work with 2.2.2.

I am worried that my company is about be affected if they drop support. I am not sure if the 2.3 may already have the options they are looking for?

I contacted shipstation support and they passed on the info to their team but I do not have an answer currently.

22 Oct 2026, 8:44 AM
#2
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,753
Plugin Contributions:
56

Re: Shipstation email requiring immediate update.

We're working on this now. Please don't use the version Shipstation sent you - watch the official download in the plugins library for the update.

https://www.zen-cart.com/plugins/shipstation-usps-ups-and-fedex-shipping-module-vb1324

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

22 Oct 2026, 1:46 PM
#3
spyderrobotics avatar

spyderrobotics

New Zenner

Join Date:
Oct 2007
Posts:
80
Plugin Contributions:
0

Re: Shipstation email requiring immediate update.

Awesome! Thank you for your hard work! I did my best comparing files between what they released and the older version of the pluggin but other than changing names to add SAFE and I didn't understand what they were doing different. I knew I needed to leave it up to the Pros. 😄

22 Oct 2026, 6:06 PM
#4
drbyte avatar

drbyte

Sensei

Join Date:
Jan 2004
Posts:
63,511
Plugin Contributions:
176

Re: Shipstation email requiring immediate update.

Update posted:

https://www.zen-cart.com/plugins/shipstation-usps-ups-and-fedex-shipping-module-vb1324

Easy install: unzip, and copy the shipstation_zc.php file overtop of the one already on your server. It takes effect immediately.

.
Zen Cart - putting the dream of business ownership within reach of anyone!
Donate to: DrByte directly or to the Zen Cart team as a whole

Remember: Any code suggestions you see here are merely suggestions. You assume full responsibility for your use of any such suggestions, including any impact ANY alterations you make to your site may have on your PCI compliance.
Furthermore, any advice you see here about PCI matters is merely an opinion, and should not be relied upon as "official". Official PCI information should be obtained from the PCI Security Council directly or from one of their authorized Assessors.

22 Oct 2026, 8:33 PM
#5
spyderrobotics avatar

spyderrobotics

New Zenner

Join Date:
Oct 2007
Posts:
80
Plugin Contributions:
0

Re: Shipstation email requiring immediate update.

Thank you for looking into that! I updated my cart and so far no errors. Crossing my fingers 10/27 will be drama free. LoL. Donation sent. 🙂

25 Oct 2026, 11:11 PM
#6
Join Date:
Oct 2026
Posts:
1
Plugin Contributions:
0

Re: Shipstation email requiring immediate update.

My store is running zencart 1.7.5d. I have been unable to replace the current shipstation plugin with ANY of the versions I can find on the github, here, or from shipstation. Every one I try errors out in some way.

Am I just screwed because we are running too old of a version of zencart? Looking at the process for updating zencart makes it appear like it will be quite a chore to bring it up to current...

help???

3 Nov 2026, 10:15 AM
#7
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,753
Plugin Contributions:
56

Re: Shipstation email requiring immediate update.

You really ought to upgrade. Quick guide here:

https://docs.zen-cart.com/user/upgrading/db_only_upgrade/

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

4 Nov 2026, 10:20 AM
#8
mprough avatar

mprough

Totally Zenned

Join Date:
Nov 2007
Location:
Woodbine, Georgia, United States
Posts:
4,329
Plugin Contributions:
41

Re: Shipstation email requiring immediate update.

drbyte:

Update posted:

https://www.zen-cart.com/plugins/shipstation-usps-ups-and-fedex-shipping-module-vb1324

Easy install: unzip, and copy the shipstation_zc.php file overtop of the one already on your server. It takes effect immediately.

I have only a couple of clients using this. However, this update does not work for them. Shipstation has no clue & has nothing to say except to give me a HUGE GOB of IP addresses to white list. This did not work either. Fact is, if they are misbehaving I cannot stop them from getting caught in the WAF and they can't seem to provide any time, detail or error for me to work from.

Any suggestions are helpful. XPS shipping plugin works fine, no other remote services reported as an issue at all... ONLY ShipStation.

~Melanie

6 Nov 2026, 10:51 AM
#9
mprough avatar

mprough

Totally Zenned

Join Date:
Nov 2007
Location:
Woodbine, Georgia, United States
Posts:
4,329
Plugin Contributions:
41

Re: Shipstation email requiring immediate update.

mprough:

drbyte:

Update posted:

https://www.zen-cart.com/plugins/shipstation-usps-ups-and-fedex-shipping-module-vb1324

Easy install: unzip, and copy the shipstation_zc.php file overtop of the one already on your server. It takes effect immediately.

I have only a couple of clients using this. However, this update does not work for them. Shipstation has no clue & has nothing to say except to give me a HUGE GOB of IP addresses to white list. This did not work either. Fact is, if they are misbehaving I cannot stop them from getting caught in the WAF and they can't seem to provide any time, detail or error for me to work from.

Any suggestions are helpful. XPS shipping plugin works fine, no other remote services reported as an issue at all... ONLY ShipStation.

~Melanie

Following up on my earlier report of the issue, I traced a reproducible startup problem on the affected stores. I initially was thinking firewall filtering/WAF, but I found a conflict between ShipStation's action parameter and Zen Cart's shopping-cart initialization.

The cart-handler initialization file, v2.2.0 version comment, contains:

if (isset($_GET['action'])) {
  /**
   * redirect the customer to a friendly cookie-must-be-enabled page if cookies are disabled
   */
  if ($session_started == false) {
    zen_redirect(zen_href_link(FILENAME_COOKIE_USAGE));
  }

The connector loads application startup before instantiating its listener. So, a request containing action=export, action=update, or action=verifystatus can enter the storefront cart-action handler before the connector processes its own action.

I reproduced this from the server without credentials, using a status-verification request that does not export orders or update shipments:

curl -sS --max-time 30 -D - \
'https://XXX/XXX?action=verifystatus&status=0'

Before the change, the response was:

HTTP/2 302
location: https://XXX/XXX?main_page=cookie_usage

There was no X-CustomStore-Version response header and no ShipStation diagnostic log entry. Indicating that startup redirected the request before the listener and its logging code could run.

For this cart, I temporarily isolated the connector's action parameter during application startup. The original application-top include was replaced with the following code. The include path is redacted here as XXX:

// Keep ShipStation actions out of Zen Cart's shopping-cart handler.
$shipstationHasAction = array_key_exists('action', $_GET);
$shipstationAction = $_GET['action'] ?? null;
unset($_GET['action']);

require 'XXX';

// Restore the action for the ShipStation listener.
if ($shipstationHasAction) {
    $_GET['action'] = $shipstationAction;
}
unset($shipstationHasAction, $shipstationAction);

No core files were changed. Repeating the request:

HTTP/2 401
x-customstore-version: 2026.10.20
www-authenticate: Basic realm="ShipStation"

Unauthorized

That 401 is expected for this deliberately unauthenticated test. The important difference is that the request now reaches the listener, and its diagnostic log is created:

Request shape: method=GET action=verifystatus
credentials: basic=no ss-headers=no querystring=no

Error 401
Failed login: blank username and/or password

I also double checked the server firewall to verify saved whitelist IPs:

  • All 52 supplied ShipStation addresses were present in the active CSF IPSET allow set and in its persistent allow file.
  • Incoming allow rules execute before the deny lists, country restrictions, and connection limits.
  • Outgoing allowances precede outgoing deny rules.
  • The separate legacy IPv4 filter, nat, and mangle tables contained zero rules, with ACCEPT policies throughout.

The historical access logs show another issue that remains unresolved. The last recorded HTTP 200 from the connector endpoint was October 22 at 05:03 server local time. All recorded endpoint requests on October 23-25 returned 401, and genuine ShipStation requests on November 5 also returned 401. Those old auth failures cannot quite be connected to the cookie redirect.

The connector being investigated is a locally modified copy identifying itself as build 2026.10.20

I do not have access to the client's ShipStation account to initiate a refresh on demand. I have confirmed that the startup redirect is resolved and diagnostic logging works, but I have not confirmed a successful authenticated import or shipment update. The next actual ShipStation request should let us find the issue: missing credentials, an invalid password, or an account lockout.

Is temporarily withholding $_GET['action'] during application startup an appropriate approach here?

or is there a better mechanism for keeping the SS connector out of storefront cart-action handling?

~Melanie

6 Nov 2026, 3:34 PM
#10
mprough avatar

mprough

Totally Zenned

Join Date:
Nov 2007
Location:
Woodbine, Georgia, United States
Posts:
4,329
Plugin Contributions:
41

Re: Shipstation email requiring immediate update.

Following up on my previous post, the affected shop is now connecting and exporting orders successfully. I am waiting for the second to complete their refresh, but I expect the updated module file will work as it did already for my first case.

I confirmed three separate issues trying to fix this:

  1. Startup conflict: ShipStation's action parameter was being processed by Zen Cart's storefront cart-action handler during application startup. Requests without a session redirected to cookie_usage before the ShipStation listener or its logging ran. Temporarily removing $_GET['action'] before loading application startup, then restoring it afterward, resolved the reproduced redirect without changing core files.
  2. Authentication failures and lockout: Once requests reached the listener, logging showed password validation failures for an existing account, followed by its temporary lockout. Another attempt used a username that did not exist. After a new, tested admin account was configured for the connection, authenticated requests succeeded.
  3. Stale error in ShipStation: The client continued seeing the earlier 401 error even after the server recorded successful requests. Logging out of ShipStation and back in cleared that stale error, and the client confirmed the connection was resolved.

The successful requests verified the pending, processing, and shipped statuses, then exported 267 orders.

One additional finding: this client's actual ShipStation requests are still supplying SS-UserName and SS-Password as query-string parameters. The diagnostic log reported:

credentials: basic=no ss-headers=no querystring=yes

Therefore, query-string credential support is still required for this connection. We did not observe HTTP Basic authentication or the alternative authentication headers in these requests.

The firewall investigation found all 52 supplied addresses actively allowed, with allow rules preceding blocking rules. The legacy IPv4 tables were empty with ACCEPT policies. No further firewall changes were needed for the successful connection.

Authenticated access, status verification, and order export are now confirmed. Shipment updates back to Zen Cart have not yet been verified. I would still appreciate your recommendation on the preferred way to prevent the connector's action parameter from entering storefront cart-action handling during startup.

It would appear by the crickets I hear in here that I am maybe the only one with this issue. So just in case I attached my changes to assist others.

~Melanie

6 Nov 2026, 4:22 PM
#11
spyderrobotics avatar

spyderrobotics

New Zenner

Join Date:
Oct 2007
Posts:
80
Plugin Contributions:
0

Re: Shipstation email requiring immediate update.

mprough:

It would appear by the crickets I hear in here that I am maybe the only one with this issue. So just in case I attached my changes to assist others.

~Melanie

While I can't give you any advice on your issue my zencart 2.2.2 running on my site with php 8.5.12 has worked fine with the v2.4 and v2.5 updates. At some point I had done a reconnection though shipstation to my cart. I don't know if that has any relevance. My site through siteground also has caching so I cleared my sites cache since sometimes after updates things can get a little wonky. We have both usps ( usps restful plugin) and the UPSoauth plugin. Everything is importing properly and the site is getting the tracking info returned properly.

6 Nov 2026, 4:25 PM
#12
mprough avatar

mprough

Totally Zenned

Join Date:
Nov 2007
Location:
Woodbine, Georgia, United States
Posts:
4,329
Plugin Contributions:
41

Re: Shipstation email requiring immediate update.

spyderrobotics:

mprough:

It would appear by the crickets I hear in here that I am maybe the only one with this issue. So just in case I attached my changes to assist others.

~Melanie

While I can't give you any advice on your issue my zencart 2.2.2 running on my site with php 8.5.12 has worked fine with the v2.4 and v2.5 updates. At some point I had done a reconnection though shipstation to my cart. I don't know if that has any relevance. My site through siteground also has caching so I cleared my sites cache since sometimes after updates things can get a little wonky. We have both usps ( usps restful plugin) and the UPSoauth plugin. Everything is importing properly and the site is getting the tracking info returned properly.

I had 2 failing installations, only 2 of my clients use ShipStation both failed.

  1. Zen Cart 2.2.2 & PHP 8.5.12
  2. Zen Cart 2.1.0 & PHP 8.3.36
6 Nov 2026, 4:43 PM
#13
spyderrobotics avatar

spyderrobotics

New Zenner

Join Date:
Oct 2007
Posts:
80
Plugin Contributions:
0

Re: Shipstation email requiring immediate update.

Unfortunately I am just a user and fumble around enough to get my cart going so forgive my advice if you well beyond it. Ha! In my shipstation under Settings>Selling Channels> Store Setup> (store name) > Actions > Edit Connection

In there my shipstation_zc.php is in the root of my website. The admin username and password are there too.

Maybe try creating a new admin in zencart with a new password. Then go into shipstation (path above) and put the new credentials and confirm its pointing to the right path and try the TEST CONNECTION option there. See if it passes and if so see if everything works.

6 Nov 2026, 4:57 PM
#14
mprough avatar

mprough

Totally Zenned

Join Date:
Nov 2007
Location:
Woodbine, Georgia, United States
Posts:
4,329
Plugin Contributions:
41

Re: Shipstation email requiring immediate update.

spyderrobotics:

Unfortunately I am just a user and fumble around enough to get my cart going so forgive my advice if you well beyond it. Ha! In my shipstation under Settings>Selling Channels> Store Setup> (store name) > Actions > Edit Connection

In there my shipstation_zc.php is in the root of my website. The admin username and password are there too.

Maybe try creating a new admin in zencart with a new password. Then go into shipstation (path above) and put the new credentials and confirm its pointing to the right path and try the TEST CONNECTION option there. See if it passes and if so see if everything works.

My findings are many days passed initial troubleshooting. I have about 8 hours in troubleshooting this server logs for days, greps in my sleep and very little at that. It's a big deal when my customers cannot ship. I posted in order to help others, the research is all posted for "the powers that be" and THAT is what the user forum is for =) I wasn't soliciting your advice =)