StripeAPI.Operations.PostProducts

Contains the different functions to run the operation postProducts

Documentation

postProducts

Arguments

:: forall m. MonadHTTP m

=> PostProductsRequestBody

The request body to send

-> StripeT m (Response PostProductsResponse)

Monadic computation which returns the result of the operation

POST /v1/products

<p>Creates a new product object.</p>

data PostProductsRequestBody

Defines the object schema located at paths./v1/products.POST.requestBody.content.application/x-www-form-urlencoded.schema in the specification.

Constructors

PostProductsRequestBody

Fields

• postProductsRequestBodyActive :: Maybe Bool

  active: Whether the product is currently available for purchase. Defaults to `true`.

• postProductsRequestBodyDescription :: Maybe Text

  description: 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.

  Constraints:

  • Maximum length of 40000
• postProductsRequestBodyExpand :: Maybe [Text]

  expand: Specifies which fields in the response should be expanded.

• postProductsRequestBodyId :: Maybe Text

  id: 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.

  Constraints:

  • Maximum length of 5000
• postProductsRequestBodyImages :: Maybe [Text]

  images: A list of up to 8 URLs of images for this product, meant to be displayable to the customer.

• postProductsRequestBodyMetadata :: Maybe Object

  metadata: 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.

• postProductsRequestBodyName :: Text

  name: The product's name, meant to be displayable to the customer. Whenever this product is sold via a subscription, name will show up on associated invoice line item descriptions.

  Constraints:

  • Maximum length of 5000
• postProductsRequestBodyPackageDimensions :: Maybe PostProductsRequestBodyPackageDimensions'

  package_dimensions: The dimensions of this product for shipping purposes.

• postProductsRequestBodyShippable :: Maybe Bool

  shippable: Whether this product is shipped (i.e., physical goods).

• postProductsRequestBodyStatementDescriptor :: Maybe Text

  statement_descriptor: 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.

  Constraints:

  • Maximum length of 22
• postProductsRequestBodyTaxCode :: Maybe Text

  tax_code: A tax code ID.

• postProductsRequestBodyUnitLabel :: Maybe Text

  unit_label: A label that represents units of this product in Stripe and on customers’ receipts and invoices. When set, this will be included in associated invoice line item descriptions.

  Constraints:

  • Maximum length of 12
• postProductsRequestBodyUrl :: Maybe Text

  url: A URL of a publicly-accessible webpage for this product.

  Constraints:

  • Maximum length of 5000

Instances

Eq PostProductsRequestBody

Defined in StripeAPI.Operations.PostProducts

Methods

(==) :: PostProductsRequestBody -> PostProductsRequestBody -> Bool

(/=) :: PostProductsRequestBody -> PostProductsRequestBody -> Bool

Show PostProductsRequestBody

Defined in StripeAPI.Operations.PostProducts

Methods

showsPrec :: Int -> PostProductsRequestBody -> ShowS

show :: PostProductsRequestBody -> String

showList :: [PostProductsRequestBody] -> ShowS

ToJSON PostProductsRequestBody

Defined in StripeAPI.Operations.PostProducts

Methods

toJSON :: PostProductsRequestBody -> Value

toEncoding :: PostProductsRequestBody -> Encoding

toJSONList :: [PostProductsRequestBody] -> Value

toEncodingList :: [PostProductsRequestBody] -> Encoding

FromJSON PostProductsRequestBody

Defined in StripeAPI.Operations.PostProducts

Methods

parseJSON :: Value -> Parser PostProductsRequestBody

parseJSONList :: Value -> Parser [PostProductsRequestBody]

mkPostProductsRequestBody

Arguments

:: Text

postProductsRequestBodyName

-> PostProductsRequestBody

Create a new PostProductsRequestBody with all required fields.

data PostProductsRequestBodyPackageDimensions'

Defines the object schema located at paths./v1/products.POST.requestBody.content.application/x-www-form-urlencoded.schema.properties.package_dimensions in the specification.

The dimensions of this product for shipping purposes.

Constructors

PostProductsRequestBodyPackageDimensions'

Fields

• postProductsRequestBodyPackageDimensions'Height :: Double

  height

• postProductsRequestBodyPackageDimensions'Length :: Double

  length

• postProductsRequestBodyPackageDimensions'Weight :: Double

  weight

• postProductsRequestBodyPackageDimensions'Width :: Double

  width

Instances

Eq PostProductsRequestBodyPackageDimensions'

Defined in StripeAPI.Operations.PostProducts

Methods

(==) :: PostProductsRequestBodyPackageDimensions' -> PostProductsRequestBodyPackageDimensions' -> Bool

(/=) :: PostProductsRequestBodyPackageDimensions' -> PostProductsRequestBodyPackageDimensions' -> Bool

Show PostProductsRequestBodyPackageDimensions'

Defined in StripeAPI.Operations.PostProducts

Methods

showsPrec :: Int -> PostProductsRequestBodyPackageDimensions' -> ShowS

show :: PostProductsRequestBodyPackageDimensions' -> String

showList :: [PostProductsRequestBodyPackageDimensions'] -> ShowS

ToJSON PostProductsRequestBodyPackageDimensions'

Defined in StripeAPI.Operations.PostProducts

Methods

toJSON :: PostProductsRequestBodyPackageDimensions' -> Value

toEncoding :: PostProductsRequestBodyPackageDimensions' -> Encoding

toJSONList :: [PostProductsRequestBodyPackageDimensions'] -> Value

toEncodingList :: [PostProductsRequestBodyPackageDimensions'] -> Encoding

FromJSON PostProductsRequestBodyPackageDimensions'

Defined in StripeAPI.Operations.PostProducts

Methods

parseJSON :: Value -> Parser PostProductsRequestBodyPackageDimensions'

parseJSONList :: Value -> Parser [PostProductsRequestBodyPackageDimensions']

mkPostProductsRequestBodyPackageDimensions'

Arguments

:: Double

postProductsRequestBodyPackageDimensions'Height

-> Double

postProductsRequestBodyPackageDimensions'Length

-> Double

postProductsRequestBodyPackageDimensions'Weight

-> Double

postProductsRequestBodyPackageDimensions'Width

-> PostProductsRequestBodyPackageDimensions'

Create a new PostProductsRequestBodyPackageDimensions' with all required fields.

data PostProductsResponse

Represents a response of the operation postProducts.

The response constructor is chosen by the status code of the response. If no case matches (no specific case for the response code, no range case, no default case), PostProductsResponseError is used.

Constructors

PostProductsResponseError String

Means either no matching case available or a parse error

PostProductsResponse200 Product

Successful response.

PostProductsResponseDefault Error

Error response.

Instances

Eq PostProductsResponse

Defined in StripeAPI.Operations.PostProducts

Methods

(==) :: PostProductsResponse -> PostProductsResponse -> Bool

(/=) :: PostProductsResponse -> PostProductsResponse -> Bool

Show PostProductsResponse

Defined in StripeAPI.Operations.PostProducts

Methods

showsPrec :: Int -> PostProductsResponse -> ShowS

show :: PostProductsResponse -> String

showList :: [PostProductsResponse] -> ShowS