A client library for the GoCardless Pro API. It simplifies integration with the GoCardless platform, handling API requests, authentication, and error handling. As of version 3.3.0, it is actively maintained with regular updates, supporting Python 3.9, 3.10, 3.11, and 3.12.
pip install gocardless-proVerified import paths — ran on the pinned version, not inferred.
Initializes the GoCardless Pro client using an access token and environment, then demonstrates creating a customer and listing existing payments. Remember to set `GOCARDLESS_ACCESS_TOKEN` and `GOCARDLESS_ENVIRONMENT` (e.g., 'sandbox' or 'live') in your environment variables.
Consult the official GoCardless API reference for the `create_with_actions` endpoint and update your implementation to match the new request body and response structure.
Ensure that your Billing Request creation logic includes `constraints` with a `max_amount_per_payment` field when initiating PayTo `mandate_request`s.
Remove any calls or references to the negative balance limit creation API. Functionality related to managing negative balances should be handled through other GoCardless mechanisms.
Always use `gocardless-pro` for new integrations. If you see documentation referring to `gocardless.Client` or `gocardless.set_details()`, you are likely looking at legacy API documentation.
Review the API documentation for the specific endpoint you are calling and ensure all required parameters are present and correctly formatted. Check for typos in field names or data types.
Verify that your `GOCARDLESS_ACCESS_TOKEN` environment variable or client initialization directly uses a valid, active access token for the correct environment (sandbox/live). Generate a new token if necessary from your GoCardless dashboard.
Check your network connectivity. If the issue persists, review any firewall rules or proxy settings that might be blocking outbound connections to `https://api.gocardless.com` or `https://api-sandbox.gocardless.com`. Implement robust retry logic with exponential backoff in your application.
This often indicates a transient issue outside of your direct control. Retry the request after a short delay. If it persists, check the GoCardless status page for API outages or contact GoCardless support with the `request_id` if available.
No dependency data recorded yet.