Feature-Flag-Berechtigung

​

Was geliefert wird

• Beim Kauf wird die Berechtigung erstellt und direkt zu delivered verschoben. Es gibt keine pending-Phase, keine Kundenaktion und keine Möglichkeit für ein Lieferversagen.
• Die Berechtigung trägt eine typisierte feature-Nutzlast: { "feature_type": "boolean", "feature_id": "advanced_reports" }. Ihre Anwendung liest feature_id, um zu entscheiden, was freigeschaltet wird.
• Stornierungen, Rückerstattungen oder manuelle Widerrufe verschieben die Berechtigung zu revoked, und Ihre Anwendung sieht das Flag verschwinden.

​

Erstellen eines Feature-Flags

1

Open Entitlements

Gehen Sie in Ihrem Dodo Payments-Dashboard zu Berechtigungen und klicken Sie auf +, um eine neue Berechtigung zu starten, und wählen Sie dann Feature Flags.

2

Name the flag

Geben Sie dem Flag einen Anzeigenamen für Ihr Dashboard, eine Feature-ID, die Ihre Anwendung überprüfen wird (das Dashboard schlägt eine basierend auf dem Namen vor), und eine Beschreibung, damit Ihr Team weiß, was es steuert.

3

Optionally add metadata

Schalten Sie Meta-Daten ein, um Schlüssel-Wert-Konfigurationen — Limits, Tiernamen, Quoten — zu verknüpfen, die Ihrer Anwendung zusammen mit dem Flag geliefert werden. Siehe Limits mit Metadaten anhängen.

4

Confirm

Klicken Sie auf Bestätigen. Das Flag erscheint in Ihrer Berechtigungsliste, bereit, mit Produkten verknüpft zu werden.

​

An ein Produkt anhängen

​

Erforderliche Konfiguration

​

Erstellung über API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

const entitlement = await client.entitlements.create({
  name: 'Advanced Reports',
  integration_type: 'feature_flag',
  integration_config: {
    feature_type: 'boolean',
    feature_id: 'advanced_reports',
  },
  metadata: {
    tier: 'pro',
    monthly_report_limit: 100,
  },
});

client.entitlements.create(
    name="Advanced Reports",
    integration_type="feature_flag",
    integration_config={
        "feature_type": "boolean",
        "feature_id": "advanced_reports",
    },
    metadata={
        "tier": "pro",
        "monthly_report_limit": 100,
    },
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Advanced Reports"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeFeatureFlag),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigFeatureFlagConfigParam{
      FeatureType: dodopayments.F(dodopayments.FeatureTypeBoolean),
      FeatureID:   dodopayments.F("advanced_reports"),
    },
  ),
})

​

Limits mit Metadaten anhängen

• Das spätere Bearbeiten der Metadaten der Berechtigung betrifft nur zukünftige Berechtigungen. Kunden behalten die Limits, unter denen sie erworben haben.
• Der Schnappschuss wird bei jeder Berechtigung als sein Feld metadata zurückgegeben, sodass ein API-Aufruf sowohl das Flag als auch die Konfiguration liefert.

​

Features eines Kunden überprüfen

const features = new Map<string, Record<string, unknown>>();

for await (const grant of client.customers.listEntitlementGrants('cus_abc123', {
  integration_type: 'feature_flag',
  status: 'Delivered',
})) {
  if (grant.feature) {
    features.set(grant.feature.feature_id, grant.metadata ?? {});
  }
}

if (features.has('advanced_reports')) {
  const limit = features.get('advanced_reports')?.monthly_report_limit;
  // unlock the dashboard, enforce the limit
}

page = client.customers.list_entitlement_grants(
    customer_id="cus_abc123",
    integration_type="feature_flag",
    status="Delivered",
)

features = {
    grant.feature.feature_id: grant.metadata
    for grant in page.items
    if grant.feature
}

if "advanced_reports" in features:
    limit = features["advanced_reports"].get("monthly_report_limit")

page, _ := client.Customers.ListEntitlementGrants(
  ctx, "cus_abc123",
  dodopayments.CustomerListEntitlementGrantsParams{
    IntegrationType: dodopayments.F("feature_flag"),
    Status:          dodopayments.F("Delivered"),
  },
)

features := map[string]bool{}
for _, grant := range page.Items {
  if grant.Feature.FeatureID != "" {
    features[grant.Feature.FeatureID] = true
  }
}

​

Lebenszyklus

​

Webhooks

• entitlement_grant.created — kommt bereits delivered mit der feature-Nutzlast an. Aktivieren Sie das Feature.
• entitlement_grant.delivered — wird ausgelöst, wenn eine zuvor widerrufene Berechtigung wiederhergestellt wird. Aktivieren Sie das Feature erneut.
• entitlement_grant.revoked — Zugriff entzogen. Deaktivieren Sie das Feature und überprüfen Sie revocation_reason, um Ihre Nachricht zu entscheiden.

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  if (event.type.startsWith('entitlement_grant.') && event.data.feature) {
    const { customer_id, feature } = event.data;
    const enabled = event.type !== 'entitlement_grant.revoked';

    await db.customerFeatures.upsert({
      customerId: customer_id,
      featureId: feature.feature_id,
      enabled,
      config: event.data.metadata ?? {},
    });
  }

  res.sendStatus(200);
});

​

Beispiel: Pro-Plan schaltet erweiterte Berichte frei

1. Erstellen Sie das Flag. feature_id: advanced_reports mit Metadaten { "tier": "pro", "monthly_report_limit": 100 }.
2. Anhängen an Ihr Pro-Plan-Abonnementprodukt.
3. Ein Kunde abonniert. Dodo Payments erstellt eine delivered-Berechtigung und löst entitlement_grant.created aus; Ihr Webhook-Handler aktiviert advanced_reports für den Kunden mit einem Limit von 100.
4. Ihre App schaltet die Funktion ab. Beim Laden des Dashboards, prüfen Sie die zwischengespeicherte Feature-Menge (oder rufen Sie listEntitlementGrants auf) und rendern Sie das Berichtsfeld nur, wenn advanced_reports vorhanden ist.
5. Der Kunde storniert. Dodo Payments widerruft die Berechtigung und löst entitlement_grant.revoked aus; Ihr Handler deaktiviert das Feature. Sollte der Kunde später durch Dunning erneut aktiviert werden, stellt entitlement_grant.delivered es wieder her — keine Codeänderungen erforderlich.

​

Best Practices

• Verwenden Sie stabile, snake_case Feature-IDs. Ihr Anwendungscode überprüft diese Strings; das Umbenennen eines davon ist eine Unterbrechung auf beiden Seiten.
• Ein Flag pro Fähigkeit. Bevorzugen Sie advanced_reports + api_access als zwei Berechtigungen über ein einziges pro_bundle — Widerrufungen und Plan-Mixe bleiben sauber.
• Steuern Sie den Status über Webhooks, überprüfen Sie mit der API. Webhooks halten Ihre Datenbank aktuell; der Endpunkt der Liste ist die Wahrheit für Abstimmungsjobs und Cache-Misses.
• Behandeln Sie revoked als sofortig. Ein widerrufenes Flag bedeutet, dass der Kunde nicht mehr für die Funktion bezahlt. Sperren Sie beim nächsten Anruf, nicht in der nächsten Sitzung.
• Setzen Sie Limits in Metadaten, nicht im Code. Eine Quote zu ändern, erfordert dann nur das Bearbeiten der Berechtigung — neue Kunden nehmen es automatisch auf, während bestehende Berechtigungen ihren erworbenen Schnappschuss behalten.