pretix-postfinance 1.0.0

PostFinance Checkout payment plugin for pretix

pretix-postfinance

PostFinance Checkout payment plugin for pretix.

Installation

PyPI

pip install pretix-postfinance

NixOS

For NixOS users, the plugin can be installed using the flake:

{
  inputs.pretix-postfinance.url = "github:sweenu/pretix-postfinance";

  outputs = { self, nixpkgs, pretix-postfinance }: {
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        {
          services.pretix = {
            enable = true;
            plugins = [
              pretix-postfinance.packages.x86_64-linux.default
            ];
          };
        }
      ];
    };
  };
}

Development

Setup with uv

# Create virtual environment
uv venv

# Install with development dependencies
uv pip install -e ".[dev]"

Setup with Nix

# Enter development shell
nix develop

# Or use direnv (if you have a .envrc configured)
direnv allow

Running checks

# Run linting
uv run ruff check .

# Run type checking
uv run mypy pretix_postfinance/

# Run tests with coverage
uv run pytest tests/ --cov=pretix_postfinance --cov-report=term-missing -v

Configuration

Configure the plugin in your pretix settings with:

• Space ID: Your PostFinance Checkout space ID
• User ID: API user ID
• API Secret: API authentication secret
• Environment: production or sandbox

Features

• Payment processing via PostFinance Checkout
• Full and partial refund support
• Webhook handling for payment and refund notifications
• Payment capture support
• Comprehensive error handling and logging
• Admin interface integration

License

GNU Affero General Public License v3.0 (AGPLv3)