Troubleshooting

What to check when products, orders, downloads or shipping behave unexpectedly in the e-commerce addon.

2 min readUpdated 3 August 2026troubleshooting, orders, downloads

The addon is not enabled, or the role lacks the e-commerce access permission. Check Admin → System → Extensions, then the role. A missing menu is far more often permissions than a broken install.

Check three things in order: the product's own status, its category's status, and whether it has stock. A published product inside an unpublished category does not appear, and that is the one people miss.

Pending means payment has not confirmed. Crypto payments confirm on-chain, so they are pending until they have enough confirmations — that is normal, not a fault. If it never moves, look at the transaction on the wallet side rather than at the order.

Digital delivery is tied to the order reaching a paid state. If the payment confirmed and the download did not unlock, check the order status first, then that the product actually has a file attached — a digital product with no file sells perfectly well and delivers nothing. See Digital delivery.

Download access is bounded per order. If customers complain about losing access, check the expiry against what you told them at checkout.

The address has no matching shipping rule. Rules are matched on destination, so a country you have not covered offers nothing and the customer cannot complete the order. See Shipping.

Check the code's status, its date window, its usage limit, and whether the cart actually meets its minimum. A code that has hit its limit fails the same way as one that is misspelled. See Discounts.

Stock decrements when an order is paid, not when it is placed, so two customers can check out the last item simultaneously. If this matters for your goods, keep a buffer rather than relying on the count being exact.

If the symptom is not specific to the shop, the platform-wide Troubleshooting page covers processes, ports and licence faults that surface as addon problems.