stripeapi-0.1.0.0: Stripe-Library

Safe HaskellNone
LanguageHaskell2010

StripeAPI.Operations.PostRecipientsId

Description

Contains the different functions to run the operation postRecipientsId

Synopsis

Documentation

postRecipientsId Source #

Arguments

:: (MonadHTTP m, SecurityScheme s) 
=> Configuration s

The configuration to use in the request

-> String

id | Constraints: Maximum length of 5000

-> PostRecipientsIdRequestBody

The request body to send

-> m (Either HttpException (Response PostRecipientsIdResponse))

Monad containing the result of the operation

POST /v1/recipients/{id}

<p>Updates the specified recipient by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>

<p>If you update the name or tax ID, the identity verification will automatically be rerun. If you update the bank account, the bank account validation will automatically be rerun.</p>

postRecipientsIdRaw :: forall m s. (MonadHTTP m, SecurityScheme s) => Configuration s -> String -> PostRecipientsIdRequestBody -> m (Either HttpException (Response ByteString)) Source #

POST /v1/recipients/{id}

The same as postRecipientsId but returns the raw ByteString

data PostRecipientsIdRequestBody Source #

Defines the data type for the schema postRecipientsIdRequestBody

Constructors

PostRecipientsIdRequestBody 

Fields

  • postRecipientsIdRequestBodyBankAccount :: Maybe String

    bank_account: A bank account to attach to the recipient. You can provide either a token, like the ones returned by Stripe.js, or a dictionary containing a user's bank account details, with the options described below.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyCard :: Maybe String

    card: A U.S. Visa or MasterCard debit card (not prepaid) to attach to the recipient. You can provide either a token, like the ones returned by Stripe.js, or a dictionary containing a user's debit card details, with the options described below. Passing `card` will create a new card, make it the new recipient default card, and delete the old recipient default (if one exists). If you want to add additional debit cards instead of replacing the existing default, use the card creation API. Whenever you attach a card to a recipient, Stripe will automatically validate the debit card.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyDefaultCard :: Maybe String

    default_card: ID of the card to set as the recipient's new default for payouts.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyDescription :: Maybe String

    description: An arbitrary string which you can attach to a `Recipient` object. It is displayed alongside the recipient in the web interface.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyEmail :: Maybe String

    email: The recipient's email address. It is displayed alongside the recipient in the web interface, and can be useful for searching and tracking.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyExpand :: Maybe ([] String)

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

  • postRecipientsIdRequestBodyMetadata :: Maybe PostRecipientsIdRequestBodyMetadata'

    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`.

  • postRecipientsIdRequestBodyName :: Maybe String

    name: The recipient's full, legal name. For type `individual`, should be in the format `First Last`, `First Middle Last`, or `First M Last` (no prefixes or suffixes). For `corporation`, the full, incorporated name.

    Constraints:

    • Maximum length of 5000
  • postRecipientsIdRequestBodyTaxId :: Maybe String

    tax_id: The recipient's tax ID, as a string. For type `individual`, the full SSN; for type `corporation`, the full EIN.

    Constraints:

    • Maximum length of 5000

data PostRecipientsIdRequestBodyMetadata' Source #

Defines the data type for the schema postRecipientsIdRequestBodyMetadata'

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`.

data PostRecipientsIdResponse Source #

Represents a response of the operation postRecipientsId.

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), PostRecipientsIdResponseError is used.

Constructors

PostRecipientsIdResponseError String

Means either no matching case available or a parse error

PostRecipientsIdResponse200 Recipient

Successful response.

PostRecipientsIdResponseDefault Error

Error response.