Connecting Carriers — Shiprocket & Delhivery
Connect Shiprocket and Delhivery, understand credentials and wallet balance, and run both providers together with automatic failover.
Before you can ship your first order, connect at least one shipping provider. Most merchants use Shiprocket, India's largest shipping aggregator — it gives you access to Blue Dart, Amazon Logistics, DTDC, Delhivery, Xpressbees, and many more couriers through one account.
Connecting Shiprocket
Open the Shiprocket plugin page
Go to Extensions → Plugins → Shiprocket in your admin panel.
Enter your Shiprocket credentials
Enter your Shiprocket email address and password — the same credentials you use to log in at shiprocket.com. If you don't have an account yet, create one at shiprocket.in; it takes about five minutes.
Test the connection
Click Test Connection. The platform sends a live ping to Shiprocket and confirms your credentials are valid.
Save
Click Save. The screen shows a green "Connected" badge immediately.
Common mistake
Some merchants confuse Shiprocket's API Key (shown in Shiprocket's developer settings) with the login credentials needed here. BillionBiz connects using your email + password, not the API key.
Wallet balance
Shiprocket uses a prepaid wallet — you buy shipping labels from your wallet funds. Your current balance shows on the Shiprocket settings page. If the balance falls below the threshold you set, the platform warns you before you try to book a shipment. Top up your wallet at shiprocket.in.
Sandbox mode. Want to test the full shipping flow without spending real money or booking real pickups? Switch on Sandbox Mode on the same settings page — all label and tracking calls use Shiprocket's test environment. Switch it off before going live.
Shipping preferences
Also on the Shiprocket settings page, you can set:
| Setting | What it controls |
|---|---|
| Default shipping mode | Surface (road, slower, cheaper) or Express (air/priority, faster, pricier) — used when a shipment is booked without explicitly choosing a mode |
| Default package dimensions | Length, width, height (cm) used as a fallback for any product without its own dimensions — a common starting point is 10 × 10 × 10 cm |
| Default package weight | Grams, used as a fallback when a product has no weight set — 500g by default |
| Courier strategy | Cheapest, Fastest, or Shiprocket Recommended (balances cost, speed, reliability) |
| Auto-Fulfillment | Switch on here to enable automatic shipment booking for all confirmed orders — see Auto-Fulfillment |
Connecting Delhivery (alternative provider)
Go to Extensions → Plugins → Delhivery. Delhivery connects using an API Token rather than a username and password.
Get your API token
Log in to your Delhivery business account at app.delhivery.com, go to Settings → API (or contact your Delhivery account manager), and copy your API token.
Paste it into BillionBiz
Paste the token into the Delhivery plugin page.
Test and save
Click Test Connection to verify, then Save. You can also set your preferred pickup time and default shipping mode (Express or Surface) on this page.
Shipping Provider Preferences — priority order
Once you have providers connected, go to Settings → Shipping Provider Preferences
(/settings/shipping-providers) to control which one is tried first.
If you land here with no provider connected
This screen is also where BillionBiz sends you when a shipment failed to book because no shipping provider is configured at all. With zero providers connected, the screen skips the priority list and Save button entirely — there's nothing to reorder or save yet — and shows a single callout instead: "No shipping provider connected — shipment booking will fail until you connect one," with a Connect Shiprocket button (opens the Shiprocket plugin page) and a smaller "Looking for another carrier (e.g. Delhivery)? View all providers" link to the full Plugins list. Connect a provider from there, then come back to set priority order once you have two or more.
With exactly one provider connected, the screen shows that provider's card (with its Default badge) but hides the drag handle — reordering a single item is meaningless, so the heading reads "Connected provider" instead of "Provider priority order" and there's nothing to drag. Save still works here (it's still how you toggle the provider active/inactive).
With two or more providers connected, the full priority-order list appears: drag rows to reorder, the top active provider is used first, and the rest are tried in order as automatic fallbacks. See Running both providers at the same time below for how failover actually plays out.
Running both providers at the same time
You can connect both Shiprocket and Delhivery simultaneously.
| Situation | What happens |
|---|---|
| Manual shipment booking | You choose which provider to use at the time of booking |
| Auto-fulfillment | The platform uses your configured primary provider; if that provider fails for a pincode, it automatically falls over to the other |
| Rate Calculator | You can select which provider to query |
| COD availability | Checked separately for each provider |
Tip
Keep both connected even if you primarily use Shiprocket. Automatic failover means orders to pincodes Shiprocket can't service will still go out via Delhivery — rather than failing and requiring you to rebook manually.