Zum Inhalt
Perly
StartenKostenlos starten

Anleitungen

Rezept: Lizenzschlüssel

Verkaufen Sie eine Desktop-App, ein CLI, ein Plugin oder eine Vorlage mit Lizenzschlüsseln. Die App prüft den Schlüssel ohne jedes Geheimnis im Code.

Als Markdown ansehen

Perly Pay stellt einen Schlüssel aus, wenn die Zahlung erfüllt ist, zählt Aktivierungen auf Geräten und beantwortet „ist dieser Schlüssel für dieses Produkt hier gültig?“ über öffentliche Endpunkte. Die Software, die Sie verteilen, nutzt LicenseClient – der braucht keinen geheimen Schlüssel.

Mit einem Assistenten: Dieses Rezept setzt der Skill sell-license-keys des Perly-Pay-Plugins in Ihrem Projekt um. Ein lauffähiges Beispiel ist examples/license-keys (MIT) im Repository des Plugins.

So funktioniert es

  1. 1

    Ein Produkt, das Schlüssel ausstellt

    issues_license: true und license_activation_limit (Geräte pro Schlüssel), mit Einmal-, Lebenslang-, Laufzeitpreis oder Abo.

  2. 2

    Verkaufen

    Ein Zahlungslink auf Ihrer Website oder eine Rechnung pro Käufer.

  3. 3

    Schlüssel senden

    Über den Webhook license.created (sein Objekt ist der Schlüssel) oder über licenseKeys.list({ customer }) nach invoice.fulfilled. Der Beleg enthält keinen Schlüssel.

  4. 4

    Aktivierung in der App

    activate({ key, product, instance_name }) mit einem Namen, der auf diesem Gerät gleich bleibt; speichern Sie die Aktivierungs-ID.

  5. 5

    Prüfung beim Start

    validate({ key, product, instance }). Ein klares valid: false sperrt; ohne Netz gilt die letzte gute Antwort ein paar Tage.

import { LicenseClient } from "perly-pay";

const licenses = new LicenseClient(); // no secret key, ever
const result = await licenses.activate({ key, product: "prod_…", instance_name: deviceName });
if (!result.valid) showWhy(result.reason); // limit_reached, revoked, expired, …

Beispiel starten

  1. 1

    Installieren

    npm install in examples/license-keys (Node 20.12+).

  2. 2

    Schlüssel

    Kopieren Sie .env.example nach .env und tragen Sie einen Testschlüssel (sk_test_…) in PERLY_PAY_SECRET_KEY ein.

  3. 3

    Vorbereiten

    npm run setup legt mit Ihrem Schlüssel Produkt und Preis an und gibt ihre IDs für .env aus.

  4. 4

    Starten

    npm start (oder npm run dev), wie seine README sagt.

  5. 5

    Ohne Wallet bezahlen

    npm run buy-test -- you@example.com kauft eine Kopie im Testmodus und gibt den Schlüssel aus; dann npm run app -- activate <key> und npm run app -- pro hello.

Fallstricke

  • Ein Schlüssel sk_… in der App. Jeder kann ihn herausziehen; Software, die Sie verteilen, nutzt nur LicenseClient.
  • Ohne product wird der Aufruf abgelehnt (parameter_missing). Geben Sie es immer mit; ein Schlüssel für etwas anderes ergibt wrong_product.
  • Ein instance_name, der sich bei jedem Start ändert: Jeder Start verbraucht eine Aktivierung.