---
id: types-stripe
version: "3.5.2.20240106"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-stripe — Typing stubs for stripe

License: permissive · Maintenance: active · Downloads: 845.2K/mo

## What it is and what it does

types-stripe is a PEP 561 type stub package that provides type annotations for the stripe Python library. It allows static type checkers like mypy, pyright, and pytype to understand and validate code that uses the stripe package, catching type errors before runtime. The stubs are generated from typeshed and aim to cover stripe version 3.5.*.

This package is primarily useful for developers working with older versions of stripe who want type safety in their payment processing code. The description notes that stripe itself includes type annotations since version 7.1.0, and recommends uninstalling this package if using that or a newer version. The stubs are marked as partial, meaning some annotations may be incomplete.

Use it for:

- Enable mypy or pyright type checking on stripe integration code when using stripe versions prior to 7.1.0
- Catch type errors in payment processing logic during development rather than at runtime
- Provide IDE autocomplete and type hints for stripe API calls in PyCharm and other editors

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for the stripe package, enabling static type checking of stripe code with tools like mypy, pyright, and pytype.

Yes, if you are using stripe before version 7.1.0 and want static type checking. No, if you are already on stripe 7.1.0 or later, as stripe now includes its own type annotations and the maintainers recommend uninstalling this package in that case. Check your stripe version first.

## Install

pip install types-stripe
uv add types-stripe
poetry add types-stripe

## Installing types-stripe

Before you install: Low install friction with no runtime dependencies. Actively maintained; last commit 2026-08-14.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install types-stripe

# Then use with mypy or pyright on code that imports stripe
import stripe
stripe.api_key = "sk_test_..."

Requires Python 3.8 or later. Note: stripe includes type annotations since version 7.1.0, making this package redundant for newer stripe versions.

Verify before relying:

- Whether this stub package remains actively maintained given that stripe has included type annotations since 7.1.0
- Coverage completeness of the stubs for stripe 3.5.x (marked as partial in the description)

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 845.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stripe type stubs, stripe type checking, mypy stripe annotations, pyright stripe types, stripe python typing, type-stubs, stripe-integration

[View on SkillFed](https://skillfed.io/packages/types-stripe) · [View on PyPI](https://pypi.org/project/types-stripe/)