gocardless-pro

What it is and what it does

gocardless-pro is a Python client for the GoCardless payment API, which specializes in direct debit processing across SEPA and BACS schemes. It wraps the GoCardless REST API, providing object-oriented access to customers, payments, mandates, billing requests, and related resources. The client automatically adds idempotency keys to resource-creation requests to prevent accidental duplicates if network failures occur.

Beyond basic CRUD operations, the library includes webhook handling with cryptographic signature validation—you can parse incoming webhook notifications, verify they genuinely came from GoCardless, and extract event objects for automatic actions (e.g., suspending a membership when a mandate is cancelled). Rate limit headers are also exposed so you can monitor your quota. The package is actively maintained, supports modern Python versions (3.9–3.12, back-compatible to 3.6), and has only one external dependency (requests).

Use it for:

• Build a subscription billing system that collects recurring payments via direct debit mandates.
• Validate and process webhook events from GoCardless to update local payment records and trigger business logic.
• Create and manage customer bank account details and billing requests through the GoCardless API.
• Fetch payment history and reconcile transactions by querying payments and balances.
• Implement mandate PDF generation in multiple languages for customer sign-off.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the GoCardless API that handles direct debit payments, mandates, billing requests, and webhook processing with built-in idempotency and signature validation.

Yes. The package is actively maintained (released 1 day ago), has low install friction, no known vulnerabilities, and a permissive MIT license. Install it if you need to integrate GoCardless direct debit payments into a Python application. The single dependency (requests) and broad Python version support make it straightforward to adopt.

Install

gocardless-pro on PyPI

pip install gocardless-pro

uv add gocardless-pro

poetry add gocardless-pro

Installing gocardless-pro

Before you install

Low install friction with a single dependency (requests). Active maintenance with a release just 1 day ago and commits through 2026-08-13. Tested against Python 3.9, 3.10, 3.11, and 3.12, with support back to Python 3.6.

License in practice

MIT license is permissive, allowing commercial and private use with minimal restrictions—suitable for most projects.

Quickstart

pip install gocardless_pro

import gocardless_pro
import os

token = os.environ['ACCESS_TOKEN']
client = gocardless_pro.Client(access_token=token, environment='live')
customer = client.customers.create(params={'email': 'jane@example.com'})
payment = client.payments.get("PA123")

Requires a GoCardless account and valid ACCESS_TOKEN environment variable to authenticate with the API.

Verify before relying

• Whether rate limiting is enforced by the API and how the client handles backoff or retry logic.
• Support for async/await patterns or if the client is synchronous-only.

Package facts

Evidence: gocardless_pro-3.6.3-py3-none-any.whl

Keywords: gocardless, directdebit, payments, sepa, bacs

Tags

More WWW/HTTP packages