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 send a GET request to /v1/commerce/billing/features 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.
Note: For the exhaustive list of response parameters, see API reference.

Update feature details

Use a valid access token and send a PUT request to /v1/commerce/billing/features/{code} with the modified request parameters such as name, description, and privileges. Path parameter: code is the feature’s unique code identifier you provided when you created the feature.
Note: 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"
    }
  ]
}'
Note: For the exhaustive list of request and response parameter descriptions, see API reference.

Delete privilege

Use a valid access token and send a DELETE request to /v1/commerce/billing/features/{feature_code}/privileges/{privilege_code} to remove a specific privilege from a feature. Path parameters:
  • feature_code is the feature’s unique code identifier you provided when you created the feature.
  • privilege_code is the privilege’s unique code identifier you provided when you created the privilege.
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 send a DELETE request to /v1/commerce/billing/features/{code} to permanently delete a feature. Path parameter: code is the feature’s unique code identifier 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>'
I