sales-skills/sales-sellfy

Sellfy Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

1. What are you trying to do?

   • A) Set up a new Sellfy store or add my first product
   • B) Sell a specific product type (digital download, print-on-demand merch, physical, subscription)
   • C) Configure pricing, coupons, upsells, or cart abandonment
   • D) Connect Sellfy to my email tool, CRM, or other apps
   • E) Embed Sellfy on my existing website
   • F) Set up or manage my affiliate program
   • G) Wire up webhooks or the Zapier API token for automation
   • H) Troubleshoot a payment, checkout, delivery, or tax issue
   • I) Choose a plan / decide whether to upgrade
   • J) Something else

2. Which plan are you on (or considering)?

   • A) Starter — $22/mo annual / $29/mo (up to ~$10k/yr in sales)
   • B) Business — $59/mo annual / $79/mo (up to ~$50k/yr)
   • C) Premium — $119/mo annual / $159/mo (up to ~$200k/yr)
   • D) Not sure / haven't signed up yet

Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.

Step 2 — Route or answer directly

| If the question is about... | Route to... | |---|---| | Digital product pricing/launch strategy (not Sellfy-specific) | /sales-digital-products [question] | | Checkout conversion optimization theory (upsells, AOV, cart abandonment across carts) | /sales-checkout [question] | | Choosing a Merchant of Record for global tax (Sellfy is NOT one) | /sales-merchant-of-record [question] | | Email marketing strategy (sequences, segmentation) | /sales-email-marketing [question] | | Membership/subscription content strategy & retention | /sales-membership [question] | | Affiliate program design (commission models, recruitment) | /sales-affiliate-program [question] |

When routing, provide the exact command: "This is a {problem domain} question — run: /sales-{skill} {user's original question}"

Step 3 — Sellfy platform reference

Read references/platform-guide.md for the full platform reference — product types, store builder, marketing tools, pricing/caps, integrations, data model, and workflows.

Read references/sellfy-api-reference.md if the question involves webhooks, the Zapier API token, the JSON payloads, or any automation/integration.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

You no longer need the platform guide — focus on the user's specific situation.

• Product setup: pick the right product type (digital / POD / physical / subscription), set delivery (auto-delivered download, POD fulfillment), and turn on PDF stamping + download limits for files you want to protect.
• Plan selection: model expected annual revenue against the tier caps ($10k / $50k / $200k) AND email volume — the cap, not just fees, is what forces an upgrade. There are no per-sale Sellfy fees, so the decision is subscription cost vs cap headroom vs gated features (upsells, cart abandonment, affiliates are Business+).
• Integrations: for real-time reactions to a sale, use a webhook; for no-code multi-app flows, use the Zapier API token. There is no public REST CRUD API to push/pull products or orders.
• Tax: Sellfy is NOT a Merchant of Record — you own VAT/GST/sales-tax compliance. If global tax is a dealbreaker, consider an MoR (Lemon Squeezy, Paddle, Gumroad).
• Troubleshooting: check Gotchas first, then the platform guide.

If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research (2026-06) — review these, especially items about plan-gated features, sales-volume caps, and integration gotchas that may be outdated.

1. Annual sales-volume caps force upgrades — each tier caps yearly revenue (Starter ~$10k, Business ~$50k, Premium ~$200k). Cross the cap in a rolling 12-month window and Sellfy prompts an upgrade; even Premium tops out at ~$200k/yr, which can be a hard ceiling for scaling sellers.
2. No public REST CRUD API — you cannot programmatically create/read/update products or orders. The only developer surfaces are outbound webhooks and a Zapier API token. Plan integrations around those, not a REST API.
3. Webhooks have NO HMAC signature — Sellfy POSTs JSON but doesn't sign it. Protect your endpoint with a secret URL path / token query param and an IP/UA check; never trust payload contents blindly.
4. Not a Merchant of Record — Sellfy does not collect/remit VAT or GST for you. Selling internationally makes you liable for tax in the buyer's country.
5. Key conversion features are Business+ — product upselling, cart abandonment, affiliate marketing, custom fields, branding removal, and store-design migration are gated above Starter. Confirm the lever you need is on your tier.
6. Limited design & SEO — ~10 themes, no category-page/URL customization, no built-in blog, limited metadata. For brand control, embed Sellfy's buy buttons/cart on your own site instead of relying on the hosted store.
7. Only Stripe + PayPal — no native gateway and a short processor list; processor fees (~2.9% + 30¢) still apply on top of Sellfy's 0% platform fee.

