Troubleshooting

Fix common RedERP ecommerce problems — gateways, stock, emails, recovery, handle, Stripe, and checkout.

Overview

Use this page when checkout, payments, stock, emails, or the store URL fail. Match the exact message when possible.

Symptom / message	What to do
Invalid or inactive payment gateway	Store settings → Payments: add gateway, set Active, Save
No payment methods are configured for this store…	Enable COD and/or Stripe gateway (Active)
Stripe is not configured for this store…	Add `publishable_key` + `secret_key` on the Stripe gateway
Payment link is not configured…	Redirect gateway needs a payment URL in credentials
Please select a payment method.	Shopper must pick a gateway radio
Please select a delivery method.	Add shipping rules or flat shipping rate
Please fill in all required fields.	Email, name, address, city, postal, country
Order was created but payment could not start…	Check Stripe keys / intent API / network
Gateways vs Payment Methods confusion	Gateways = Settings → Payments. Methods page only toggles `active_ecommerce`

Symptom / message	What to do
Out of stock on shop	Qty ≤ 0 while negatives are not allowed. Demo catalogs often have zero or negative stock — pick a product with qty > 0, or adjust stock first.
Insufficient stock for "…" (available: n)	Same as above; create-order and checkout both reject OOS lines
Product "…" is not available for online sale	Turn on E-commerce Management
Product "…" is not active	Activate product status
Product not found	Wrong id / deleted / wrong store
Quantity must be at least 1	Fix line quantity
Order must contain at least one item	Cart empty at submit

Symptom / message	What to do
Store not found	Wrong handle / subdomain; Save handle in settings
store_domain is already taken	Choose another handle
store_domain format is invalid / reserved	Follow handle rules (see Store URL)
Preview URL wrong	Click Save after editing handle
Store name and domain are required	Fill store name and shop handle before Save

Symptom / message	What to do
Recovery link invalid or expired	Cart converted, token bad, or too old — rebuild cart
Storefront fail banner	Same as above; link stripped on checkout fail
No recovery email	Notifications ON + auto recovery ON + cart has email
Manual Recover does nothing	List button needs an email and an unconverted cart; checkout/delete are on View

Symptom / message	What to do
No order emails	Email notifications ON; check provider / From env
No confirmation on Stripe	Wait until paid (webhook/confirm)
Store contact inbox is not configured	Set Reply-to under General
Contact works but orders silent	Contact is not gated by notifications; orders are

Symptom / message	What to do
Webhook signature verification failed	Wrong `whsec` or endpoint; use `/webhooks/stripe-ecommerce`
Paid in Stripe, unpaid in ERP	Fix webhook events / secret
Order is already paid	Duplicate confirm — refresh order

Symptom	What to do
Analytics KPIs all 0 but orders exist	Default range is month-to-date. Widen From/To and click Refresh.
No date filters on the dashboard	Expected — the dashboard has no date picker. Filter by period on Analytics.
Dashboard says Pending / Processing / Fulfilled	Same statuses as New / Preparing / Packed on the Orders list

Ecommerce Emails

Farm Agronomist