E-commerce

Shiprocket website integration: how it actually works

What a Shiprocket integration really moves between your website and the couriers, the data your store needs first, and the settings that decide your shipping bill, COD payouts and what customers see.

Journal cover: Shiprocket website integration, how it actually works
Need a hand with this?

We do this for clients every week.

Start a project →

A Shiprocket integration connects your website to Shiprocket's shipping panel: each new order appears there without anyone retyping the address, a courier is booked from the panel and paid from your Shiprocket wallet, and tracking and delivery status flow back to your website and customer. On WooCommerce or Shopify, the connection itself takes a few clicks. Whether it saves work depends on what surrounds it: box sizes, which orders go across, and who watches delivery problems, the wallet and cash-on-delivery payouts.

What does a Shiprocket integration actually do?

  1. The order reaches Shiprocket. The connection imports orders in the statuses you choose, with the address, items, weight and payment type. Shiprocket's help centre says this sync runs every 30 minutes, or on demand from the Orders screen.
  2. A courier is booked. When you ship the order, Shiprocket picks or suggests a courier by your courier priority (cheapest, fastest, best rated, its recommendation or your own order) and assigns an AWB, the courier's tracking number. The freight comes out of your prepaid wallet here.
  3. Label and pickup. You print the label, and the courier collects the parcel from a pickup address saved in Shiprocket.
  4. Status comes back. Shipped, delivered and other updates are written back to the order on your website.
  5. Problems wait for you. A failed delivery shows up as an NDR (non-delivery report) in Shiprocket, not on your website. Shiprocket asks you to act within 24 hours, choosing a reattempt or a return, and requests a reattempt itself if you don't.
  6. COD money arrives last. Cash the courier collects reaches your bank through Shiprocket on a fixed payout cycle, which its help centre puts at a week or more after delivery. Faster Early COD plans cost extra.

Which connection suits your website?

Your storeHow it connectsWatch for
ShopifyShiprocket's Shopify channelPayment mapping, statuses written back
WooCommerceShiprocket's channel, plus an optional checkout pluginWhich statuses sync; blocked access
Custom (Laravel, PHP)Your developer's code and Shiprocket's APIRetries, webhooks, test orders
No integrationOrders typed or uploaded in the panelFine for a few parcels a week

A note on bias: we build stores on WooCommerce and Laravel rather than Shopify, so the Shopify details here come from Shiprocket's own help pages. Still choosing a platform? The comparison of Shopify, WooCommerce and a custom store covers how each handles Shiprocket, COD and GST invoices.

WooCommerce: the channel and the plugin do different jobs

The channel moves orders and statuses; the optional Shiprocket plugin from WordPress.org adds live courier rates, an estimated delivery date and a pin code check to your product and checkout pages. It needs each product's weight in kilograms and dimensions in centimetres, plus a fallback flat rate for pin codes no Shiprocket courier serves, so checkout keeps taking orders you may struggle to ship unless you block those pin codes. If orders stop syncing after a server move or a new security plugin, check that the WooCommerce REST API is still on and reachable, then reconnect the channel.

Custom stores: what your developer builds

A Laravel or other custom store sends each order to Shiprocket's API with your order number as the reference, books the courier and receives tracking updates through a webhook. Shiprocket's API documentation warns that requests made with valid credentials "will affect the real-time data" in your account, so tests create real orders, and any courier booked while testing must be cancelled. It also asks that the webhook address avoid words such as "shiprocket" and "sr". Ask your developer how a failed booking is retried and who hears about it.

What must your store hold before you connect?

  • Packed weight and box size for every product. Shiprocket charges on the higher of the weight you enter and the volumetric weight, which for most couriers is length × breadth × height in centimetres divided by 5,000. A Kandivali maker's 600 g bottle of hair oil, bubble-wrapped in a 30 × 25 × 10 cm box, is charged on at least 1.5 kg.
  • Pickup addresses. Every place parcels leave from must be added in Shiprocket first. A Malad kurta label that packs at home but sends bulk orders from a Goregaon godown needs both, plus a rule for which orders leave from where.
  • Addresses a courier can find. Separate fields for flat and building, street and area, landmark, pin code and mobile. When a courier marks an address incomplete, Shiprocket's NDR form asks you for a landmark anyway.
  • Invoice details. Product names, HSN codes and values travel with each order. Parcels above the e-way bill limit need an e-way bill number on the order, which Shiprocket prints on the label and passes to the courier; the limit isn't the same for every route, so ask your CA.