Related skills

• /sales-digital-products — Digital product pricing, launch strategy, and platform comparison
• /sales-checkout — Checkout page optimization (upsells, order bumps, payment plans, cart abandonment)
• /sales-merchant-of-record — Choosing a MoR for global tax (Sellfy is not one)
• /sales-membership — Subscription/membership structure, pricing, and retention
• /sales-affiliate-program — Affiliate program design (commissions, recruitment, tracking)
• /sales-payhip — Payhip platform help (digital downloads, courses, all-features-on-free-tier alternative)
• /sales-gumroad — Gumroad platform help (digital products, license keys, MoR tax handling)
• /sales-customcat — CustomCat platform help (budget standalone US print-on-demand fulfillment if you want cheaper merch than Sellfy's built-in POD)
• /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-code

Examples

Example 1: First store setup

User says: "I want to sell a $19 ebook and a print-on-demand t-shirt on Sellfy" Skill does: Walks through creating a digital product (upload file, enable PDF stamping + download limit) and a POD product (pick garment, upload design, set margin), recommends Starter while annual sales are under ~$10k, enables coupons, and connects an email tool for post-purchase follow-up. Result: Both products live with download protection and a follow-up email path configured.

Example 2: Plan / cap decision

User says: "I'm on Sellfy Starter doing about $1,200/mo — do I need to upgrade?" Skill does: Annualizes to ~$14.4k, which exceeds the Starter ~$10k cap, so an upgrade to Business (~$59/mo annual) is required regardless of features; notes Business also unlocks upsells, cart abandonment, and affiliates; flags the ~$50k Business cap as the next ceiling. Result: User upgrades to Business for headroom and the conversion features, before hitting the cap mid-launch.

Example 3: Automation / developer question

User says: "How do I send every new Sellfy sale into my CRM and trigger fulfillment?" Skill does: Explains there's no REST API — set up a New Order webhook (Integrations → Webhooks → title + HTTPS URL), parse the JSON (id, products[] with key/variant, customer, amount in cents), secure the endpoint with a secret path + IP check (no HMAC), and for no-code routing use the Zapier API token from sellfy.com/user/integrations/apps/zapier with a Completed-payment trigger. Points to references/sellfy-api-reference.md for payloads. Result: Sales flow into the CRM in real time and kick off fulfillment.

Troubleshooting

Sale happened but my webhook/CRM didn't get it

Symptom: A purchase completed but no event reached your endpoint or Zap. Cause: Webhook URL not HTTPS / unreachable, the Zap is filtered to the wrong event type, or amounts confused (Sellfy sends money in cents). Solution: Verify the webhook URL is public HTTPS and returns 2xx fast. In Zapier, set the trigger event explicitly (Completed payment vs Refund vs leave blank for all). Treat amount/plan_amount/total as cents (449 = $4.49). Since there's no HMAC, dedupe on the order/subscription id to ignore retries.

Buyers in the EU complain about missing/incorrect VAT

Symptom: International customers expect VAT handling or you get a tax bill. Cause: Sellfy is not a Merchant of Record and does not remit tax for you. Solution: Configure your own VAT/tax settings where available, keep records, and remit yourself — or move tax-heavy international sales to an MoR (Lemon Squeezy, Paddle, Gumroad). Run /sales-merchant-of-record to choose.

My digital file is being shared / I hit a plan limit

Symptom: A purchased download is circulating, or a feature (upsell, cart abandonment, affiliates) is greyed out. Cause: Download protection not enabled, or the feature is gated above Starter. Solution: Enable PDF stamping and download limits on the product, and deliver via the unique auto-generated link rather than a public URL. For gated features, confirm you're on Business+ — upselling, cart abandonment, and affiliate marketing require it.