feat: python example

Author: matoous

.github/workflows/python.yaml

@@ -0,0 +1,34 @@
+name: Python CI
+
+on:
+  push:
+    branches: [main]
+    paths: [backend/python/**, .github/workflows/python.yaml]
+  pull_request:
+    branches: [main]
+    paths: [backend/python/**, .github/workflows/python.yaml]
+
+jobs:
+  backend-python:
+    name: Backend Python
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend/python
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7.1.6
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Install Ruff
+        run: uv pip install ruff
+
+      - name: Lint
+        run: uv run ruff check app.py
+
+      - name: Type check
+        run: uv run python -m compileall app.py

backend/python/.env.example

@@ -0,0 +1,3 @@
+SUMUP_API_KEY=
+SUMUP_MERCHANT_CODE=
+PORT=3003

backend/python/.gitignore

@@ -0,0 +1 @@
+.venv/

backend/python/README.md

@@ -0,0 +1,38 @@
+# Python example
+
+## Setup
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+```sh
+export SUMUP_API_KEY="your_api_key"
+export SUMUP_MERCHANT_CODE="your_merchant_code"
+```
+
+## Run
+
+```sh
+python app.py
+```
+
+## Test
+
+```sh
+curl -X POST http://localhost:8080/readers \
+  -H "Content-Type: application/json" \
+  -d '{"pairing_code":"12345678","name":"Front Desk"}'
+```
+
+```sh
+curl http://localhost:8080/readers
+```
+
+```sh
+curl -X POST http://localhost:8080/readers/READER_ID/checkout \
+  -H "Content-Type: application/json" \
+  -d '{"amount": 10.0}'
+```

backend/python/app.py

@@ -0,0 +1,94 @@
+import os
+
+from flask import Flask, jsonify, request
+from sumup import Sumup
+from sumup.readers import CreateReaderBody, CreateReaderCheckoutBody, CreateReaderCheckoutBodyTotalAmount
+
+api_key = os.environ.get("SUMUP_API_KEY")
+merchant_code = os.environ.get("SUMUP_MERCHANT_CODE")
+
+if not api_key:
+    raise SystemExit("Missing SUMUP_API_KEY env var.")
+
+if not merchant_code:
+    raise SystemExit("Missing SUMUP_MERCHANT_CODE env var.")
+
+client = Sumup(api_key=api_key)
+
+app = Flask(__name__)
+
+
+def parse_amount(value):
+    try:
+        amount = float(value)
+    except (TypeError, ValueError):
+        return None
+
+    if amount <= 0:
+        return None
+
+    return CreateReaderCheckoutBodyTotalAmount(currency="EUR", minor_unit=2, value=round(amount * 100))
+
+
+@app.post("/readers")
+def create_reader():
+    data = request.get_json(silent=True) or {}
+    pairing_code = str(data.get("pairing_code", "")).strip()
+    name = str(data.get("name", "")).strip()
+
+    if not pairing_code or not name:
+        return jsonify({"error": "pairing_code and name are required"}), 400
+
+    reader = client.readers.create(
+        merchant_code,
+        body=CreateReaderBody(pairing_code=pairing_code, name=name),
+    )
+
+    if hasattr(reader, "model_dump"):
+        payload = reader.model_dump()
+    else:
+        payload = reader.dict()
+
+    return jsonify(payload), 201
+
+
+@app.get("/readers")
+def list_readers():
+    readers = client.readers.list(merchant_code)
+
+    if hasattr(readers, "model_dump"):
+        payload = readers.model_dump()
+    else:
+        payload = readers.dict()
+
+    return jsonify(payload)
+
+
+@app.post("/readers/<reader_id>/checkout")
+def create_reader_checkout(reader_id):
+    data = request.get_json(silent=True) or {}
+    total_amount = parse_amount(data.get("amount"))
+
+    if not total_amount:
+        return jsonify({"error": "amount must be a positive number"}), 400
+
+    checkout = client.readers.create_checkout(
+        merchant_code,
+        reader_id,
+        body=CreateReaderCheckoutBody(
+            total_amount=total_amount,
+            description="Card reader checkout",
+        ),
+    )
+
+    if hasattr(checkout, "model_dump"):
+        payload = checkout.model_dump()
+    else:
+        payload = checkout.dict()
+
+    return jsonify(payload), 201
+
+
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", "8080"))
+    app.run(host="0.0.0.0", port=port)

backend/python/pyproject.toml

@@ -0,0 +1,11 @@
+[project]
+name = "sumup-examples-python"
+version = "0.1.0"
+description = "SumUp Python example"
+requires-python = ">=3.10"
+dependencies = [
+  "flask",
+  "sumup",
+]
+
+[tool.uv]