skip to navigation
skip to content

recurly 2.4.2

The official Recurly API client

Recurly’s Python client library is an interface to its REST API.

Python Versions

The minimum supported requirements for this library are:

  • Python >= 2.7.9
  • OpenSSL >= 1.0.1


Recurly is packaged as a Python package. We recommend you install it with PyPI by adding it to your requirements.txt:

pip install recurly


Set your API key and optionally set a certificate authority certificate file and default currency:

import recurly

recurly.SUBDOMAIN = 'your-subdomain'
recurly.API_KEY = '012345678901234567890123456789ab'

# Set a certificate authority certs file to validate Recurly's certificate
recurly.CA_CERTS_FILE = '/etc/pki/tls/certs/ca-bundle.crt'

# Set a default currency for your API requests

Recurly Python Client Tests

To run these tests, use the unittest test runner:

$ python -m unittest discover -s tests

The resource tests in will run using the HTTP fixtures in tests/fixtures. To run the tests against a live Recurly API endpoint, configure your Recurly test account and use its API key in the RECURLY_API_KEY environment variable:

$ RECURLY_API_KEY=1274…54e3 python -m unittest tests.test_resources

The live Recurly API endpoint can also be tested while validating the server certificate with the RECURLY_CA_CERTS_FILE environment variable, which should be a filename of concatenated certificate authority X.509 certificates:

$ RECURLY_API_KEY=1274…54e3 RECURLY_CA_CERTS_FILE=/etc/pki/tls/certs/ca-bundle.crt -m unittest tests.test_resources


Please see the Recurly API for more information.


If you have general questions about the library or integration, you may find some of us in the #recurly irc channel on the Freenode network.

File Type Py Version Uploaded on Size
recurly-2.4.2.tar.gz (md5) Source 2016-09-12 52KB