---
id: types-braintree
version: "4.46.0.20260814"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-braintree — Typing stubs for braintree

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

## What it is and what it does

types-braintree is a type stub package from the typeshed project that provides static type information for the braintree payment processing library. It allows Python type checkers like mypy, pyright, and others to understand and validate the types used in braintree code without requiring type hints in braintree itself.

When installed alongside braintree, this package enables your IDE and type checker to catch type mismatches, missing attributes, and incorrect method calls at development time rather than runtime. It has no runtime dependencies and is designed specifically for braintree version 4.46.*. The stubs are tested against multiple type checkers and maintained as part of the typeshed community project.

Use it for:

- Enable mypy or pyright to type-check payment processing code that uses braintree without runtime overhead.
- Catch attribute and method errors in braintree API calls during development via IDE autocompletion.
- Enforce type safety in CI/CD pipelines that validate braintree integration code before deployment.
- Document braintree's API surface through type annotations for developers unfamiliar with the library.

## Worth the install?

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

Provides type hints for the braintree payment processing library, enabling static type checking of braintree code with mypy, pyright, and other type checkers.

Yes, if you use braintree and want static type checking. Low friction, no runtime cost, and actively maintained. Install it alongside braintree and configure your type checker to use it. Not needed if you don't use braintree or don't perform type checking.

## Install

pip install types-braintree
uv add types-braintree
poetry add types-braintree

## Installing types-braintree

Before you install: Low install friction with no runtime dependencies. Actively maintained as part of typeshed, released on 2026-08-14 with recent commits.

License in practice: Apache-2.0 permissive license allows use in most projects without significant restrictions.

Quickstart:

pip install types-braintree

# In your code, import braintree normally:
import braintree

# Type checkers will now understand braintree's types when you run:
# mypy your_script.py

Requires Python 3.10 or later. The braintree package itself must be installed separately for runtime use.

Verify before relying:

- Whether this stub package is kept in sync with all braintree 4.46.* patch releases.
- Coverage completeness: which braintree APIs have full vs. partial type annotations.

## Package facts

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

## Tags

type stubs braintree, braintree type hints, static type checking payment, mypy braintree annotations, braintree typing support, type-stubs, payment-processing

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