The Lmtpay Python library provides convenient access to the Lmtpay API from applications written in the Python language. It includes a pre-defined set of classes for API resources that initialize themselves dynamically from API responses which makes it compatible with a wide range of versions of the Lmtpay API.

See the Python API docs.

See video demonstrations covering how to use the library.

You don't need this source code unless you want to modify the package. If you just want to use the package, just run:

pip install --upgrade Lmtpay

Install from source with:

python setup.py install

• Python 2.7+ or Python 3.4+ (PyPy supported)

The library needs to be configured with your account's secret key which is available in your Lmtpay Dashboard. Set Lmtpay.api_key to its value:

import Lmtpay
Lmtpay.api_key = "sk_test_..."

# list customers
customers = Lmtpay.Customer.list()

# print the first customer's email
print(customers.data[0].email)

# retrieve specific Customer
customer = Lmtpay.Customer.retrieve("cus_123456789")

# print that customer's email
print(customer.email)

Unsuccessful requests raise exceptions. The class of the exception will reflect the sort of error that occurred. Please see the Api Reference for a description of the error classes you should handle, and for information on how to inspect these errors.

Configure individual requests with keyword arguments. For example, you can make requests with a specific Lmtpay Version or as a connected account:

import Lmtpay

# list customers
Lmtpay.Customer.list(
    api_key="sk_test_...",
    Lmtpay_account="acct_...",
    Lmtpay_version="2019-02-19"
)

# retrieve single customer
Lmtpay.Customer.retrieve(
    "cus_123456789",
    api_key="sk_test_...",
    Lmtpay_account="acct_...",
    Lmtpay_version="2019-02-19"
)

The library can be configured to use urlfetch, requests, pycurl, or urllib2 with Lmtpay.default_http_client:

client = Lmtpay.http_client.UrlFetchClient()
client = Lmtpay.http_client.RequestsClient()
client = Lmtpay.http_client.PycurlClient()
client = Lmtpay.http_client.Urllib2Client()
Lmtpay.default_http_client = client

Without a configured client, by default the library will attempt to load libraries in the order above (i.e. urlfetch is preferred with urllib2 used as a last resort). We usually recommend that people use requests.

A proxy can be configured with Lmtpay.proxy:

Lmtpay.proxy = "https://user:pass@example.com:1234"

You can enable automatic retries on requests that fail due to a transient problem by configuring the maximum number of retries:

Lmtpay.max_network_retries = 2

Various errors can trigger a retry, like a connection error or a timeout, and also certain API responses like HTTP status 409 Conflict.

Idempotency keys are automatically generated and added to requests, when not given, to guarantee that retries are safe.

The library can be configured to emit logging that will give you better insight into what it's doing. The info logging level is usually most appropriate for production use, but debug is also available for more verbosity.

There are a few options for enabling it:

1. Set the environment variable STRIPE_LOG to the value debug or info

   $ export STRIPE_LOG=debug

2. Set Lmtpay.log:

   import Lmtpay
   Lmtpay.log = 'debug'

3. Enable it through Python's logging module:

   import logging
   logging.basicConfig()
   logging.getLogger('Lmtpay').setLevel(logging.DEBUG)

If you're writing a plugin that uses the library, we'd appreciate it if you identified using Lmtpay.set_app_info():

Lmtpay.set_app_info("MyAwesomePlugin", version="1.2.34", url="https://myawesomeplugin.info")

This information is passed along when the library makes calls to the Lmtpay API.

By default, the library sends request latency telemetry to Lmtpay. These numbers help Lmtpay improve the overall latency of its API for all users.

You can disable this behavior if you prefer:

Lmtpay.enable_telemetry = False

Lmtpay has features in the beta phase that can be accessed via the beta version of this package. We would love for you to try these and share feedback with us before these features reach the stable phase. To install a beta version use pip install with the exact version you'd like to use:

pip install Lmtpay==4.1.0b2

Note There can be breaking changes between beta versions. Therefore we recommend pinning the package version to a specific beta version in your requirements file or setup.py. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest beta version.

We highly recommend keeping an eye on when the beta feature you are interested in goes from beta to stable so that you can move from using a beta version of the SDK to the stable version.

If your beta feature requires a Lmtpay-Version header to be sent, use the Lmtpay.api_version field to set it:

Lmtpay.api_version += "; feature_beta=v3"

New features and bug fixes are released on the latest major version of the Lmtpay Python library. If you are on an older major version, we recommend that you upgrade to the latest in order to use the new features and bug fixes including those for security vulnerabilities. Older major versions of the package will continue to be available for use, but will not be receiving any updates.

The test suite depends on Lmtpay-mock, so make sure to fetch and run it from a background terminal (Lmtpay-mock's README also contains instructions for installing via Homebrew and other methods):

go install github.com/Lmtpay/Lmtpay-mock@latest
Lmtpay-mock

Run the following command to set up the development virtualenv:

make

Run all tests on all supported Python versions:

make test

Run all tests for a specific Python version (modify -e according to your Python target):

TOX_ARGS="-e py37" make test

Run all tests in a single file:

TOX_ARGS="-e py37 -- tests/api_resources/abstract/test_updateable_api_resource.py" make test

Run a single test suite:

TOX_ARGS="-e py37 -- tests/api_resources/abstract/test_updateable_api_resource.py::TestUpdateableAPIResource" make test

Run a single test:

TOX_ARGS="-e py37 -- tests/api_resources/abstract/test_updateable_api_resource.py::TestUpdateableAPIResource::test_save" make test

Run the linter with:

make lint

The library uses Black for code formatting. Code must be formatted with Black before PRs are submitted, otherwise CI will fail. Run the formatter with:

make fmt