---
id: beanstream
version: "1.0.1"
license: Apache2
license_treatment: permissive
maintenance: dormant
---

# beanstream — Beanstream SDK library for processing credit card payments.

License: permissive · Maintenance: dormant · Downloads: 87.6K/mo

## What it is and what it does

Beanstream is a Python SDK for the Beanstream payment processing API. It wraps the Beanstream REST API into a Gateway object that handles payment transactions, customer profiles, recurring billing, and merchant reporting. The library lets you construct and commit transactions—such as one-off credit card purchases, pre-authorizations, and voids—without directly calling HTTP endpoints.

The package has no external runtime dependencies, making installation straightforward in principle, but it is distributed as a source archive and has not been maintained since 2016-06-23. The repository shows a last commit of 2024-04-09, but no new releases have been published. If you are integrating with an active Beanstream merchant account, you should verify that the API endpoints and authentication methods this library uses remain current.

Use it for:

- Process one-off credit card payments in a Python e-commerce application using Beanstream as your payment processor.
- Implement recurring billing or subscription charges by configuring the gateway with recurring billing credentials.
- Create and manage customer payment profiles (tokenization) to store card details securely for future transactions.
- Retrieve transaction reports and reconciliation data from Beanstream for accounting and audit purposes.
- Pre-authorize transactions and void or complete them later as part of a multi-step payment workflow.

## Worth the install?

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

Provides a Python client library for the Beanstream payment API, supporting credit card transactions, payment profiles, recurring billing, and reporting.

No. The package is dormant (last release 2016-06-23) with no active maintenance. Before installing, verify that Beanstream endpoints remain operational and that this SDK's authentication and API calls are still compatible with current service offerings.

## Install

pip install beanstream
uv add beanstream
poetry add beanstream

## Installing beanstream

Before you install: High install friction due to source distribution format. Package is dormant—last release was 2016-06-23, with no active maintenance signal.

License in practice: Licensed under Apache 2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install beanstream

from beanstream import gateway, billing

beangw = gateway.Beanstream(True, True)
beangw.configure(MERCHANT_ID, PAYMENT_PASSCODE, PROFILES_PASSCODE, RECURRING_PASSCODE, REPORTING_PASSCODE)
card = billing.CreditCard('John Doe', '4030000010001234', '09', '2015', '123')
txn = beangw.purchase(50, card, billing_address)
resp = txn.commit()

Requires valid Beanstream merchant account credentials and active API endpoints to function.

Verify before relying:

- Whether Beanstream API endpoints remain operational and compatible with this SDK's implementation
- Python version compatibility—requires_python is unspecified in the fact sheet
- Current status of Beanstream/Bambora payment processing service and SDK support

## Package facts

- License: Apache2 (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: dormant
- Downloads: 87.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

beanstream payment processing, credit card transaction api, payment gateway python, recurring billing sdk, payment profiles tokenization, beanstream api client, ecommerce payment library, payment-processing, dormant-unmaintained

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