Skip to main content

Developer Payouts

Extension developers are paid their revenue share through Extensions → Payouts (/dashboard/extensions/payouts). The page is visible to approved developers with the extension-dev:payouts permission while the extension_development feature is on. It shows your balance, lets you choose a payout method and request a payout, and lists the credit notes of your payouts.

Before your first payout​

A payout needs three things:

  1. A verified developer identity. Submit the form under Extensions → Verification and wait for the review.

  2. Your tax details. Every payout is documented by a self-billed credit note (Gutschrift) that Lumio issues on your behalf, and its VAT depends on these details. Which ones you need depends on your country:

    You areYou need
    In Germany, small business (§ 19 UStG)Tax number (Steuernummer) or VAT ID, and "Small business: Yes"
    In Germany, charging VATTax number or VAT ID, and "Small business: No" — 19 % VAT is added on top of your revenue share
    In another EU countryVAT ID
    Outside the EUNothing

  3. A payout method (PayPal or SEPA bank transfer; Stripe Connect is not available yet).

Tax details​

The verification form asks for the tax details in step 2 (Business and tax data). The small-business question appears only when the country is DE; "Not answered" leaves it open. After you submitted the form, the Tax details card on the verification page keeps them editable in every status, including after approval. Saving does not reset the review and never changes a credit note that was already issued. The tax number and the VAT ID take at most 50 characters each.

Requesting a payout​

Request payout pays out your whole current balance with the saved method after a confirmation. If it cannot be booked, the page names the reason and nothing is paid out:

MessageWhat to do
Payouts require a verified developer identityComplete the verification, then request again
The credit note needs your tax number or VAT ID / your small-business answer / your VAT IDFollow the link to the Tax details card, complete them, then request again
Payouts are unavailable right now because Lumio cannot issue credit notes yetLumio's own invoicing data is not configured. Try again later

After the request​

The payout appears in your payout history as Pending:

  • Stripe and PayPal are sent automatically within about 15 minutes. A Stripe payout is then Completed. A PayPal payout is Processing until PayPal confirms it.
  • SEPA bank transfers are made by Lumio's team, and the payout is Completed once the transfer is recorded.
  • If the provider refuses the payout, it is Failed. Your balance is credited back, the credit note is cancelled, and you can request again.

You can have one open payout at a time.

In addition, Lumio pays out your balance automatically once per calendar month when it reaches the minimum for your payout method, unless you already had a payout that month. See Developer Payouts for the details.

Credit notes​

The Credit notes section lists every credit note and cancellation, newest first, 20 at a time (Load more shows older ones). Each row shows:

  • the number (GS-<year>-<6 digits>) and whether it is a Credit note or a Cancellation — a cancellation carries negative amounts and the reason (payout failed, your objection, correction); a cancelled credit note is marked Cancelled;
  • the issue date and the service period (dates in Europe/Berlin);
  • the VAT treatment and, once it was mailed, the date you got it by e-mail;
  • the gross amount, which streamer mode hides.

PDF downloads the document as issued. Right after a payout the PDF is still being generated: the row then says Document is being generated instead of offering a download. You also receive every PDF by e-mail.

If Lumio credited you a balance from an earlier developer profile (you came back with a claim code), the next credit notes show that amount as its own first line, "earned through an earlier developer profile", with the date it was released. A payout smaller than that amount uses part of it; the rest appears on the next note.

To object to a credit note, contact Lumio support. An operator records the objection and, if needed, issues a corrected note; the original is never changed. See Developer Credit Notes for numbering, VAT and retention.