Feature Flag Entitlement

​

क्या deliver होता है

• Purchase पर grant बनाया जाता है और सीधे delivered में चला जाता है। कोई pending phase, customer action या delivery के fail होने की संभावना नहीं होती।
• Grant में typed feature payload होता है: { "feature_type": "boolean", "feature_id": "advanced_reports" }। आपका application feature_id पढ़कर तय करता है कि क्या unlock करना है।
• Cancellation, refund या manual revoke grant को revoked में ले जाता है, और आपका application flag को गायब होते देखता है।

​

Feature flag बनाएं

1

Open Entitlements

अपने Dodo Payments dashboard में Entitlements पर जाएं और नया entitlement शुरू करने के लिए + पर click करें, फिर Feature Flags चुनें।

2

Name the flag

अपने dashboard के लिए flag को Display Name, application द्वारा check किया जाने वाला Feature ID (dashboard name से एक ID सुझाता है) और एक Description दें, ताकि आपकी team को पता रहे कि यह किसे नियंत्रित करता है।

3

Optionally add metadata

Flag के साथ key-value configuration — limits, tier names, quotas — attach करने के लिए Meta Data toggle करें। यह configuration flag के साथ आपके application तक deliver की जाती है। Attach limits with metadata देखें।

4

Confirm

Confirm पर click करें। Flag आपकी entitlements list में दिखाई देगा और products से attach करने के लिए तैयार होगा।

​

Product से attach करें

​

आवश्यक configuration

​

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

​

Metadata के साथ limits attach करें

• बाद में entitlement का metadata edit करने पर केवल future grants प्रभावित होते हैं। Customers अपने खरीदे गए limits के अनुसार बने रहते हैं।
• Snapshot प्रत्येक grant पर उसके metadata field के रूप में लौटाया जाता है, इसलिए एक API call से flag और उसकी configuration दोनों मिलती हैं।

​

Customer के features check करें

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

​

Lifecycle

​

Webhooks

• entitlement_grant.created — यह पहले से delivered में feature payload के साथ आता है। Feature enable करें।
• entitlement_grant.delivered — पहले revoked grant के restore होने पर fire होता है। Feature फिर से enable करें।
• entitlement_grant.revoked — access वापस ले लिया गया है। Feature disable करें और अपनी messaging तय करने के लिए revocation_reason check करें।

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

​

उदाहरण: Pro plan से advanced reports unlock करना

1. Flag बनाएं। feature_id: advanced_reports को metadata { "tier": "pro", "monthly_report_limit": 100 } के साथ बनाएं।
2. इसे अपने Pro Plan subscription product से attach करें।
3. Customer subscribe करता है। Dodo Payments एक delivered grant बनाता है और entitlement_grant.created fire करता है; आपका webhook handler customer के लिए 100 की limit के साथ advanced_reports enable करता है।
4. आपका app feature को gate करता है। Dashboard load होने पर cached feature set check करें (या listEntitlementGrants call करें) और reports tab केवल तब render करें जब advanced_reports मौजूद हो।
5. Customer cancel करता है। Dodo Payments grant revoke करता है और entitlement_grant.revoked fire करता है; आपका handler feature disable कर देता है। यदि customer बाद में dunning के माध्यम से recover करता है, तो entitlement_grant.delivered इसे restore कर देता है — किसी code change की आवश्यकता नहीं।

​

Best practices

• Stable, snake_case feature ids का उपयोग करें। आपका application code इन strings को check करता है; किसी एक का नाम बदलना दोनों sides पर breaking change है।
• प्रत्येक capability के लिए एक flag रखें। एकल pro_bundle के बजाय advanced_reports + api_access को दो entitlements के रूप में रखना बेहतर है — revocation और plan mixes साफ रहते हैं।
• State को webhooks से drive करें और API से verify करें। Webhooks आपके database को current रखते हैं; list endpoint reconciliation jobs और cache misses के लिए source of truth है।
• revoked को immediate मानें। Revoked flag का अर्थ है कि customer अब feature के लिए pay नहीं कर रहा है। अगले session पर नहीं, अगली request पर gate करें।
• Limits को code में नहीं, metadata में रखें। Quota बदलने के लिए केवल entitlement edit करना होगा — नए customers इसे अपने-आप प्राप्त करेंगे, जबकि मौजूदा grants अपना purchased snapshot बनाए रखेंगे।