{"id":23054,"library":"chargehound","title":"Chargehound Python Bindings","description":"Chargehound Python bindings for automated chargeback management. Current version 2.5.0. Release cadence is irregular; updates are driven by API changes.","status":"active","version":"2.5.0","language":"python","source_language":"en","source_url":"https://github.com/chargehound/chargehound-python","tags":["chargebacks","payments","stripe","api"],"install":[{"cmd":"pip install chargehound","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"The library does not expose a top-level module; you must import the Chargehound class.","wrong":"import chargehound","symbol":"Chargehound","correct":"from chargehound import Chargehound"},{"note":"Dispute is a resource; direct import from chargehound package fails.","wrong":"from chargehound import Dispute","symbol":"Dispute","correct":"from chargehound.resources import Dispute"}],"quickstart":{"code":"from chargehound import Chargehound\n\nclient = Chargehound(api_key=os.environ.get('CHARGEHOUND_API_KEY', ''))\ntry:\n    disputes = client.disputes.list()\n    print(disputes)\nexcept Exception as e:\n    print(f'Error: {e}')","lang":"python","description":"Initialize client with API key and list disputes."},"warnings":[{"fix":"Use keyword arguments: Chargehound(api_key='sk_...') instead of Chargehound('sk_...').","message":"Version 2.0.0 dropped support for Python 2 and changed the client initialization from positional arguments to keyword-only.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Remove `verify_ssl` from client initialization.","message":"The `verify_ssl` parameter is deprecated and will be removed in a future release.","severity":"deprecated","affected_versions":">=2.3.0"},{"fix":"Always pass api_key as keyword argument: Chargehound(api_key='...').","message":"API key must be set via kwarg or environment variable; using `api_key` positional argument will raise TypeError.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use keyword argument: Chargehound(api_key='sk_live_...')","cause":"Incorrectly omitting api_key or using positional argument in older code.","error":"TypeError: __init__() missing 1 required positional argument: 'api_key'"},{"fix":"Use 'from chargehound import Chargehound'","cause":"Importing top-level module instead of specific class.","error":"AttributeError: module 'chargehound' has no attribute 'Chargehound'"},{"fix":"Verify CHARGEHOUND_API_KEY environment variable or the key passed to Chargehound.","cause":"API key is missing, incorrect, or malformed.","error":"chargehound.error.AuthenticationError: Invalid API Key provided"},{"fix":"Upgrade chargehound: pip install --upgrade chargehound","cause":"Attempting to import resources directly without proper installation or outdated version.","error":"ModuleNotFoundError: No module named 'chargehound.resources'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}