Sales through Paddle

Sales through Paddle connects a project to the Paddle account that sells it, and tells you of new sales every few minutes: in the alerts column and as a notice on your computer. Its page shows refunds and chargebacks, failed payments, subscriptions and the renewals coming, payouts and an estimated balance, every amount in your own account's currency.

It is a free plugin. It needs no aigopilot.com account and no AI subscription, and nothing passes through our site: this computer asks Paddle with your own key. If your product sells through Stripe instead, see Sales through Stripe; a project can have both.

Make a key that reads

1. In Paddle, open Developer tools, then Authentication, and press New API key. For a sandbox account, do the same in the sandbox dashboard.
2. Give it a name you will know, such as "AigoPilot, read only", and note the expiry date Paddle shows.
3. Tick Read on notifications and on transactions; the plugin cannot work without these two. Read on customers, addresses, adjustments, subscriptions and metrics fills in the rest of the page. Tick nothing that writes.
4. Save the key and copy it. It starts with pdl_live_apikey_, or pdl_sdbx_apikey_ for a sandbox.

Paddle cannot be asked whether a key is able to write without trying a write, so the studio does not try. It reads with the key, checks that the reads it needs answer, and only ever sends Paddle read requests. Making the key with Read permissions only is your part.

Connect a project

1. Open Marketplace and choose Sales through Paddle.
2. Choose the project.
3. Paste the key and press Connect.

An old Paddle key, which has no permissions and can do everything, is refused, and so is a client-side token, which cannot read sales. A good key goes into this computer's vault and nowhere else. On connecting, the studio reads the account's recent history for the numbers on the page; none of it is announced as news.

Type the expiry date from Paddle under The key to be warned before it runs out. Paddle also tells the studio a week before.

How often it looks, and what it tells

Every 5 minutes by default. Check every offers 1, 15, 30 or 60 minutes, and Check now looks at once. A check that finds nothing is a single request.

The sales of one check come as one notice, such as "2 new sales: 240.00 GBP". A single sale names its product and country. After the computer was off, the studio reads from where it stopped and the notice says the sales came while it was off. A notice when sales arrive turns the desktop notices off and keeps everything in the alerts column.

Besides sales, the plugin raises alerts for failed payments, refunds, subscriptions made, canceled or past due, a payout, and sales that fell to half of the usual week or grew by half again. A chargeback is urgent and is told even in your quiet hours.

Amounts in your own currency

Every amount is what Paddle put in your balance, in your balance's currency. A buyer who paid in yen shows up in your pounds or dollars, with what they paid in their own currency as a detail of the line. Two things have no converted amount, because Paddle converts only what completed: a failed payment is shown in the buyer's currency, and a renewal coming in the subscription's own.

Paddle has no way to read the balance itself. The balance on the page is an estimate: what sales earned since the last payout, less refunds and chargebacks. The exact one is under Payouts in Paddle's dashboard.

Several products on one Paddle account

If one Paddle account sells two products, and each has its own project in the studio, connect both projects and tick each one's products under Products of this project. Each project then counts and tells only its own sales. Payouts and Paddle's metrics belong to the whole account, so they show on every project, and a payout is told once. With nothing ticked, a project sees every product.

The sales of all your projects, from Stripe and Paddle together, also open from the Paddle icon on the bar at the left edge of the studio, with the number of sales since you last looked.

Small tips

Questions