Funktion Flagga Rättighet

​

Vad som levereras

• Vid köp skapas grant och går direkt till Delivered. Det finns ingen fas för Pending, ingen kundåtgärd och inget sätt för leveransen att misslyckas.
• Grant innehåller en typad feature-nyttolast: { "feature_type": "boolean", "feature_id": "advanced_reports" }. Din applikation läser feature_id för att avgöra vad som ska låsas upp.
• Annullering, återbetalning eller manuellt återkallande flyttar grant till Revoked, och din applikation ser att flaggan försvinner.

​

Skapa en funktion flagga

1

Open Entitlements

I din Dodo Payments dashboard, gå till Rättigheter och klicka på + för att starta en ny rättighet, välj sedan Funktion Flaggar.

2

Name the flag

Ge flaggan ett Visningsnamn för din dashboard, ett Funktion ID som din applikation kommer att kontrollera (dashboarden föreslår ett från namnet) och en Beskrivning så att ditt team vet vad den kontrollerar.

3

Optionally add metadata

Toggle Meta Data för att bifoga nyckel-värde konfiguration — gränser, nivånamn, kvoter — som levereras till din applikation tillsammans med flaggan. Se Bifoga gränser med metadata.

4

Confirm

Klicka på Bekräfta. Flaggan visas i din rättighetslista, redo att bifogas till produkter.

​

Bifoga till en produkt

​

Obligatorisk konfiguration

​

Skapa via 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"),
    },
  ),
})

​

Bifoga gränser med metadata

• Att redigera rättighetens metadata senare påverkar endast framtida beviljanden. Kunder behåller de gränser de köpt under.
• Ögonblicksbilden returneras på varje beviljande som dess metadata fält, så ett API-anrop ger dig både flaggan och dess konfiguration.

​

Kontrollera en kunds funktioner

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
  }
}

​

Livscykel

​

Webhooks

• entitlement_grant.created — anländer redan i Delivered med feature-nyttolasten. Aktivera funktionen.
• entitlement_grant.delivered — utlöses när en tidigare återkallad grant återställs. Aktivera funktionen igen.
• entitlement_grant.revoked — åtkomsten har dragits in. Inaktivera funktionen och kontrollera revocation_reason för att avgöra hur meddelandet ska formuleras.

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);
});

​

Exempel: Pro plan låser upp avancerade rapporter

1. Skapa flaggan. feature_id: advanced_reports med metadata { "tier": "pro", "monthly_report_limit": 100 }.
2. Koppla den till din prenumerationsprodukt Pro Plan.
3. En kund prenumererar. Dodo Payments skapar en Delivered grant och utlöser entitlement_grant.created; din webhook-hanterare aktiverar advanced_reports för kunden med en gräns på 100.
4. Din app begränsar åtkomsten till funktionen. När dashboarden läses in kontrollerar du den cachade funktionsuppsättningen (eller anropar listEntitlementGrants) och visar rapportfliken endast när advanced_reports finns.
5. Kunden annullerar. Dodo Payments återkallar grant och utlöser entitlement_grant.revoked; din hanterare inaktiverar funktionen. Om kunden senare återställs via kravhantering återställer entitlement_grant.delivered den — inga kodändringar behövs.

​

Bästa praxis

• Använd stabila feature-id:n i snake_case. Din applikationskod kontrollerar dessa strängar; att byta namn på ett av dem är en brytande ändring på båda sidor.
• En flagga per funktion. Föredra advanced_reports + api_access som två entitlements framför en enda pro_bundle — återkallanden och planblandningar förblir tydliga.
• Låt webhooks styra tillståndet och verifiera med API:t. Webhooks håller din databas aktuell; list-endpointen är sanningskällan för avstämningsjobb och cachemissar.
• Behandla Revoked som omedelbart. En återkallad flagga innebär att kunden inte längre betalar för funktionen. Begränsa åtkomsten vid nästa begäran, inte vid nästa session.
• Lägg gränser i metadata, inte i koden. Om en kvot ändras behöver du då bara redigera entitlementen — nya kunder får den automatiskt, medan befintliga grants behåller den ögonblicksbild som köptes.