CloudPayments SDK (Python)

Last updated: February 2026

Warning

This is an unofficial SDK maintained by an independent developer. It is not affiliated with, endorsed by, or supported by CloudPayments.

Description

cloudpayments-sdk is a Python client library for CloudPayments API with:

• synchronous and asynchronous clients
• typed response models (Pydantic v2)
• retry middleware
• webhook signature verification and adapters
• unit and live integration tests

Project Status (2026)

• package quality gates: ruff, mypy, pytest
• local unit tests: stable
• live tests against CloudPayments test environment: stable
• branch model: master

Feature Coverage

• payments
• orders
• subscriptions
• notifications
• claims
• payouts
• webhooks (verify_signature, handle_event, FastAPI/Flask/Django adapters)

Installation

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

Optional webhook dependencies:

uv pip install -e ".[webhooks]"

Quick Start

from cloudpayments_sdk import CloudPayments

with CloudPayments(public_id="pk_...", api_secret="...") as client:
    ok = client.test()
    print(ok)

Live Testing

export CLOUDPAYMENTS_RUN_LIVE=1
export CLOUDPAYMENTS_PUBLIC_ID="pk_..."
export CLOUDPAYMENTS_API_SECRET="..."
export CLOUDPAYMENTS_IP_ADDRESS="$(curl -4 https://api.ipify.org)"

uv run --extra dev pytest -q -m live -s

Dev Quality Checks

uv run --extra dev ruff check cloudpayments_sdk tests examples docs
uv run --extra dev mypy cloudpayments_sdk
uv run --extra dev pytest -q

Build And Publish

uv build
uv run --extra dev python -m twine check dist/*
uv run --extra dev python -m twine upload \
  dist/cloudpayments_sdk-0.1.0-py3-none-any.whl \
  dist/cloudpayments_sdk-0.1.0.tar.gz

Documentation

• main docs: docs/index.md
• API reference: docs/reference.md
• runnable examples: docs/examples.md

Repository

• GitHub: https://github.com/MrConsoleka/cloudpayments_sdk
• default release branch: master

Legal

MIT License, Copyright (c) 2026 Alexeev Roman.