naftiko: 1.0.0-alpha2
info:
  label: Stripe Customers API — Customers
  description: 'Stripe Customers API — Customers. 47 operations. Lead operation: Customers. Self-contained Naftiko capability
    covering one Stripe business surface.'
  tags:
  - Stripe
  - Customers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    STRIPE_API_KEY: STRIPE_API_KEY
capability:
  consumes:
  - type: http
    namespace: customers-customers
    baseUri: https://api.stripe.com
    description: Stripe Customers API — Customers business capability. Self-contained, no shared references.
    resources:
    - name: v1-customers
      path: /v1/customers
      operations:
      - name: getcustomers
        method: GET
        description: <p>Returns a list of your customers. The customers are returned sorted by creation date, with the most
          recent customers appearing first.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created
          in: query
          type: string
        - name: email
          in: query
          type: string
          description: A case-sensitive filter on the list based on the customer's `email` field. The value must be a string.
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: test_clock
          in: query
          type: string
          description: Provides a list of customers that are associated with the specified test clock. The response will not
            include customers with test clocks if this parameter is no
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomers
        method: POST
        description: <p>Creates a new customer object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-search
      path: /v1/customers/search
      operations:
      - name: getcustomerssearch
        method: GET
        description: <p>Search for customers you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search
          Query Language</a>.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: page
          in: query
          type: string
          description: 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 respons
        - name: query
          in: query
          type: string
          description: The search query string. See [search query language](https://stripe.com/docs/search#search-query-language)
            and the list of supported [query fields for customers
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer
      path: /v1/customers/{customer}
      operations:
      - name: deletecustomerscustomer
        method: DELETE
        description: <p>Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions
          on the customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomer
        method: GET
        description: <p>Retrieves a Customer object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomer
        method: POST
        description: '<p>Updates the specified customer by setting the values of the parameters passed. Any parameters not
          provided will be left unchanged. For example, if you pass the <strong>source</strong> parameter, that becomes the
          customer’s active source '
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-balance_transactions
      path: /v1/customers/{customer}/balance_transactions
      operations:
      - name: getcustomerscustomerbalancetransactions
        method: GET
        description: <p>Returns a list of transactions that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomerbalancetransactions
        method: POST
        description: <p>Creates an immutable transaction that updates the customer’s credit <a href="/docs/billing/customer/balance">balance</a>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-customers-customer-balance_transactions-transaction
      path: /v1/customers/{customer}/balance_transactions/{transaction}
      operations:
      - name: getcustomerscustomerbalancetransactionstransaction
        method: GET
        description: <p>Retrieves a specific customer balance transaction that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: transaction
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomerbalancetransactionstransaction
        method: POST
        description: <p>Most credit balance transaction fields are immutable, but you may update its <code>description</code>
          and <code>metadata</code>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: transaction
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-bank_accounts
      path: /v1/customers/{customer}/bank_accounts
      operations:
      - name: getcustomerscustomerbankaccounts
        method: GET
        description: <p>You can see a list of the bank accounts belonging to a Customer. Note that the 10 most recent sources
          are always available by default on the Customer. If you need more than those 10, you can use this API method and
          the <code>limit</code>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomerbankaccounts
        method: POST
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-bank_accounts-id
      path: /v1/customers/{customer}/bank_accounts/{id}
      operations:
      - name: deletecustomerscustomerbankaccountsid
        method: DELETE
        description: <p>Delete a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomerbankaccountsid
        method: GET
        description: <p>By default, you can see the 10 most recent sources stored on a Customer directly on the object, but
          you can also retrieve details about a specific bank account stored on the Stripe account.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomerbankaccountsid
        method: POST
        description: <p>Update a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-bank_accounts-id-verify
      path: /v1/customers/{customer}/bank_accounts/{id}/verify
      operations:
      - name: postcustomerscustomerbankaccountsidverify
        method: POST
        description: <p>Verify a specified bank account for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-cards
      path: /v1/customers/{customer}/cards
      operations:
      - name: getcustomerscustomercards
        method: GET
        description: <p>You can see a list of the cards belonging to a customer.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomercards
        method: POST
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-cards-id
      path: /v1/customers/{customer}/cards/{id}
      operations:
      - name: deletecustomerscustomercardsid
        method: DELETE
        description: <p>Delete a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomercardsid
        method: GET
        description: <p>You can always see the 10 most recent cards directly on a customer; this method lets you retrieve
          details about a specific card stored on the customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomercardsid
        method: POST
        description: <p>Update a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-cash_balance
      path: /v1/customers/{customer}/cash_balance
      operations:
      - name: getcustomerscustomercashbalance
        method: GET
        description: <p>Retrieves a customer’s cash balance.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomercashbalance
        method: POST
        description: <p>Changes the settings on a customer’s cash balance.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-cash_balance_transactions
      path: /v1/customers/{customer}/cash_balance_transactions
      operations:
      - name: getcustomerscustomercashbalancetransactions
        method: GET
        description: <p>Returns a list of transactions that modified the customer’s <a href="/docs/payments/customer-balance">cash
          balance</a>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-cash_balance_transactions-transaction
      path: /v1/customers/{customer}/cash_balance_transactions/{transaction}
      operations:
      - name: getcustomerscustomercashbalancetransactionstransaction
        method: GET
        description: <p>Retrieves a specific cash balance transaction, which updated the customer’s <a href="/docs/payments/customer-balance">cash
          balance</a>.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: transaction
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-discount
      path: /v1/customers/{customer}/discount
      operations:
      - name: deletecustomerscustomerdiscount
        method: DELETE
        description: <p>Removes the currently applied discount on a customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomerdiscount
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-funding_instructions
      path: /v1/customers/{customer}/funding_instructions
      operations:
      - name: postcustomerscustomerfundinginstructions
        method: POST
        description: <p>Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist
          for the customer, new
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-customers-customer-payment_methods
      path: /v1/customers/{customer}/payment_methods
      operations:
      - name: getcustomerscustomerpaymentmethods
        method: GET
        description: <p>Returns a list of PaymentMethods for a given Customer</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: type
          in: query
          type: string
          description: An optional filter on the list, based on the object `type` field. Without the filter, the list includes
            all current and future payment method types. If your int
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-payment_methods-payment_method
      path: /v1/customers/{customer}/payment_methods/{payment_method}
      operations:
      - name: getcustomerscustomerpaymentmethodspaymentmethod
        method: GET
        description: <p>Retrieves a PaymentMethod object for a given Customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: payment_method
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-sources
      path: /v1/customers/{customer}/sources
      operations:
      - name: getcustomerscustomersources
        method: GET
        description: <p>List sources for a specified customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: object
          in: query
          type: string
          description: Filter sources according to a particular object type.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomersources
        method: POST
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-sources-id
      path: /v1/customers/{customer}/sources/{id}
      operations:
      - name: deletecustomerscustomersourcesid
        method: DELETE
        description: <p>Delete a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomersourcesid
        method: GET
        description: <p>Retrieve a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomersourcesid
        method: POST
        description: <p>Update a specified source for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-sources-id-verify
      path: /v1/customers/{customer}/sources/{id}/verify
      operations:
      - name: postcustomerscustomersourcesidverify
        method: POST
        description: <p>Verify a specified bank account for a given customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-subscriptions
      path: /v1/customers/{customer}/subscriptions
      operations:
      - name: getcustomerscustomersubscriptions
        method: GET
        description: <p>You can see a list of the customer’s active subscriptions. Note that the 10 most recent active subscriptions
          are always available by default on the customer object. If you need more than those 10, you can use the limit and
          starting_after
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomersubscriptions
        method: POST
        description: <p>Creates a new subscription on an existing customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-subscriptions-subscription_exposed_id
      path: /v1/customers/{customer}/subscriptions/{subscription_exposed_id}
      operations:
      - name: deletecustomerscustomersubscriptionssubscriptionexposedid
        method: DELETE
        description: '<p>Cancels a customer’s subscription. If you set the <code>at_period_end</code> parameter to <code>true</code>,
          the subscription will remain active until the end of the period, at which point it will be canceled and not renewed.
          Otherwise, '
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: subscription_exposed_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomersubscriptionssubscriptionexposedid
        method: GET
        description: <p>Retrieves the subscription with the given ID.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: subscription_exposed_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomersubscriptionssubscriptionexposedid
        method: POST
        description: <p>Updates an existing subscription on a customer to match the specified parameters. When changing plans
          or quantities, we will optionally prorate the price we charge next month to make up for any price changes. To preview
          how the proration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: subscription_exposed_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-subscriptions-subscription_exposed_id-discount
      path: /v1/customers/{customer}/subscriptions/{subscription_exposed_id}/discount
      operations:
      - name: deletecustomerscustomersubscriptionssubscriptionexposediddiscount
        method: DELETE
        description: <p>Removes the currently applied discount on a customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: subscription_exposed_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomersubscriptionssubscriptionexposediddiscount
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: subscription_exposed_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-customers-customer-tax_ids
      path: /v1/customers/{customer}/tax_ids
      operations:
      - name: getcustomerscustomertaxids
        method: GET
        description: <p>Returns a list of tax IDs for a customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: ending_before
          in: query
          type: string
          description: 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 ob
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 10.
        - name: starting_after
          in: query
          type: string
          description: 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 o
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postcustomerscustomertaxids
        method: POST
        description: <p>Creates a new <code>tax_id</code> object for a customer.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-customers-customer-tax_ids-id
      path: /v1/customers/{customer}/tax_ids/{id}
      operations:
      - name: deletecustomerscustomertaxidsid
        method: DELETE
        description: <p>Deletes an existing <code>tax_id</code> object.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: getcustomerscustomertaxidsid
        method: GET
        description: <p>Retrieves the <code>tax_id</code> object with the given identifier.</p>
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        - name: expand
          in: query
          type: array
          description: Specifies which fields in the response should be expanded.
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.STRIPE_API_KEY}}'
  exposes:
  - type: rest
    namespace: customers-customers-rest
    port: 8080
    description: REST adapter for Stripe Customers API — Customers. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/customers
      name: v1-customers
      description: REST surface for v1-customers.
      operations:
      - method: GET
        name: getcustomers
        description: <p>Returns a list of your customers. The customers are returned sorted by creation date, with the most
          recent customers appearing first.</p>
        call: customers-customers.getcustomers
        with:
          created: rest.created
          email: rest.email
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          test_clock: rest.test_clock
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomers
        description: <p>Creates a new customer object.</p>
        call: customers-customers.postcustomers
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/search
      name: v1-customers-search
      description: REST surface for v1-customers-search.
      operations:
      - method: GET
        name: getcustomerssearch
        description: <p>Search for customers you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search
          Query Language</a>.
        call: customers-customers.getcustomerssearch
        with:
          expand: rest.expand
          limit: rest.limit
          page: rest.page
          query: rest.query
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}
      name: v1-customers-customer
      description: REST surface for v1-customers-customer.
      operations:
      - method: DELETE
        name: deletecustomerscustomer
        description: <p>Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions
          on the customer.</p>
        call: customers-customers.deletecustomerscustomer
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomer
        description: <p>Retrieves a Customer object.</p>
        call: customers-customers.getcustomerscustomer
        with:
          customer: rest.customer
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomer
        description: '<p>Updates the specified customer by setting the values of the parameters passed. Any parameters not
          provided will be left unchanged. For example, if you pass the <strong>source</strong> parameter, that becomes the
          customer’s active source '
        call: customers-customers.postcustomerscustomer
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/balance-transactions
      name: v1-customers-customer-balance-transactions
      description: REST surface for v1-customers-customer-balance_transactions.
      operations:
      - method: GET
        name: getcustomerscustomerbalancetransactions
        description: <p>Returns a list of transactions that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
        call: customers-customers.getcustomerscustomerbalancetransactions
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomerbalancetransactions
        description: <p>Creates an immutable transaction that updates the customer’s credit <a href="/docs/billing/customer/balance">balance</a>.</p>
        call: customers-customers.postcustomerscustomerbalancetransactions
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/balance-transactions/{transaction}
      name: v1-customers-customer-balance-transactions-transaction
      description: REST surface for v1-customers-customer-balance_transactions-transaction.
      operations:
      - method: GET
        name: getcustomerscustomerbalancetransactionstransaction
        description: <p>Retrieves a specific customer balance transaction that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
        call: customers-customers.getcustomerscustomerbalancetransactionstransaction
        with:
          customer: rest.customer
          expand: rest.expand
          transaction: rest.transaction
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomerbalancetransactionstransaction
        description: <p>Most credit balance transaction fields are immutable, but you may update its <code>description</code>
          and <code>metadata</code>.</p>
        call: customers-customers.postcustomerscustomerbalancetransactionstransaction
        with:
          customer: rest.customer
          transaction: rest.transaction
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/bank-accounts
      name: v1-customers-customer-bank-accounts
      description: REST surface for v1-customers-customer-bank_accounts.
      operations:
      - method: GET
        name: getcustomerscustomerbankaccounts
        description: <p>You can see a list of the bank accounts belonging to a Customer. Note that the 10 most recent sources
          are always available by default on the Customer. If you need more than those 10, you can use this API method and
          the <code>limit</code>
        call: customers-customers.getcustomerscustomerbankaccounts
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomerbankaccounts
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        call: customers-customers.postcustomerscustomerbankaccounts
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/bank-accounts/{id}
      name: v1-customers-customer-bank-accounts-id
      description: REST surface for v1-customers-customer-bank_accounts-id.
      operations:
      - method: DELETE
        name: deletecustomerscustomerbankaccountsid
        description: <p>Delete a specified source for a given customer.</p>
        call: customers-customers.deletecustomerscustomerbankaccountsid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomerbankaccountsid
        description: <p>By default, you can see the 10 most recent sources stored on a Customer directly on the object, but
          you can also retrieve details about a specific bank account stored on the Stripe account.</p>
        call: customers-customers.getcustomerscustomerbankaccountsid
        with:
          customer: rest.customer
          expand: rest.expand
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomerbankaccountsid
        description: <p>Update a specified source for a given customer.</p>
        call: customers-customers.postcustomerscustomerbankaccountsid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/bank-accounts/{id}/verify
      name: v1-customers-customer-bank-accounts-id-verify
      description: REST surface for v1-customers-customer-bank_accounts-id-verify.
      operations:
      - method: POST
        name: postcustomerscustomerbankaccountsidverify
        description: <p>Verify a specified bank account for a given customer.</p>
        call: customers-customers.postcustomerscustomerbankaccountsidverify
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/cards
      name: v1-customers-customer-cards
      description: REST surface for v1-customers-customer-cards.
      operations:
      - method: GET
        name: getcustomerscustomercards
        description: <p>You can see a list of the cards belonging to a customer.
        call: customers-customers.getcustomerscustomercards
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomercards
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        call: customers-customers.postcustomerscustomercards
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/cards/{id}
      name: v1-customers-customer-cards-id
      description: REST surface for v1-customers-customer-cards-id.
      operations:
      - method: DELETE
        name: deletecustomerscustomercardsid
        description: <p>Delete a specified source for a given customer.</p>
        call: customers-customers.deletecustomerscustomercardsid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomercardsid
        description: <p>You can always see the 10 most recent cards directly on a customer; this method lets you retrieve
          details about a specific card stored on the customer.</p>
        call: customers-customers.getcustomerscustomercardsid
        with:
          customer: rest.customer
          expand: rest.expand
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomercardsid
        description: <p>Update a specified source for a given customer.</p>
        call: customers-customers.postcustomerscustomercardsid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/cash-balance
      name: v1-customers-customer-cash-balance
      description: REST surface for v1-customers-customer-cash_balance.
      operations:
      - method: GET
        name: getcustomerscustomercashbalance
        description: <p>Retrieves a customer’s cash balance.</p>
        call: customers-customers.getcustomerscustomercashbalance
        with:
          customer: rest.customer
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomercashbalance
        description: <p>Changes the settings on a customer’s cash balance.</p>
        call: customers-customers.postcustomerscustomercashbalance
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/cash-balance-transactions
      name: v1-customers-customer-cash-balance-transactions
      description: REST surface for v1-customers-customer-cash_balance_transactions.
      operations:
      - method: GET
        name: getcustomerscustomercashbalancetransactions
        description: <p>Returns a list of transactions that modified the customer’s <a href="/docs/payments/customer-balance">cash
          balance</a>.</p>
        call: customers-customers.getcustomerscustomercashbalancetransactions
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/cash-balance-transactions/{transaction}
      name: v1-customers-customer-cash-balance-transactions-transaction
      description: REST surface for v1-customers-customer-cash_balance_transactions-transaction.
      operations:
      - method: GET
        name: getcustomerscustomercashbalancetransactionstransaction
        description: <p>Retrieves a specific cash balance transaction, which updated the customer’s <a href="/docs/payments/customer-balance">cash
          balance</a>.</p>
        call: customers-customers.getcustomerscustomercashbalancetransactionstransaction
        with:
          customer: rest.customer
          expand: rest.expand
          transaction: rest.transaction
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/discount
      name: v1-customers-customer-discount
      description: REST surface for v1-customers-customer-discount.
      operations:
      - method: DELETE
        name: deletecustomerscustomerdiscount
        description: <p>Removes the currently applied discount on a customer.</p>
        call: customers-customers.deletecustomerscustomerdiscount
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomerdiscount
        description: getcustomerscustomerdiscount
        call: customers-customers.getcustomerscustomerdiscount
        with:
          customer: rest.customer
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/funding-instructions
      name: v1-customers-customer-funding-instructions
      description: REST surface for v1-customers-customer-funding_instructions.
      operations:
      - method: POST
        name: postcustomerscustomerfundinginstructions
        description: <p>Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist
          for the customer, new
        call: customers-customers.postcustomerscustomerfundinginstructions
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/payment-methods
      name: v1-customers-customer-payment-methods
      description: REST surface for v1-customers-customer-payment_methods.
      operations:
      - method: GET
        name: getcustomerscustomerpaymentmethods
        description: <p>Returns a list of PaymentMethods for a given Customer</p>
        call: customers-customers.getcustomerscustomerpaymentmethods
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          type: rest.type
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/payment-methods/{payment-method}
      name: v1-customers-customer-payment-methods-payment-method
      description: REST surface for v1-customers-customer-payment_methods-payment_method.
      operations:
      - method: GET
        name: getcustomerscustomerpaymentmethodspaymentmethod
        description: <p>Retrieves a PaymentMethod object for a given Customer.</p>
        call: customers-customers.getcustomerscustomerpaymentmethodspaymentmethod
        with:
          customer: rest.customer
          expand: rest.expand
          payment_method: rest.payment_method
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/sources
      name: v1-customers-customer-sources
      description: REST surface for v1-customers-customer-sources.
      operations:
      - method: GET
        name: getcustomerscustomersources
        description: <p>List sources for a specified customer.</p>
        call: customers-customers.getcustomerscustomersources
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          object: rest.object
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomersources
        description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
        call: customers-customers.postcustomerscustomersources
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/sources/{id}
      name: v1-customers-customer-sources-id
      description: REST surface for v1-customers-customer-sources-id.
      operations:
      - method: DELETE
        name: deletecustomerscustomersourcesid
        description: <p>Delete a specified source for a given customer.</p>
        call: customers-customers.deletecustomerscustomersourcesid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomersourcesid
        description: <p>Retrieve a specified source for a given customer.</p>
        call: customers-customers.getcustomerscustomersourcesid
        with:
          customer: rest.customer
          expand: rest.expand
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomersourcesid
        description: <p>Update a specified source for a given customer.</p>
        call: customers-customers.postcustomerscustomersourcesid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/sources/{id}/verify
      name: v1-customers-customer-sources-id-verify
      description: REST surface for v1-customers-customer-sources-id-verify.
      operations:
      - method: POST
        name: postcustomerscustomersourcesidverify
        description: <p>Verify a specified bank account for a given customer.</p>
        call: customers-customers.postcustomerscustomersourcesidverify
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/subscriptions
      name: v1-customers-customer-subscriptions
      description: REST surface for v1-customers-customer-subscriptions.
      operations:
      - method: GET
        name: getcustomerscustomersubscriptions
        description: <p>You can see a list of the customer’s active subscriptions. Note that the 10 most recent active subscriptions
          are always available by default on the customer object. If you need more than those 10, you can use the limit and
          starting_after
        call: customers-customers.getcustomerscustomersubscriptions
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomersubscriptions
        description: <p>Creates a new subscription on an existing customer.</p>
        call: customers-customers.postcustomerscustomersubscriptions
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/subscriptions/{subscription-exposed-id}
      name: v1-customers-customer-subscriptions-subscription-exposed-id
      description: REST surface for v1-customers-customer-subscriptions-subscription_exposed_id.
      operations:
      - method: DELETE
        name: deletecustomerscustomersubscriptionssubscriptionexposedid
        description: '<p>Cancels a customer’s subscription. If you set the <code>at_period_end</code> parameter to <code>true</code>,
          the subscription will remain active until the end of the period, at which point it will be canceled and not renewed.
          Otherwise, '
        call: customers-customers.deletecustomerscustomersubscriptionssubscriptionexposedid
        with:
          customer: rest.customer
          subscription_exposed_id: rest.subscription_exposed_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomersubscriptionssubscriptionexposedid
        description: <p>Retrieves the subscription with the given ID.</p>
        call: customers-customers.getcustomerscustomersubscriptionssubscriptionexposedid
        with:
          customer: rest.customer
          expand: rest.expand
          subscription_exposed_id: rest.subscription_exposed_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomersubscriptionssubscriptionexposedid
        description: <p>Updates an existing subscription on a customer to match the specified parameters. When changing plans
          or quantities, we will optionally prorate the price we charge next month to make up for any price changes. To preview
          how the proration
        call: customers-customers.postcustomerscustomersubscriptionssubscriptionexposedid
        with:
          customer: rest.customer
          subscription_exposed_id: rest.subscription_exposed_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/subscriptions/{subscription-exposed-id}/discount
      name: v1-customers-customer-subscriptions-subscription-exposed-id-discount
      description: REST surface for v1-customers-customer-subscriptions-subscription_exposed_id-discount.
      operations:
      - method: DELETE
        name: deletecustomerscustomersubscriptionssubscriptionexposediddiscount
        description: <p>Removes the currently applied discount on a customer.</p>
        call: customers-customers.deletecustomerscustomersubscriptionssubscriptionexposediddiscount
        with:
          customer: rest.customer
          subscription_exposed_id: rest.subscription_exposed_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomersubscriptionssubscriptionexposediddiscount
        description: getcustomerscustomersubscriptionssubscriptionexposediddiscount
        call: customers-customers.getcustomerscustomersubscriptionssubscriptionexposediddiscount
        with:
          customer: rest.customer
          expand: rest.expand
          subscription_exposed_id: rest.subscription_exposed_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/tax-ids
      name: v1-customers-customer-tax-ids
      description: REST surface for v1-customers-customer-tax_ids.
      operations:
      - method: GET
        name: getcustomerscustomertaxids
        description: <p>Returns a list of tax IDs for a customer.</p>
        call: customers-customers.getcustomerscustomertaxids
        with:
          customer: rest.customer
          ending_before: rest.ending_before
          expand: rest.expand
          limit: rest.limit
          starting_after: rest.starting_after
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcustomerscustomertaxids
        description: <p>Creates a new <code>tax_id</code> object for a customer.</p>
        call: customers-customers.postcustomerscustomertaxids
        with:
          customer: rest.customer
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/customers/{customer}/tax-ids/{id}
      name: v1-customers-customer-tax-ids-id
      description: REST surface for v1-customers-customer-tax_ids-id.
      operations:
      - method: DELETE
        name: deletecustomerscustomertaxidsid
        description: <p>Deletes an existing <code>tax_id</code> object.</p>
        call: customers-customers.deletecustomerscustomertaxidsid
        with:
          customer: rest.customer
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcustomerscustomertaxidsid
        description: <p>Retrieves the <code>tax_id</code> object with the given identifier.</p>
        call: customers-customers.getcustomerscustomertaxidsid
        with:
          customer: rest.customer
          expand: rest.expand
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: customers-customers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Stripe Customers API — Customers. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: p-returns-list-your-customers-customers
      description: <p>Returns a list of your customers. The customers are returned sorted by creation date, with the most
        recent customers appearing first.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomers
      with:
        created: tools.created
        email: tools.email
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        test_clock: tools.test_clock
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-creates-new-customer-object-p
      description: <p>Creates a new customer object.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomers
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-search-customers-you-ve-previously-created
      description: <p>Search for customers you’ve previously created using Stripe’s <a href="/docs/search#search-query-language">Search
        Query Language</a>.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerssearch
      with:
        expand: tools.expand
        limit: tools.limit
        page: tools.page
        query: tools.query
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-permanently-deletes-customer-it-cannot
      description: <p>Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions
        on the customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomer
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-customer-object-p
      description: <p>Retrieves a Customer object.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomer
      with:
        customer: tools.customer
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-updates-specified-customer-setting-values
      description: '<p>Updates the specified customer by setting the values of the parameters passed. Any parameters not provided
        will be left unchanged. For example, if you pass the <strong>source</strong> parameter, that becomes the customer’s
        active source '
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomer
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-returns-list-transactions-that-updated
      description: <p>Returns a list of transactions that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerbalancetransactions
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-creates-immutable-transaction-that-updates
      description: <p>Creates an immutable transaction that updates the customer’s credit <a href="/docs/billing/customer/balance">balance</a>.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerbalancetransactions
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-specific-customer-balance-transaction
      description: <p>Retrieves a specific customer balance transaction that updated the customer’s <a href="/docs/billing/customer/balance">balances</a>.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerbalancetransactionstransaction
      with:
        customer: tools.customer
        expand: tools.expand
        transaction: tools.transaction
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-most-credit-balance-transaction-fields
      description: <p>Most credit balance transaction fields are immutable, but you may update its <code>description</code>
        and <code>metadata</code>.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerbalancetransactionstransaction
      with:
        customer: tools.customer
        transaction: tools.transaction
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-you-can-see-list-bank
      description: <p>You can see a list of the bank accounts belonging to a Customer. Note that the 10 most recent sources
        are always available by default on the Customer. If you need more than those 10, you can use this API method and the
        <code>limit</code>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerbankaccounts
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-when-you-create-new-credit
      description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerbankaccounts
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-delete-specified-source-given-customer
      description: <p>Delete a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomerbankaccountsid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-by-default-you-can-see
      description: <p>By default, you can see the 10 most recent sources stored on a Customer directly on the object, but
        you can also retrieve details about a specific bank account stored on the Stripe account.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerbankaccountsid
      with:
        customer: tools.customer
        expand: tools.expand
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-update-specified-source-given-customer
      description: <p>Update a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerbankaccountsid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-verify-specified-bank-account-given
      description: <p>Verify a specified bank account for a given customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerbankaccountsidverify
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-you-can-see-list-cards
      description: <p>You can see a list of the cards belonging to a customer.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomercards
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-when-you-create-new-credit-2
      description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomercards
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-delete-specified-source-given-customer-2
      description: <p>Delete a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomercardsid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-you-can-always-see-10
      description: <p>You can always see the 10 most recent cards directly on a customer; this method lets you retrieve details
        about a specific card stored on the customer.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomercardsid
      with:
        customer: tools.customer
        expand: tools.expand
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-update-specified-source-given-customer-2
      description: <p>Update a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomercardsid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-customer-s-cash-balance-p
      description: <p>Retrieves a customer’s cash balance.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomercashbalance
      with:
        customer: tools.customer
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-changes-settings-customer-s-cash-balance
      description: <p>Changes the settings on a customer’s cash balance.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomercashbalance
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-returns-list-transactions-that-modified
      description: <p>Returns a list of transactions that modified the customer’s <a href="/docs/payments/customer-balance">cash
        balance</a>.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomercashbalancetransactions
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-specific-cash-balance-transaction
      description: <p>Retrieves a specific cash balance transaction, which updated the customer’s <a href="/docs/payments/customer-balance">cash
        balance</a>.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomercashbalancetransactionstransaction
      with:
        customer: tools.customer
        expand: tools.expand
        transaction: tools.transaction
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-removes-currently-applied-discount-customer
      description: <p>Removes the currently applied discount on a customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomerdiscount
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getcustomerscustomerdiscount
      description: getcustomerscustomerdiscount
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerdiscount
      with:
        customer: tools.customer
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieve-funding-instructions-customer-cash
      description: <p>Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist
        for the customer, new
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomerfundinginstructions
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-returns-list-paymentmethods-given-customer
      description: <p>Returns a list of PaymentMethods for a given Customer</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerpaymentmethods
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        type: tools.type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-paymentmethod-object-given-customer
      description: <p>Retrieves a PaymentMethod object for a given Customer.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomerpaymentmethodspaymentmethod
      with:
        customer: tools.customer
        expand: tools.expand
        payment_method: tools.payment_method
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-list-sources-specified-customer-p
      description: <p>List sources for a specified customer.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomersources
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        object: tools.object
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-when-you-create-new-credit-3
      description: <p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomersources
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-delete-specified-source-given-customer-3
      description: <p>Delete a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomersourcesid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieve-specified-source-given-customer
      description: <p>Retrieve a specified source for a given customer.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomersourcesid
      with:
        customer: tools.customer
        expand: tools.expand
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-update-specified-source-given-customer-3
      description: <p>Update a specified source for a given customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomersourcesid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-verify-specified-bank-account-given-2
      description: <p>Verify a specified bank account for a given customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomersourcesidverify
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-you-can-see-list-customer-s
      description: <p>You can see a list of the customer’s active subscriptions. Note that the 10 most recent active subscriptions
        are always available by default on the customer object. If you need more than those 10, you can use the limit and
        starting_after
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomersubscriptions
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-creates-new-subscription-existing-customer
      description: <p>Creates a new subscription on an existing customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomersubscriptions
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-cancels-customer-s-subscription-if-you
      description: '<p>Cancels a customer’s subscription. If you set the <code>at_period_end</code> parameter to <code>true</code>,
        the subscription will remain active until the end of the period, at which point it will be canceled and not renewed.
        Otherwise, '
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomersubscriptionssubscriptionexposedid
      with:
        customer: tools.customer
        subscription_exposed_id: tools.subscription_exposed_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-subscription-given-id-p
      description: <p>Retrieves the subscription with the given ID.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomersubscriptionssubscriptionexposedid
      with:
        customer: tools.customer
        expand: tools.expand
        subscription_exposed_id: tools.subscription_exposed_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-updates-existing-subscription-customer-match
      description: <p>Updates an existing subscription on a customer to match the specified parameters. When changing plans
        or quantities, we will optionally prorate the price we charge next month to make up for any price changes. To preview
        how the proration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomersubscriptionssubscriptionexposedid
      with:
        customer: tools.customer
        subscription_exposed_id: tools.subscription_exposed_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-removes-currently-applied-discount-customer-2
      description: <p>Removes the currently applied discount on a customer.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomersubscriptionssubscriptionexposediddiscount
      with:
        customer: tools.customer
        subscription_exposed_id: tools.subscription_exposed_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getcustomerscustomersubscriptionssubscriptionexposediddiscount
      description: getcustomerscustomersubscriptionssubscriptionexposediddiscount
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomersubscriptionssubscriptionexposediddiscount
      with:
        customer: tools.customer
        expand: tools.expand
        subscription_exposed_id: tools.subscription_exposed_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-returns-list-tax-ids-customer
      description: <p>Returns a list of tax IDs for a customer.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomertaxids
      with:
        customer: tools.customer
        ending_before: tools.ending_before
        expand: tools.expand
        limit: tools.limit
        starting_after: tools.starting_after
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-creates-new-code-tax-id-code
      description: <p>Creates a new <code>tax_id</code> object for a customer.</p>
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: customers-customers.postcustomerscustomertaxids
      with:
        customer: tools.customer
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-deletes-existing-code-tax-id-code
      description: <p>Deletes an existing <code>tax_id</code> object.</p>
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: customers-customers.deletecustomerscustomertaxidsid
      with:
        customer: tools.customer
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: p-retrieves-code-tax-id-code-object
      description: <p>Retrieves the <code>tax_id</code> object with the given identifier.</p>
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: customers-customers.getcustomerscustomertaxidsid
      with:
        customer: tools.customer
        expand: tools.expand
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.