class Stripe::ProductsApi
- Stripe::ProductsApi
- Reference
- Object
Defined in:
stripe/api/products_api.crConstant Summary
-
DELETE_PRODUCTS_ID_MAX_LENGTH_FOR_ID =
5000
-
DELETE_PRODUCTS_PRODUCT_FEATURES_ID_MAX_LENGTH_FOR_ID =
5000
-
DELETE_PRODUCTS_PRODUCT_FEATURES_ID_MAX_LENGTH_FOR_PRODUCT =
5000
-
GET_PRODUCTS_ID_MAX_LENGTH_FOR_ID =
5000
-
GET_PRODUCTS_MAX_LENGTH_FOR_ENDING_BEFORE =
5000
-
GET_PRODUCTS_MAX_LENGTH_FOR_STARTING_AFTER =
5000
-
GET_PRODUCTS_MAX_LENGTH_FOR_URL =
5000
-
GET_PRODUCTS_PRODUCT_FEATURES_ID_MAX_LENGTH_FOR_ID =
5000
-
GET_PRODUCTS_PRODUCT_FEATURES_ID_MAX_LENGTH_FOR_PRODUCT =
5000
-
GET_PRODUCTS_PRODUCT_FEATURES_MAX_LENGTH_FOR_ENDING_BEFORE =
5000
-
GET_PRODUCTS_PRODUCT_FEATURES_MAX_LENGTH_FOR_PRODUCT =
5000
-
GET_PRODUCTS_PRODUCT_FEATURES_MAX_LENGTH_FOR_STARTING_AFTER =
5000
-
GET_PRODUCTS_SEARCH_MAX_LENGTH_FOR_PAGE =
5000
-
GET_PRODUCTS_SEARCH_MAX_LENGTH_FOR_QUERY =
5000
-
GET_PRODUCTS_VALID_VALUES_FOR__TYPE =
String.static_array("good", "service")
-
POST_PRODUCTS_ID_MAX_LENGTH_FOR_DEFAULT_PRICE =
5000
-
POST_PRODUCTS_ID_MAX_LENGTH_FOR_ID =
5000
-
POST_PRODUCTS_ID_MAX_LENGTH_FOR_NAME =
5000
-
POST_PRODUCTS_ID_MAX_LENGTH_FOR_STATEMENT_DESCRIPTOR =
22
-
POST_PRODUCTS_MAX_LENGTH_FOR_DESCRIPTION =
40000
-
POST_PRODUCTS_MAX_LENGTH_FOR_ID =
5000
-
POST_PRODUCTS_MAX_LENGTH_FOR_NAME =
5000
-
POST_PRODUCTS_MAX_LENGTH_FOR_STATEMENT_DESCRIPTOR =
22
-
POST_PRODUCTS_MAX_LENGTH_FOR_UNIT_LABEL =
12
-
POST_PRODUCTS_MAX_LENGTH_FOR_URL =
5000
-
POST_PRODUCTS_PRODUCT_FEATURES_MAX_LENGTH_FOR_ENTITLEMENT_FEATURE =
5000
-
POST_PRODUCTS_PRODUCT_FEATURES_MAX_LENGTH_FOR_PRODUCT =
5000
-
POST_PRODUCTS_VALID_VALUES_FOR__TYPE =
String.static_array("good", "service")
Constructors
Instance Method Summary
- #api_client : ApiClient
- #api_client=(api_client : ApiClient)
-
#build_api_request_for_delete_products_id(*, id : String | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_delete_products_product_features_id(*, id : String | Nil = nil, product : String | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_get_products(*, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, _type : String | Nil = nil, active : Bool | Nil = nil, shippable : Bool | Nil = nil, created : Stripe::GetAccountsCreatedParameter | Nil = nil, ids : Array(Array(String)) | Nil = nil, url : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_get_products_id(*, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_get_products_product_features(*, product : String | Nil = nil, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_get_products_product_features_id(*, product : String | Nil = nil, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_get_products_search(*, query : String | Nil = nil, page : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_post_products(*, name : String | Nil = nil, active : Bool | Nil = nil, default_price_data : Stripe::PriceDataWithoutProduct | Nil = nil, description : String | Nil = nil, expand : Array(String) | Nil = nil, id : String | Nil = nil, images : Array(String) | Nil = nil, marketing_features : Array(Stripe::Features) | Nil = nil, metadata : Hash(String, String) | Nil = nil, package_dimensions : Stripe::PackageDimensionsSpecs | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : String | Nil = nil, _type : String | Nil = nil, unit_label : String | Nil = nil, url : String | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_post_products_id(*, id : String | Nil = nil, active : Bool | Nil = nil, default_price : String | Nil = nil, description : Stripe::PostProductsIdRequestDescription | Nil = nil, expand : Array(String) | Nil = nil, images : Stripe::PostProductsIdRequestImages | Nil = nil, marketing_features : Stripe::PostProductsIdRequestMarketingFeatures | Nil = nil, metadata : Stripe::PostAccountsRequestMetadata | Nil = nil, name : String | Nil = nil, package_dimensions : Stripe::PostProductsIdRequestPackageDimensions | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : Stripe::PostInvoiceitemsRequestTaxCode | Nil = nil, unit_label : Stripe::PostProductsIdRequestUnitLabel | Nil = nil, url : Stripe::PostProductsIdRequestUrl | Nil = nil) : Crest::Request
@return Crest::Request
-
#build_api_request_for_post_products_product_features(*, product : String | Nil = nil, entitlement_feature : String | Nil = nil, expand : Array(String) | Nil = nil) : Crest::Request
@return Crest::Request
- #client_side_validation?(*args, **options)
- #client_side_validation?(*args, **options, &)
- #debugging?(*args, **options)
- #debugging?(*args, **options, &)
-
#delete_products_id(*, id : String | Nil = nil) : Stripe::DeletedProduct
Delete a product.
-
#delete_products_id(*, id : String | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Delete a product.
-
#delete_products_id_with_http_info(*, id : String | Nil = nil) : Tuple(Stripe::DeletedProduct, Int32, Hash(String, Array(String) | String))
<p>Delete a product.
-
#delete_products_product_features_id(*, id : String | Nil = nil, product : String | Nil = nil) : Stripe::DeletedProductFeature
Deletes the feature attachment to a product
@required @param id [String?] @required @param product [String?] @return [Stripe::DeletedProductFeature] -
#delete_products_product_features_id(*, id : String | Nil = nil, product : String | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Deletes the feature attachment to a product</p> @required @param id [String?] @required @param product [String?] @return nil
-
#delete_products_product_features_id_with_http_info(*, id : String | Nil = nil, product : String | Nil = nil) : Tuple(Stripe::DeletedProductFeature, Int32, Hash(String, Array(String) | String))
<p>Deletes the feature attachment to a product</p> @required @param id [String?] @required @param product [String?] @return [Tuple(Stripe::DeletedProductFeature, Integer, Hash)] Stripe::DeletedProductFeature, response status code and response headers
-
#get_products(*, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, _type : String | Nil = nil, active : Bool | Nil = nil, shippable : Bool | Nil = nil, created : Stripe::GetAccountsCreatedParameter | Nil = nil, ids : Array(Array(String)) | Nil = nil, url : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Stripe::ProductList
Returns a list of your products.
-
#get_products(*, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, _type : String | Nil = nil, active : Bool | Nil = nil, shippable : Bool | Nil = nil, created : Stripe::GetAccountsCreatedParameter | Nil = nil, ids : Array(Array(String)) | Nil = nil, url : String | Nil = nil, expand : Array(Array(String)) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Returns a list of your products.
-
#get_products_id(*, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Stripe::Product
Retrieves the details of an existing product.
-
#get_products_id(*, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Retrieves the details of an existing product.
-
#get_products_id_with_http_info(*, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Tuple(Stripe::Product, Int32, Hash(String, Array(String) | String))
<p>Retrieves the details of an existing product.
-
#get_products_product_features(*, product : String | Nil = nil, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Stripe::EntitlementsResourceProductFeatureList
Retrieve a list of features for a product
@required @param product [String?] @optional @param ending_before [String?] A cursor for use in pagination. -
#get_products_product_features(*, product : String | Nil = nil, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Retrieve a list of features for a product</p> @required @param product [String?] @optional @param ending_before [String?] A cursor for use in pagination.
-
#get_products_product_features_id(*, product : String | Nil = nil, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Stripe::ProductFeature
Retrieves a product_feature, which represents a feature attachment to a product
@required @param product [String?] The ID of the product. -
#get_products_product_features_id(*, product : String | Nil = nil, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Retrieves a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] The ID of the product.
-
#get_products_product_features_id_with_http_info(*, product : String | Nil = nil, id : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Tuple(Stripe::ProductFeature, Int32, Hash(String, Array(String) | String))
<p>Retrieves a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] The ID of the product.
-
#get_products_product_features_with_http_info(*, product : String | Nil = nil, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Tuple(Stripe::EntitlementsResourceProductFeatureList, Int32, Hash(String, Array(String) | String))
<p>Retrieve a list of features for a product</p> @required @param product [String?] @optional @param ending_before [String?] A cursor for use in pagination.
-
#get_products_search(*, query : String | Nil = nil, page : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Stripe::SearchResult
Search for products you’ve previously created using Stripe’s Search Query Language.
-
#get_products_search(*, query : String | Nil = nil, page : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Search for products you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search Query Language</a>.
-
#get_products_search_with_http_info(*, query : String | Nil = nil, page : String | Nil = nil, limit : Int64 | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Tuple(Stripe::SearchResult, Int32, Hash(String, Array(String) | String))
<p>Search for products you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search Query Language</a>.
-
#get_products_with_http_info(*, ending_before : String | Nil = nil, starting_after : String | Nil = nil, limit : Int64 | Nil = nil, _type : String | Nil = nil, active : Bool | Nil = nil, shippable : Bool | Nil = nil, created : Stripe::GetAccountsCreatedParameter | Nil = nil, ids : Array(Array(String)) | Nil = nil, url : String | Nil = nil, expand : Array(Array(String)) | Nil = nil) : Tuple(Stripe::ProductList, Int32, Hash(String, Array(String) | String))
<p>Returns a list of your products.
-
#post_products(*, name : String | Nil = nil, active : Bool | Nil = nil, default_price_data : Stripe::PriceDataWithoutProduct | Nil = nil, description : String | Nil = nil, expand : Array(String) | Nil = nil, id : String | Nil = nil, images : Array(String) | Nil = nil, marketing_features : Array(Stripe::Features) | Nil = nil, metadata : Hash(String, String) | Nil = nil, package_dimensions : Stripe::PackageDimensionsSpecs | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : String | Nil = nil, _type : String | Nil = nil, unit_label : String | Nil = nil, url : String | Nil = nil) : Stripe::Product
Creates a new product object.
@required @param name [String?] The product's name, meant to be displayable to the customer. -
#post_products(*, name : String | Nil = nil, active : Bool | Nil = nil, default_price_data : Stripe::PriceDataWithoutProduct | Nil = nil, description : String | Nil = nil, expand : Array(String) | Nil = nil, id : String | Nil = nil, images : Array(String) | Nil = nil, marketing_features : Array(Stripe::Features) | Nil = nil, metadata : Hash(String, String) | Nil = nil, package_dimensions : Stripe::PackageDimensionsSpecs | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : String | Nil = nil, _type : String | Nil = nil, unit_label : String | Nil = nil, url : String | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Creates a new product object.</p> @required @param name [String?] The product's name, meant to be displayable to the customer.
-
#post_products_id(*, id : String | Nil = nil, active : Bool | Nil = nil, default_price : String | Nil = nil, description : Stripe::PostProductsIdRequestDescription | Nil = nil, expand : Array(String) | Nil = nil, images : Stripe::PostProductsIdRequestImages | Nil = nil, marketing_features : Stripe::PostProductsIdRequestMarketingFeatures | Nil = nil, metadata : Stripe::PostAccountsRequestMetadata | Nil = nil, name : String | Nil = nil, package_dimensions : Stripe::PostProductsIdRequestPackageDimensions | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : Stripe::PostInvoiceitemsRequestTaxCode | Nil = nil, unit_label : Stripe::PostProductsIdRequestUnitLabel | Nil = nil, url : Stripe::PostProductsIdRequestUrl | Nil = nil) : Stripe::Product
Updates the specific product by setting the values of the parameters passed.
-
#post_products_id(*, id : String | Nil = nil, active : Bool | Nil = nil, default_price : String | Nil = nil, description : Stripe::PostProductsIdRequestDescription | Nil = nil, expand : Array(String) | Nil = nil, images : Stripe::PostProductsIdRequestImages | Nil = nil, marketing_features : Stripe::PostProductsIdRequestMarketingFeatures | Nil = nil, metadata : Stripe::PostAccountsRequestMetadata | Nil = nil, name : String | Nil = nil, package_dimensions : Stripe::PostProductsIdRequestPackageDimensions | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : Stripe::PostInvoiceitemsRequestTaxCode | Nil = nil, unit_label : Stripe::PostProductsIdRequestUnitLabel | Nil = nil, url : Stripe::PostProductsIdRequestUrl | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Updates the specific product by setting the values of the parameters passed.
-
#post_products_id_with_http_info(*, id : String | Nil = nil, active : Bool | Nil = nil, default_price : String | Nil = nil, description : Stripe::PostProductsIdRequestDescription | Nil = nil, expand : Array(String) | Nil = nil, images : Stripe::PostProductsIdRequestImages | Nil = nil, marketing_features : Stripe::PostProductsIdRequestMarketingFeatures | Nil = nil, metadata : Stripe::PostAccountsRequestMetadata | Nil = nil, name : String | Nil = nil, package_dimensions : Stripe::PostProductsIdRequestPackageDimensions | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : Stripe::PostInvoiceitemsRequestTaxCode | Nil = nil, unit_label : Stripe::PostProductsIdRequestUnitLabel | Nil = nil, url : Stripe::PostProductsIdRequestUrl | Nil = nil) : Tuple(Stripe::Product, Int32, Hash(String, Array(String) | String))
<p>Updates the specific product by setting the values of the parameters passed.
-
#post_products_product_features(*, product : String | Nil = nil, entitlement_feature : String | Nil = nil, expand : Array(String) | Nil = nil) : Stripe::ProductFeature
Creates a product_feature, which represents a feature attachment to a product
@required @param product [String?] @required @param entitlement_feature [String?] The ID of the [Feature](https://stripe.com/docs/api/entitlements/feature) object attached to this product. -
#post_products_product_features(*, product : String | Nil = nil, entitlement_feature : String | Nil = nil, expand : Array(String) | Nil = nil, &block : Crest::Response -> ) : Nil
<p>Creates a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] @required @param entitlement_feature [String?] The ID of the Feature object attached to this product.
-
#post_products_product_features_with_http_info(*, product : String | Nil = nil, entitlement_feature : String | Nil = nil, expand : Array(String) | Nil = nil) : Tuple(Stripe::ProductFeature, Int32, Hash(String, Array(String) | String))
<p>Creates a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] @required @param entitlement_feature [String?] The ID of the Feature object attached to this product.
-
#post_products_with_http_info(*, name : String | Nil = nil, active : Bool | Nil = nil, default_price_data : Stripe::PriceDataWithoutProduct | Nil = nil, description : String | Nil = nil, expand : Array(String) | Nil = nil, id : String | Nil = nil, images : Array(String) | Nil = nil, marketing_features : Array(Stripe::Features) | Nil = nil, metadata : Hash(String, String) | Nil = nil, package_dimensions : Stripe::PackageDimensionsSpecs | Nil = nil, shippable : Bool | Nil = nil, statement_descriptor : String | Nil = nil, tax_code : String | Nil = nil, _type : String | Nil = nil, unit_label : String | Nil = nil, url : String | Nil = nil) : Tuple(Stripe::Product, Int32, Hash(String, Array(String) | String))
<p>Creates a new product object.</p> @required @param name [String?] The product's name, meant to be displayable to the customer.
Constructor Detail
Instance Method Detail
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
@return Crest::Request
Delete a product. Deleting a product is only possible if it has no prices associated with it. Additionally, deleting a product with type=good
is only possible if it has no SKUs associated with it.
<p>Delete a product. Deleting a product is only possible if it has no prices associated with it. Additionally, deleting a product with <code>type=good</code> is only possible if it has no SKUs associated with it.</p> @required @param id [String?] @return nil
<p>Delete a product. Deleting a product is only possible if it has no prices associated with it. Additionally, deleting a product with <code>type=good</code> is only possible if it has no SKUs associated with it.</p> @required @param id [String?] @return [Tuple(Stripe::DeletedProduct, Integer, Hash)] Stripe::DeletedProduct, response status code and response headers
Deletes the feature attachment to a product
@required @param id [String?] @required @param product [String?] @return [Stripe::DeletedProductFeature]<p>Deletes the feature attachment to a product</p> @required @param id [String?] @required @param product [String?] @return nil
<p>Deletes the feature attachment to a product</p> @required @param id [String?] @required @param product [String?] @return [Tuple(Stripe::DeletedProductFeature, Integer, Hash)] Stripe::DeletedProductFeature, response status code and response headers
Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.
@optional @param ending_before [String?] A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. @optional @param starting_after [String?] A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. @optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. @optional @param _type [String?] Only return products of this type. @optional @param active [Bool?] Only return products that are active or inactive (e.g., pass `false` to list all inactive products). @optional @param shippable [Bool?] Only return products that can be shipped (i.e., physical, not digital products). @optional @param created [Stripe::GetAccountsCreatedParameter?] Only return products that were created during the given date interval. @optional @param ids [Array(Array(String))?] Only return products with the given IDs. Cannot be used with [starting_after](https://stripe.com/docs/api#list_products-starting_after) or [ending_before](https://stripe.com/docs/api#list_products-ending_before). @optional @param url [String?] Only return products with the given url. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Stripe::ProductList]<p>Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.</p>
@optional @param ending_before [String?] A cursor for use in pagination. ending_before
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar
, your subsequent call can include ending_before=obj_bar
in order to fetch the previous page of the list.
@optional @param starting_after [String?] A cursor for use in pagination. starting_after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo
, your subsequent call can include starting_after=obj_foo
in order to fetch the next page of the list.
@optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
@optional @param _type [String?] Only return products of this type.
@optional @param active [Bool?] Only return products that are active or inactive (e.g., pass false
to list all inactive products).
@optional @param shippable [Bool?] Only return products that can be shipped (i.e., physical, not digital products).
@optional @param created [Stripe::GetAccountsCreatedParameter?] Only return products that were created during the given date interval.
@optional @param ids [Array(Array(String))?] Only return products with the given IDs. Cannot be used with starting_after or ending_before.
@optional @param url [String?] Only return products with the given url.
@optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded.
@return nil
Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Stripe will return the corresponding product information.
@required @param id [String?] @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Stripe::Product]<p>Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Stripe will return the corresponding product information.</p> @required @param id [String?] @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return nil
<p>Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Stripe will return the corresponding product information.</p> @required @param id [String?] @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Tuple(Stripe::Product, Integer, Hash)] Stripe::Product, response status code and response headers
Retrieve a list of features for a product
@required @param product [String?] @optional @param ending_before [String?] A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. @optional @param starting_after [String?] A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. @optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Stripe::EntitlementsResourceProductFeatureList]<p>Retrieve a list of features for a product</p>
@required @param product [String?]
@optional @param ending_before [String?] A cursor for use in pagination. ending_before
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar
, your subsequent call can include ending_before=obj_bar
in order to fetch the previous page of the list.
@optional @param starting_after [String?] A cursor for use in pagination. starting_after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo
, your subsequent call can include starting_after=obj_foo
in order to fetch the next page of the list.
@optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
@optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded.
@return nil
Retrieves a product_feature, which represents a feature attachment to a product
@required @param product [String?] The ID of the product. @required @param id [String?] The ID of the product_feature. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Stripe::ProductFeature]<p>Retrieves a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] The ID of the product. @required @param id [String?] The ID of the product_feature. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return nil
<p>Retrieves a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] The ID of the product. @required @param id [String?] The ID of the product_feature. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Tuple(Stripe::ProductFeature, Integer, Hash)] Stripe::ProductFeature, response status code and response headers
<p>Retrieve a list of features for a product</p>
@required @param product [String?]
@optional @param ending_before [String?] A cursor for use in pagination. ending_before
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar
, your subsequent call can include ending_before=obj_bar
in order to fetch the previous page of the list.
@optional @param starting_after [String?] A cursor for use in pagination. starting_after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo
, your subsequent call can include starting_after=obj_foo
in order to fetch the next page of the list.
@optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
@optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded.
@return [Tuple(Stripe::EntitlementsResourceProductFeatureList, Integer, Hash)] Stripe::EntitlementsResourceProductFeatureList, response status code and response headers
Search for products you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.
@required @param query [String?] The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for products](https://stripe.com/docs/search#query-fields-for-products). @optional @param page [String?] A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. @optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Stripe::SearchResult]<p>Search for products you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search Query Language</a>. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.</p> @required @param query [String?] The search query string. See search query language and the list of supported query fields for products. @optional @param page [String?] A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. @optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return nil
<p>Search for products you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search Query Language</a>. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.</p> @required @param query [String?] The search query string. See search query language and the list of supported query fields for products. @optional @param page [String?] A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. @optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. @optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded. @return [Tuple(Stripe::SearchResult, Integer, Hash)] Stripe::SearchResult, response status code and response headers
<p>Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.</p>
@optional @param ending_before [String?] A cursor for use in pagination. ending_before
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar
, your subsequent call can include ending_before=obj_bar
in order to fetch the previous page of the list.
@optional @param starting_after [String?] A cursor for use in pagination. starting_after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo
, your subsequent call can include starting_after=obj_foo
in order to fetch the next page of the list.
@optional @param limit [Int32?] A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
@optional @param _type [String?] Only return products of this type.
@optional @param active [Bool?] Only return products that are active or inactive (e.g., pass false
to list all inactive products).
@optional @param shippable [Bool?] Only return products that can be shipped (i.e., physical, not digital products).
@optional @param created [Stripe::GetAccountsCreatedParameter?] Only return products that were created during the given date interval.
@optional @param ids [Array(Array(String))?] Only return products with the given IDs. Cannot be used with starting_after or ending_before.
@optional @param url [String?] Only return products with the given url.
@optional @param expand [Array(Array(String))?] Specifies which fields in the response should be expanded.
@return [Tuple(Stripe::ProductList, Integer, Hash)] Stripe::ProductList, response status code and response headers
Creates a new product object.
@required @param name [String?] The product's name, meant to be displayable to the customer. @optional @param active [Bool?] Whether the product is currently available for purchase. Defaults to `true`. @optional @param default_price_data [Stripe::PriceDataWithoutProduct?] @optional @param description [String?] The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes. @optional @param expand [Array(String)?] Specifies which fields in the response should be expanded. @optional @param id [String?] An identifier will be randomly generated by Stripe. You can optionally override this ID, but the ID must be unique across all products in your Stripe account. @optional @param images [Array(String)?] A list of up to 8 URLs of images for this product, meant to be displayable to the customer. @optional @param marketing_features [Array(Stripe::Features)?] A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table). @optional @param metadata [Hash(String, String)?] @optional @param package_dimensions [Stripe::PackageDimensionsSpecs?] @optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods). @optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include `<`, `>`, `\\\\`, `\\\"`, `'` characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. Only used for subscription payments. @optional @param tax_code [String?] A [tax code](https://stripe.com/docs/tax/tax-categories) ID. @optional @param _type [String?] The type of the product. Defaults to `service` if not explicitly specified, enabling use of this product with Subscriptions and Plans. Set this parameter to `good` to use this product with Orders and SKUs. On API versions before `2018-02-05`, this field defaults to `good` for compatibility reasons. @optional @param unit_label [String?] A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal. @optional @param url [String?] A URL of a publicly-accessible webpage for this product. @return [Stripe::Product]<p>Creates a new product object.</p>
@required @param name [String?] The product's name, meant to be displayable to the customer.
@optional @param active [Bool?] Whether the product is currently available for purchase. Defaults to true
.
@optional @param default_price_data [Stripe::PriceDataWithoutProduct?]
@optional @param description [String?] The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
@optional @param expand [Array(String)?] Specifies which fields in the response should be expanded.
@optional @param id [String?] An identifier will be randomly generated by Stripe. You can optionally override this ID, but the ID must be unique across all products in your Stripe account.
@optional @param images [Array(String)?] A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
@optional @param marketing_features [Array(Stripe::Features)?] A list of up to 15 marketing features for this product. These are displayed in pricing tables.
@optional @param metadata [Hash(String, String)?]
@optional @param package_dimensions [Stripe::PackageDimensionsSpecs?]
@optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods).
@optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include <
, >
, \\\\
, \\\"
, '
characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. Only used for subscription payments.
@optional @param tax_code [String?] A tax code ID.
@optional @param _type [String?] The type of the product. Defaults to service
if not explicitly specified, enabling use of this product with Subscriptions and Plans. Set this parameter to good
to use this product with Orders and SKUs. On API versions before 2018-02-05
, this field defaults to good
for compatibility reasons.
@optional @param unit_label [String?] A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
@optional @param url [String?] A URL of a publicly-accessible webpage for this product.
@return nil
Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
@required @param id [String?] @optional @param active [Bool?] Whether the product is available for purchase. @optional @param default_price [String?] The ID of the [Price](https://stripe.com/docs/api/prices) object that is the default price for this product. @optional @param description [Stripe::PostProductsIdRequestDescription?] @optional @param expand [Array(String)?] Specifies which fields in the response should be expanded. @optional @param images [Stripe::PostProductsIdRequestImages?] @optional @param marketing_features [Stripe::PostProductsIdRequestMarketingFeatures?] @optional @param metadata [Stripe::PostAccountsRequestMetadata?] @optional @param name [String?] The product's name, meant to be displayable to the customer. @optional @param package_dimensions [Stripe::PostProductsIdRequestPackageDimensions?] @optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods). @optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include `<`, `>`, `\\\\`, `\\\"`, `'` characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. May only be set if `type=service`. Only used for subscription payments. @optional @param tax_code [Stripe::PostInvoiceitemsRequestTaxCode?] @optional @param unit_label [Stripe::PostProductsIdRequestUnitLabel?] @optional @param url [Stripe::PostProductsIdRequestUrl?] @return [Stripe::Product]<p>Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
@required @param id [String?]
@optional @param active [Bool?] Whether the product is available for purchase.
@optional @param default_price [String?] The ID of the Price object that is the default price for this product.
@optional @param description [Stripe::PostProductsIdRequestDescription?]
@optional @param expand [Array(String)?] Specifies which fields in the response should be expanded.
@optional @param images [Stripe::PostProductsIdRequestImages?]
@optional @param marketing_features [Stripe::PostProductsIdRequestMarketingFeatures?]
@optional @param metadata [Stripe::PostAccountsRequestMetadata?]
@optional @param name [String?] The product's name, meant to be displayable to the customer.
@optional @param package_dimensions [Stripe::PostProductsIdRequestPackageDimensions?]
@optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods).
@optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include <
, >
, \\\\
, \\\"
, '
characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. May only be set if type=service
. Only used for subscription payments.
@optional @param tax_code [Stripe::PostInvoiceitemsRequestTaxCode?]
@optional @param unit_label [Stripe::PostProductsIdRequestUnitLabel?]
@optional @param url [Stripe::PostProductsIdRequestUrl?]
@return nil
<p>Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
@required @param id [String?]
@optional @param active [Bool?] Whether the product is available for purchase.
@optional @param default_price [String?] The ID of the Price object that is the default price for this product.
@optional @param description [Stripe::PostProductsIdRequestDescription?]
@optional @param expand [Array(String)?] Specifies which fields in the response should be expanded.
@optional @param images [Stripe::PostProductsIdRequestImages?]
@optional @param marketing_features [Stripe::PostProductsIdRequestMarketingFeatures?]
@optional @param metadata [Stripe::PostAccountsRequestMetadata?]
@optional @param name [String?] The product's name, meant to be displayable to the customer.
@optional @param package_dimensions [Stripe::PostProductsIdRequestPackageDimensions?]
@optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods).
@optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include <
, >
, \\\\
, \\\"
, '
characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. May only be set if type=service
. Only used for subscription payments.
@optional @param tax_code [Stripe::PostInvoiceitemsRequestTaxCode?]
@optional @param unit_label [Stripe::PostProductsIdRequestUnitLabel?]
@optional @param url [Stripe::PostProductsIdRequestUrl?]
@return [Tuple(Stripe::Product, Integer, Hash)] Stripe::Product, response status code and response headers
Creates a product_feature, which represents a feature attachment to a product
@required @param product [String?] @required @param entitlement_feature [String?] The ID of the [Feature](https://stripe.com/docs/api/entitlements/feature) object attached to this product. @optional @param expand [Array(String)?] Specifies which fields in the response should be expanded. @return [Stripe::ProductFeature]<p>Creates a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] @required @param entitlement_feature [String?] The ID of the Feature object attached to this product. @optional @param expand [Array(String)?] Specifies which fields in the response should be expanded. @return nil
<p>Creates a product_feature, which represents a feature attachment to a product</p> @required @param product [String?] @required @param entitlement_feature [String?] The ID of the Feature object attached to this product. @optional @param expand [Array(String)?] Specifies which fields in the response should be expanded. @return [Tuple(Stripe::ProductFeature, Integer, Hash)] Stripe::ProductFeature, response status code and response headers
<p>Creates a new product object.</p>
@required @param name [String?] The product's name, meant to be displayable to the customer.
@optional @param active [Bool?] Whether the product is currently available for purchase. Defaults to true
.
@optional @param default_price_data [Stripe::PriceDataWithoutProduct?]
@optional @param description [String?] The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
@optional @param expand [Array(String)?] Specifies which fields in the response should be expanded.
@optional @param id [String?] An identifier will be randomly generated by Stripe. You can optionally override this ID, but the ID must be unique across all products in your Stripe account.
@optional @param images [Array(String)?] A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
@optional @param marketing_features [Array(Stripe::Features)?] A list of up to 15 marketing features for this product. These are displayed in pricing tables.
@optional @param metadata [Hash(String, String)?]
@optional @param package_dimensions [Stripe::PackageDimensionsSpecs?]
@optional @param shippable [Bool?] Whether this product is shipped (i.e., physical goods).
@optional @param statement_descriptor [String?] An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all. This may be up to 22 characters. The statement description may not include <
, >
, \\\\
, \\\"
, '
characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. It must contain at least one letter. Only used for subscription payments.
@optional @param tax_code [String?] A tax code ID.
@optional @param _type [String?] The type of the product. Defaults to service
if not explicitly specified, enabling use of this product with Subscriptions and Plans. Set this parameter to good
to use this product with Orders and SKUs. On API versions before 2018-02-05
, this field defaults to good
for compatibility reasons.
@optional @param unit_label [String?] A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
@optional @param url [String?] A URL of a publicly-accessible webpage for this product.
@return [Tuple(Stripe::Product, Integer, Hash)] Stripe::Product, response status code and response headers