Paddle 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) Build an API integration — create products/prices, manage subscriptions/transactions, pull reports
   • B) Set up + verify webhooks (HMAC-SHA256) to provision access / run dunning
   • C) Migrate from the legacy Paddle Classic API to Paddle Billing
   • D) Understand the MoR model — fees (5% + $0.50), tax handled for you, payout timing
   • E) Fix a problem — wrong amounts (cents-as-string), out-of-order/duplicate webhooks, signature failures
   • F) Decide if Paddle vs another provider — that's a selection question (route in Step 2)

2. Billing or Classic? Build everything new on Paddle Billing (api.paddle.com). Only touch Classic to migrate an existing integration off it.

3. Sandbox first? Use sandbox-api.paddle.com with separate keys before production.

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