---
id: gocardless-pro
version: "3.6.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# gocardless-pro — A client library for the GoCardless API.

License: permissive · Maintenance: active · Downloads: 249.2K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 249.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gocardless api client, direct debit payments python, sepa bacs payment processing, webhook signature validation, mandate management api, payment-processing, direct-debit, webhook-handling

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