Dodo Migrate

Dodo Migrate is a CLI tool designed to help you safely and efficiently migrate your data from popular payment providers into Dodo Payments. Whether you're moving products, customers, or discount codes, Dodo Migrate guides you through a secure, auditable, and repeatable migration process with interactive prompts and sensible defaults.

Supported providers:

• Lemon Squeezy
• Stripe
• Gumroad
• 2Checkout
• FastSpring
• Paddle

Supported models:

• Products
• Discount codes
• Customers

Contents

• Features
• Requirements
• Install
• Quick start
• CLI reference
• Providers
• Examples
• Update / Uninstall
• Roadmap
• Contributing
• License

Features

• Safe, confirm-before-write migration flow
• Interactive prompts with sensible defaults
• Works with Dodo Payments test or live environments
• Incremental, repeatable runs

Requirements

• Node.js ≥ 18 (for native fetch used by the CLI)
• Provider API key and Dodo Payments API key

Install

npm i -g dodo-migrate

Quick start

Migrate from Lemon Squeezy to Dodo Payments:

dodo-migrate lemonsqueezy

Migrate from Stripe to Dodo Payments:

dodo-migrate stripe

You'll be prompted for any missing inputs (API keys, brand selection, environment).

CLI reference

Global usage:

dodo-migrate <provider> [options]

Options (all optional; interactive prompts will fill in when omitted):

option	values	description
--provider-api-key	string	Provider API key (e.g., Lemon Squeezy)
--dodo-api-key	string	Dodo Payments API key
--mode	test_mode / live_mode	Dodo Payments environment (default: test_mode)
--dodo-brand-id	string	Target Dodo Payments brand ID

Helpful commands:

dodo-migrate --help
dodo-migrate lemonsqueezy --help

Providers

Detailed, provider-specific docs:

• Lemon Squeezy → Dodo Payments
• Stripe → Dodo Payments

Examples

• Minimal migration from Lemon Squeezy (interactive):

dodo-migrate lemonsqueezy

• Minimal migration from Stripe (interactive):

dodo-migrate stripe

• Non-interactive run (all flags provided):

dodo-migrate lemonsqueezy \
  --provider-api-key=lsq_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX

dodo-migrate stripe \
  --provider-api-key=sk_test_XXXXXXXXXXXXXXXX \
  --dodo-api-key=dp_XXXXXXXXXXXXXXXX \
  --mode=test_mode \
  --dodo-brand-id=brand_XXXXXX \
  --migrate-types=products,coupons

Update / Uninstall

npm update -g dodo-migrate
npm uninstall -g dodo-migrate

Roadmap

• Add more providers
• Add more data options per provider

Contributing

Interested in contributing? See contributing.md for guidelines.

License

GPL-3.0 © Dodo Payments. See LICENSE.