Skip to main content
Feature management helps you monitor, update, and delete existing features and their privileges. You can retrieve feature configurations and modify feature settings to define what functionality customers can access in your application.

​
List features

Use a valid access token and make a GET call to the /v1/commerce/billing/features endpoint with optional query parameters. On successful request processing, PayPal returns a paginated list of all configured features. 
curl -X GET 'https://api-m.sandbox.paypal.com/v1/commerce/billing/features?page=1&per_page=10' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'

​
Query parameters

Parameter nameDescription
page
integer		Page number for pagination. Default is 1.
per_page
integer		Number of items per page. Default is 10, maximum is 100.

​
Update feature details

Use a valid access token and make a PUT call to the /v1/commerce/billing/features/{feature_code} endpoint with the modified request parameters such as name, description, and privileges. Path parameter: feature_code is the code you provided when you created the feature.
You cannot modify the feature code after creation. You can only update the name, description, and privileges.
On successful request processing, PayPal returns the updated feature information. 
curl -X PUT 'https://api-m.sandbox.paypal.com/v1/commerce/billing/features/seats' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>' \
-d '{
  "name": "User Seats",
  "description": "Maximum number of users allowed in the account",
  "privileges": [
    {
      "code": "max",
      "name": "Maximum seats",
      "value_type": "INTEGER"
    },
    {
      "code": "max_admins",
      "name": "Maximum admin users",
      "value_type": "INTEGER"
    },
    {
      "code": "root",
      "name": "Allow root user",
      "value_type": "BOOLEAN"
    },
    {
      "code": "guest_access",
      "name": "Allow guest access",
      "value_type": "BOOLEAN"
    }
  ]
}'
For the exhaustive list of request and response parameter descriptions, see API reference.

​
Delete privilege

Use a valid access token and make a DELETE call to the /v1/commerce/billing/features/{feature_code}/privileges/{privilege_code} endpoint to remove a specific privilege from a feature. Path parameters: 
curl -X DELETE 'https://api-m.sandbox.paypal.com/v1/commerce/billing/features/seats/privileges/max_admins' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'

​
Delete feature

Use a valid access token and make a DELETE call to the /v1/commerce/billing/features/{feature_code} endpoint to permanently delete a feature. Path parameter: feature_code is the code you provided when you created the feature. 
curl -X DELETE 'https://api-m.sandbox.paypal.com/v1/commerce/billing/features/seats' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'