Overview
Shippo return labels for refund cases
Connect your Shippo account to Lumtry and a refund case that needs the item back gets a prepaid return label bought on your account. Lumtry follows the carrier tracking, releases the refund when the return is delivered or sends it to inspection, and denies the case if nothing arrives by your deadline.
Overview
What it does
- Buys a prepaid return label on your Shippo account when your policy requires the item back.
- Releases the refund when the carrier shows the return delivered, or sends the case to inspection if your rule asks for one.
- Closes the case as denied when no return arrives by your deadline, and alerts your team once on a tracking exception.
Setup
Set it up
Open Return shipping settings
An Owner or Admin opens Settings, then Return shipping, and picks Shippo.
Paste your Shippo API key
Lumtry checks the key with Shippo before saving it. A rejected key saves nothing, and only its last four characters are ever shown.
Set your return defaults
Choose the return address, default parcel, who pays for the label and the label format.
Connect tracking updates
Rotate the Shippo token in settings to get your private webhook address, shown once, and paste it into Shippo.
Data
What Lumtry reads
- Return shipping rates for your parcel. Lumtry picks the cheapest one.
- Tracking status for each return label, from in transit to delivered or returned to sender.
- Tracking notifications from Shippo, used only as a prompt to re-read the tracker with your key. A scheduled check covers any it misses.
What Lumtry writes
- Prepaid return labels bought on your Shippo account, with a tracker for each one.
- A label refund request when a refund is rolled back, and a best-effort one when the return window closes unused.
FAQ
Frequently asked questions
Whose Shippo account pays for the labels?
Yours. Lumtry never falls back to a shared key. If you set the shopper to pay, the refund is reduced by the label cost.
Can shoppers use a QR code instead of printing?
For USPS domestic labels and Evri in the UK, yes. Other carriers get a printable PDF. Label-free returns are not offered through Shippo, so a label-free request falls back to a QR code, then a PDF.
What if the label purchase fails?
The case parks for a person and the refund does not run until someone resolves it.
How does Lumtry trust Shippo tracking updates?
Shippo does not sign its notifications, so the private token in your webhook address is what Lumtry checks. Lumtry then re-reads the tracker with your key before it changes a case.
Keep reading