Which settings decide what customers see and what you pay?

  • Which orders go across. In WooCommerce, Pending payment means no payment yet, and Processing means paid and awaiting fulfilment. Sync Processing only, so abandoned checkouts never reach a courier. For made-to-order items, or COD orders you confirm by phone, a custom "ready to ship" status that only your team sets works better.
  • COD or prepaid, for every payment method. A Razorpay order that arrives as COD has the courier asking the customer to pay twice, and a COD order that arrives as prepaid goes out with no cash collected. Shiprocket's channel settings include a "map payment statuses" option for this; whatever the platform, test one order per payment method.
  • Two shipping prices. The customer pays whatever your store's settings say (free, flat or live rates through the plugin), while Shiprocket debits the courier's freight and COD charge from your wallet, so price your checkout charge with that bill in mind. If you are GST-registered, any delivery or COD fee you charge is taxed at the goods' rate, as the GST guide for online stores explains.
  • Who talks to the customer. Shiprocket can send tracking updates under the brand name set on the channel. If your store emails tracking too, customers hear everything twice, so choose one sender.

Where does the money go?

Shiprocket runs on a prepaid wallet, and its guide to passbook charges explains each entry. Freight is debited when an order is processed and credited back if you cancel before pickup. COD orders carry a COD charge, reversed if the parcel returns to origin, while the return trip adds RTO freight. Every booking needs enough balance in the wallet, so give one person the job of watching it.

Weight is the other surprise. When a courier's measurement comes out higher than yours, Shiprocket raises a weight discrepancy and holds the extra amount. Its weight dispute page gives you 7 working days to dispute it with images of the product, after which an unanswered discrepancy is accepted and debited from your wallet. Photograph packed boxes on a scale with the dimensions visible, filed by order number.

Your website may show a COD order as complete once it is delivered, but the cash arrives later in a combined payout. Match Shiprocket's COD remittance report against your orders every week, and share the passbook with your CA.

Who should hold the logins and keys?

Open the Shiprocket account in your business's name, complete the KYC yourself and add your own bank account for COD payouts. If a freelancer opens it on their own KYC, your COD money goes to the bank account they added.

Then give developers access without your password: Shiprocket's API documentation has you create an API user with its own email, choose the modules it can reach and decide whether it sees buyers' details. On WooCommerce, the keys Shiprocket uses sit under WooCommerce, Settings, Advanced, REST API, where you can revoke them if you change agencies.

Shiprocket and its couriers see your customers' names, phone numbers and addresses, so say so in your privacy policy. Our free privacy policy generator adds courier and delivery partners when you tick "Online orders and delivery".

Finally, test as if it were live, because it is. Place one prepaid and one COD order to your own address, follow each to delivery, and cancel spare test shipments before pickup, since Shiprocket can't cancel a parcel the courier already has.

Shiprocket launch checklist

  • Packed weight and box size on every product and variant
  • Only paid or confirmed orders sync, each with the right COD or prepaid type
  • A checkout shipping charge priced against the courier bill
  • One named person for the wallet, NDRs and weight disputes
  • COD payouts matched to orders every week
  • Account, KYC and bank in the business's name; developers on revocable access
  • Prepaid and COD test orders followed through to delivery

FAQs

Does Shiprocket charge to connect my website?

Shiprocket's WooCommerce page says adding the WooCommerce channel costs nothing extra. You pay per shipment from your wallet (freight by weight and zone, plus COD charges), and extras such as WhatsApp tracking updates cost more, so check current rates in your panel. On a custom store, the main cost is the developer's time to build and maintain the API link.

Can I deliver local orders myself and use Shiprocket for the rest?

Yes, if the store keeps them apart. A Bandra bakery that couriers cookie boxes across India but sends its own rider to Khar and Santacruz can give those orders a separate shipping method and a status Shiprocket doesn't sync. Otherwise local orders clutter the panel and can be booked by mistake.

Why does my website mark orders complete before the courier collects them?

Usually the status mapping. Shiprocket's push order status mapper, in each channel's settings, decides which store status each Shiprocket status becomes, and a default mapping applies if you leave it off. WooCommerce emails the customer when an order is marked Completed, so check how early stages such as label generated or pickup scheduled are mapped, and keep Completed for delivered orders.

Can customers track orders on my own website?

Yes. A custom store can show the latest courier status on the order page from the webhook updates it already receives. Shiprocket also offers a branded tracking page with your logo, name and support details, to link from order emails and the order page.

If you are planning a store, or your Shiprocket link keeps letting orders slip, our ecommerce development service builds WooCommerce and Laravel stores with Shiprocket, Razorpay, COD and GST-ready invoices, and tests shipping and cancellations before launch. Tell us what you sell and where you ship from, and after a short call we'll send a fixed written quote. You are welcome to hold our work up against the checklist above.

Amey Arora

Written by

Amey Arora · Founder, Social Dealers

Amey Arora founded Social Dealers in 2012 and runs the studio from Andheri West, Mumbai. He works directly with clients on their websites, online stores, platforms and search.

Got something to grow?

Let’s make
it bigger.