Plumtier Docs Deploy free

Move from another store

Bring your customers, past orders and license keys, so apps you've shipped keep working.

If you sold somewhere else, your buyers already have license keys inside your apps. Import them with their customers and orders, and your buyers keep their keys, can sign in to My purchases, and your apps keep working once they point at your store.

What comes over

GumroadLemon SqueezyAny store, by script
CustomersYesYesYes
Past orders and refundsYesYesYes
License keys, as they areYesYesYes
Disabled and expired keysDisabledYesYes
Activation limitsFrom your productYesYes
Activated devicesNo, it keeps only a use countYes, same instance_idYes

Imported orders are history. They don't send receipts or webhooks, don't pay affiliates, and don't count toward stock or price steps. Importing is a Plumtier Pro feature Pro.

Import

  1. Create your products in Plumtier and turn on License keys.
  2. Get your export (below), then open License keys → Move from another store and upload it. The file is read in your browser.
  3. Match each old product to a Plumtier product, or skip it. Products with the same name are matched for you.
  4. Check the counts and choose Import. It runs in small parts. Running it again only adds what's missing, so you can import again after more sales come in.

From Gumroad

Export your sales as a CSV from Gumroad's sales page, covering all dates, and upload it. It includes each license key, how often it was used, and whether it was disabled or refunded.

Important
Gumroad doesn't record devices, and its apps check keys with Gumroad's own verify request. Ship an app update that calls your store's activate and validate endpoints. On the first check, the app activates once: the key is valid, it just has no devices yet.

From Lemon Squeezy

Lemon Squeezy's CSV exports leave out license keys, so a small script reads them from its API on your computer. Create an API key in your Lemon Squeezy settings, then run this from your Plumtier folder:

Terminal
LEMONSQUEEZY_API_KEY=your-key npm run export:lemonsqueezy

It writes lemonsqueezy-export.json. Upload that file, then delete it: it holds your buyers' emails and keys. Your API key goes only to Lemon Squeezy, never to Plumtier.

Your apps send the same fields to Plumtier (license_key, instance_name, instance_id), and devices keep their instance_id, so an update usually only changes the base address. Check the response fields in Validate a key.

From any other store

Write a JSON file in this shape, from your own script, and upload it. Money is in minor units (cents) and times are UTC seconds.

import.json
{
  "version": 1,
  "source": "mystore",
  "products": [{ "externalId": "app-1", "name": "My App" }],
  "customers": [{ "email": "ann@example.com", "name": "Ann", "country": "DE" }],
  "orders": [{
    "externalId": "1001", "productExternalId": "app-1", "variantName": "",
    "email": "ann@example.com", "name": "Ann", "currency": "usd", "quantity": 1,
    "subtotal": 2900, "discount": 0, "tax": 0, "total": 2900, "refunded": 0,
    "status": "paid", "createdAt": 1767225600
  }],
  "licenses": [{
    "key": "AAAA-BBBB-CCCC-DDDD", "productExternalId": "app-1", "orderExternalId": "1001",
    "email": "ann@example.com", "status": "active", "activationLimit": 2,
    "expiresAt": null, "note": "", "createdAt": 1767225600
  }],
  "instances": [{ "id": "device-uuid", "licenseKey": "AAAA-BBBB-CCCC-DDDD", "name": "Ann's Mac", "createdAt": 1767225600 }]
}
  • status of an order: paid, refunded or partially_refunded. Of a key: active, inactive, expired or disabled.
  • Leave out activationLimit to use the product's limit; null means unlimited.
  • An instance id is the instance_id your apps already send.

Just a list of keys

If you only have keys, open License keys → Make or import → Import existing keys and paste them, one per line.

Point your app at your store

Your app sendsPlumtier
license_keySame name. Case and spaces don't matter.
instance_nameSame name, on activate.
instance_idSame name, on validate and deactivate.
a product checkproduct_id: your product's link or id.