Feature

A feature represents a monetizable ability or functionality in your system. Features can be assigned to products, and when those products are purchased, Stripe will create an entitlement to the feature for the purchasing customer.

Was this section helpful?YesNo
Create a feature
POST/v1/entitlements/features
List all features
GET/v1/entitlements/features
Updates a feature
POST/v1/entitlements/features/:id

The Feature object

Attributes

  • idstring

    Unique identifier for the object.

  • lookup_keystring

    A unique key you provide as your own system identifier. This may be up to 80 characters.

  • metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

  • namestring

    The feature’s name, for your own purpose, not meant to be displayable to the customer.

    The maximum length is 80 characters.

More attributes

  • objectstring

  • activeboolean

  • livemodeboolean

The Feature object
{
"id": "feat_test_61QGU1MWyFMSP9YBZ41ClCIKljWvsTgu",
"object": "entitlements.feature",
"livemode": false,
"name": "My super awesome feature",
"lookup_key": "my-super-awesome-feature",
"active": true,
"metadata": {}
}

Create a feature

POST /v1/entitlements/features

Creates a feature

Parameters

  • lookup_keystringRequired

    A unique key you provide as your own system identifier. This may be up to 80 characters.

    The maximum length is 80 characters.

  • namestringRequired

    The feature’s name, for your own purpose, not meant to be displayable to the customer.

    The maximum length is 80 characters.

  • metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

Returns

Returns a feature

curl https://api.stripe.com/v1/entitlements/features \
-u "sk_test_VePHdqK...NInc7u56JBrQsk_test_VePHdqKTYQjKNInc7u56JBrQ:" \
-d "name=My super awesome feature" \
-d lookup_key=my-super-awesome-feature
Response
{
"id": "feat_test_61QGU1MWyFMSP9YBZ41ClCIKljWvsTgu",
"object": "entitlements.feature",
"livemode": false,
"name": "My super awesome feature",
"lookup_key": "my-super-awesome-feature",
"active": true,
"metadata": {}
}