Notes/Debugging

Courier state is not order status

2025-08-29

When a customer asks where the order is, “processing” in your database is not an answer. Shopenup lets Shiprocket webhooks update fulfillments. Returns persist AWB and payloads when admin accepts a reverse pickup. If those payloads are discarded, you debug from screenshots of the courier dashboard. The other recurring miss is treating checkout success as paid. Razorpay and Cashfree still need the webhook. COD still needs the remaining capture. Merchant decline still needs to cancel before a label exists. Match the courier event to the fulfillment row, then to the order. Do not invent a status because the storefront already showed a thank-you page.