skills/sales-merchant-of-record/SKILL.md
Merchant of Record (MoR) and payments-provider selection for SaaS and digital products — when to let a MoR (Paddle, Lemon Squeezy, FastSpring, Polar, Creem, Gumroad) handle global sales tax/VAT for you vs running a self-managed processor (Stripe + Stripe Tax), and which provider fits. Use when deciding how to bill global customers, unsure whether a Merchant of Record should own tax compliance or you should manage it yourself, comparing Paddle vs Lemon Squeezy vs Polar vs Creem vs Stripe on fees and tax coverage, worried about EU VAT / US sales tax / GST nexus, picking a billing provider for a new SaaS, the ~5% MoR fee feeling high, or weighing a costly switch between providers. Do NOT use for Paddle-specific API/config (use /sales-paddle), Lemon Squeezy-specific setup (use /sales-lemonsqueezy), checkout-conversion optimization (use /sales-checkout), subscription churn/dunning tactics (use /sales-membership), or two-sided marketplace seller payouts (use /sales-marketplace-payouts).
npx skillsauth add sales-skills/sales sales-merchant-of-recordInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Helps choose how to bill global customers for SaaS/digital products: whether to use a Merchant of Record (which absorbs global sales-tax/VAT liability for a higher fee) or a self-managed processor like Stripe (lower fee, but you own tax registration + remittance), and which specific provider fits.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user (lead with a best-effort answer if they've already told you most of this):
What's the decision?
What are you selling? Self-serve SaaS subscriptions · B2B SaaS (invoices/POs/net terms) · one-off digital products · usage-based · mobile-app purchases.
Where are your customers? Mostly domestic (one tax jurisdiction) · global (many) — this is the single biggest factor in the MoR-vs-DIY call.
Stage / team? Solo/indie · small team (no finance/tax ops) · scaling with finance ops · enterprise.
Fee sensitivity? Lowest possible fee · willing to pay ~5% to never touch tax.
Skip-ahead rule: if the prompt already provides most of this, go straight to Step 4 with stated assumptions, then ask 1–2 critical clarifiers.
| If the question is about... | Route to... |
|---|---|
| Paddle-specific API, webhooks, Billing-vs-Classic, or config | /sales-paddle {question} |
| Lemon Squeezy-specific setup/API | /sales-lemonsqueezy {question} |
| Gumroad-specific setup/API | /sales-gumroad {question} |
| Checkout-conversion optimization (order bumps, upsells, cart recovery) | /sales-checkout {question} |
| Subscription churn / dunning / retention tactics | /sales-membership {question} |
| Two-sided marketplace seller payouts (paying out many suppliers) | /sales-marketplace-payouts {question} |
| Choosing a billing engine (stay seller of record, keep tax in-house): Chargebee/Recurly/Maxio/Stripe Billing/Zuora/Orb/Lago | /sales-subscription-billing {question} |
| Chargebee-specific API/webhooks/config | /sales-chargebee {question} |
Otherwise, answer from the framework below.
Read references/platforms.md for the full comparison — the MoR-vs-processor distinction, the decision
matrix (Paddle / Lemon Squeezy / Polar / Creem / Gumroad / Stripe) plus the FastSpring and Dodo Payments
sections, per-provider fees, tax coverage, B2B support, and switching costs.
Answer using only the relevant section. Don't dump the whole reference.
Switching MoRs (or MoR→Stripe) forces payment-method re-tokenization (often a customer re-subscribe), subscription migration, and a tax-registration transition. Choose deliberately; migrate only for a real structural reason (outgrowing B2B support, fee at scale, vendor risk).
If you discover something not covered here, append it to references/learnings.md with today's date.
Best-effort from research (2026-06) — fees and tax coverage change frequently; verify on each provider.
/sales-paddle — Paddle platform help (MoR API/webhooks, Billing vs Classic, tax/fee model)/sales-fastspring — FastSpring platform help (enterprise-heritage MoR — REST API/HMAC webhooks, Store Builder Library, B2B invoicing/quotes; quote-based ~5.9%+$0.95 / 8.9% fee)/sales-dodo-payments — Dodo Payments platform help (developer-first MoR — full REST API, 9 SDKs, framework adapters, Standard-Webhooks signing, CLI + MCP server; ~4% + $0.40/txn)/sales-lemonsqueezy — Lemon Squeezy platform help (MoR for indie/self-serve SaaS, license keys, API)/sales-gumroad — Gumroad platform help (creator MoR marketplace, digital products)/sales-subscription-billing — Choosing & operating a billing engine (Chargebee/Recurly/Maxio/Stripe Billing/Zuora/Orb/Lago) when you stay seller of record and keep tax in-house — the other billing decision next to MoR/sales-chargebee — Chargebee platform help (subscription-billing engine on your own gateway — NOT a MoR; API/webhooks, dunning, proration, RevRec)/sales-checkout — Checkout-conversion optimization across tools (order bumps, upsells, cart recovery)/sales-membership — Subscription retention, churn, and dunning strategy/sales-marketplace-payouts — Paying out many suppliers in a two-sided marketplace (the supply side)/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do -a claude-codeUser says: "I'm launching a SaaS selling worldwide. Stripe is cheaper — why would I pay 5% for Paddle or Lemon Squeezy?" Skill does: Explains the MoR value: with Stripe you're the seller of record and must register, calculate, file, and remit VAT/GST/sales-tax in every jurisdiction (Stripe Tax only calculates). For a global product with no finance team, a MoR's ~5% absorbs that entire burden + liability; the international effective Stripe rate also climbs toward ~5%. Recommends a MoR unless they have finance ops or are mostly domestic. Result: A clear MoR-vs-DIY decision grounded in their geography and team.
User says: "B2B SaaS, some customers want to pay by invoice with net-30. Paddle or Lemon Squeezy?"
Skill does: Flags the decisive factor — Lemon Squeezy has no purchase orders / net terms, while Paddle supports B2B invoicing and has the deepest tax coverage. Recommends Paddle for B2B/enterprise selling, routes Paddle setup to /sales-paddle, and notes Lemon Squeezy stays great for the self-serve portion.
Result: Paddle recommended for the B2B requirement, with a setup hand-off.
User says: "Solo dev, tiny revenue, want a merchant of record but the fees hurt. Options?" Skill does: Compares the low-fee end — Creem (lowest fee, newest, vendor risk) and Lemon Squeezy (proven, great DX) — vs Polar (best DX but ~10%). Recommends Creem or Lemon Squeezy for cost, with the caveat to verify Creem's tax coverage and longevity. Notes switching later is costly, so weigh stability. Result: A fee-aware shortlist matched to an indie's risk tolerance.
Symptom: A tax authority (often EU VAT or a US state) claims you owe uncollected tax. Cause: You were on a processor (Stripe/PayPal), so you were the seller of record and liable — Stripe Tax calculates but doesn't remit, and you hadn't registered/filed there. Solution: This is the classic reason to move to a MoR (Paddle/Lemon Squeezy/etc.), which becomes the seller of record and remits going forward. For past liability, consult a tax professional; for the future, a MoR removes the registration/remittance burden. If staying on Stripe, add a tax engine (Anrok/Avalara) and register where you have nexus.
Symptom: The 5% MoR fee looks far worse than Stripe's 2.9%. Cause: Comparing headline rates only, ignoring international surcharges and your own compliance cost. Solution: Compute Stripe's effective international rate (intl card +1.5%, FX +1%, Stripe Tax +0.5% ≈ ~4.9%) and add the labor/accountant cost of registrations + filings. Against that, a MoR's all-inclusive ~5% is often a wash or cheaper once compliance work is priced in — especially for a small team selling globally.
Symptom: Tempted to move for a lower fee or missing feature. Cause: Switching MoRs/processors forces payment re-tokenization (possible customer re-subscribe), subscription migration, and tax-registration changes — real cost and churn risk. Solution: Switch only for a structural reason (outgrowing B2B/invoicing support, fee material at scale, vendor risk), not a small fee delta. Quantify the migration cost and expected churn before moving; otherwise optimize within your current provider.
tools
Wizlogo (wizlogo.com) platform help — a budget online logo maker (template/style-variation, marketed as "AI") plus a hub of FREE branding tools (business-name, blog-name and slogan generators, business-card maker, invoice generator, color converter, domain search). The pricing traps: the FREE logo is PERSONAL-USE-ONLY; the two cheap paid tiers are RASTER PNG/JPG only — Single (~€39.99 one-time) and Unlimited (~€3.99 per WEEK, recurring) — and VECTOR (SVG/PDF/EPS) is gated to the ~€299.99 Enterprise tier, which also bundles human designer edits and a social kit. Transparent PNG is on all paid plans. Use when making a Wizlogo logo, understanding free-vs-paid or personal-vs-commercial use, which tier unlocks vector/SVG for print, the weekly-subscription billing trap, its free name/slogan generators, or whether it has an API (UI-only — no public API, webhooks, Zapier or MCP). Do NOT use to just generate the business name (use /sales-namelix) or to compare/validate branding tools (use /sales-idea-validation).
tools
VistaPrint platform help (vistaprint.com, a Cimpress company) — the small-business design + print + digital-marketing platform: a free AI Logomaker (4 generations, 60 more after free sign-up) exporting SVG/PNG/PDF at 4000x4000 with no watermark, a free Brand Kit, business cards/flyers/signage/apparel/promo print, and a website builder. THE RIGHTS TRAP: VistaPrint states NO intellectual-property rights transfer on an AI-generated logo — you get usage rights but CANNOT register it for trademark or copyright; only its human designer service transfers full IP. Use when making a VistaPrint logo, asking if you own or can trademark it, running out of AI logo credits, printed colors not matching the screen, bleed/DPI/font file-prep rejections, or asking whether VistaPrint has an API (the consumer site does not — automation runs through the parent Cimpress Open partner-fulfilment API). Do NOT use for Vista Social scheduling (use /sales-vistasocial) or comparing logo tools market-wide (use /sales-idea-validation).
tools
Turbologo (turbologo.com) platform help — a budget AI/DIY logo maker: enter a business name + industry, pick icons and colors, and it proposes logo concepts you refine in an in-browser editor, then pay a one-time fee to download (designing is free, previews are watermarked, downloading is the paywall). Vector SVG/PDF is gated to the mid tier and up; the top tier adds a brand kit (business cards, letterheads, email signatures, social assets). Use when generating a logo in Turbologo, choosing which download tier to buy, vector SVG vs raster PNG, removing the free watermark, the time-limited edit-after-purchase window, pay-to-download pricing questions, whether an AI logo is yours to trademark, or whether Turbologo has an API to bulk-generate logos (it is UI-only — no public API, webhooks, Zapier, or MCP). Do NOT use to generate the business name (use /sales-namelix), compare or validate branding tools across the market (use /sales-idea-validation), or build wider marketing creative (use /sales-canva).
tools
Online Logo Maker (onlinelogomaker.com) platform help — a long-standing free/freemium DIY logo maker: build the mark yourself from icons, shapes, text, and fonts — MANUAL/template-based, NOT enter-a-name-get-AI-concepts. The free pack downloads a LOW-RES 300px PNG with a background; vector SVG, transparent PNG, and 2000px high-res are gated to a one-time lifetime Premium pack (not a subscription). The free tier's commercial-use rights are disputed by reviewers — clean ownership effectively needs Premium, and a shared-icon mark can be non-distinctive. Use for building/editing a logo here, free download vs Premium, vector SVG or transparent PNG, one-time pricing, commercial-use/trademark terms, near-namesake confusion (NOT LogoMaker.com / LogoMakr / Logomakerr.ai), or whether it has an API (UI-only — no API, webhooks, Zapier, MCP). Do NOT use to generate the business name (use /sales-namelix), compare branding tools across the market (use /sales-idea-validation), or build wider creative (use /sales-canva).