Shippo Shipping: Full Guide & Integration

LiteShop Shippo (liteshop-shippo) connects LiteShoper Commerce to Shippo for worldwide multi-carrier shipping: live rates at checkout, label purchase, PDF print, and tracking sync.

On this page: Overview · Prerequisites · Create Shippo account · API tokens · Install plugin · Settings · Warehouse & parcel · Services · Webhooks · Checkout rates · Labels · Tracking · Checklist · Troubleshooting

1. Overview

• Live carrier rates at checkout (USPS, UPS, FedEx, DHL, and more — depends on Shippo account / origin)
• Works worldwide; for Malaysia & Singapore it can appear alongside EasyParcel so buyers choose
• Per-service enable/disable + flat markup
• One-click and bulk label create / print from Orders
• Tracking updates via Shippo webhooks
• Separate live vs test API tokens

Plugin page: liteshoper.com/plugins/liteshop-shippo

2. Prerequisites

• LiteShoper store with Commerce enabled
• HTTPS recommended (required for reliable webhooks)
• liteshop-shippo marketplace license + plugin activated
• A warehouse / ship-from address and realistic product weights (or default parcel)
• A free or paid Shippo account

3. Apply / create a Shippo account

1. Open https://goshippo.com/ and sign up
2. Or go straight to the dashboard: https://apps.goshippo.com/
3. Complete account setup (business/contact details as prompted)
4. Optional: connect carrier accounts in Shippo if you use your own UPS/FedEx/etc. contracts; otherwise use Shippo’s platform rates where available

Docs: Shippo documentation · API: API quickstart

4. Get Live & Test API tokens

1. Sign in to Shippo Dashboard
2. Open Settings → API (or Developers / API tokens)
3. Copy the Live token (often starts with shippo_live_)
4. Copy the Test token (often starts with shippo_test_)
5. Keep them separate — Test mode charges nothing; Live purchases real labels

Auth header used by LiteShoper: Authorization: ShippoToken YOUR_TOKEN against https://api.goshippo.com.

5. Install LiteShop Shippo

1. Purchase / install from LiteShoper → LiteShop Shippo
2. Activate the plugin
3. Open admin menu Shippo (Settings, Services, Shipments)

6. Enter credentials in LiteShoper

Go to Shippo → Settings:

1. Paste Live API token and Test API token
2. Enable Test mode while verifying (uses test token, no real charges)
3. Enable Shippo shipping at checkout when ready
4. Optional: Auto-purchase labels on bulk arrange from Orders
5. Click Save Settings, then Test API

7. Sender (warehouse) address

Required for rate quotes and label purchase. Enter the address packages ship from:

• Name, company, email, phone
• Street, city, state/region, postcode/ZIP
• Country as 2-letter ISO (e.g. US, MY, SG, GB)

8. Default parcel

Fallback when a product has no weight. Units in LiteShoper settings:

• Weight in kg
• Length / width / height in cm

Set realistic defaults so checkout rates aren’t absurdly cheap/expensive.

9. Sync & enable carrier services

1. Open Shippo → Services
2. Click Sync services from Shippo (needs token + sender address)
3. Enable only the services you want at checkout
4. Optional flat markup per service
5. Save. New services may also appear automatically when checkout loads rates

10. Webhooks (tracking)

1. In LiteShoper → Shippo → Settings, copy the Webhook URL (includes a secret ?token=…)
2. In Shippo Dashboard, create a webhook / endpoint for tracking (and related) events
3. Paste that exact URL
4. Keep the webhook secret in LiteShoper settings — requests without the token or a valid HMAC are rejected

Webhook path: POST https://YOUR-STORE.com/shippo/webhook?token=YOUR_SECRET

Shippo may send Shippo-Auth-Signature (t=…,v1=…); LiteShoper verifies when present.

11. Checkout rates

1. Ensure Shippo is enabled and Test/Live mode is intentional
2. Add products with weight (or rely on default parcel)
3. At checkout, enter a full delivery address (street, city, ZIP, country)
4. Live Shippo services appear as shipping methods
5. On MY/SG stores with EasyParcel installed, both can show and the customer chooses

12. Purchase & print labels

1. After payment, open the order in admin
2. Use Create Shippo label (uses the rate the customer selected)
3. Or bulk-create from Orders using arrange / bulk label actions
4. Print PDF from order view, Shipments list, or bulk print
5. Review history under Shippo → Shipments

13. Tracking

• Tracking updates can arrive via webhook
• You can also refresh tracking from the shipment / order UI when available

14. Admin pages

15. Go-live checklist

1. Shippo account created; live + test tokens saved
2. Test API succeeds in Test mode first
3. Warehouse address + default parcel filled
4. Services synced and enabled
5. Test checkout → rates appear → place order → create test label
6. Webhook URL registered in Shippo
7. Turn Test mode OFF, confirm Live token is set
8. Place a small live order and print a real label once ready

16. Troubleshooting

Official references:
Shippo · Dashboard · Docs · API quickstart · LiteShoper Shippo