Initial commit

site/directmail/providers/postcard/click2mail.py

@@ -0,0 +1,23 @@
+"""Click2Mail postcard adapter (low-volume pay-per-piece option)."""
+
+from dataclasses import dataclass
+
+from django.conf import settings
+
+from directmail.providers.postcard import PostcardResult
+
+
+@dataclass
+class Click2MailProvider:
+    name: str = "click2mail"
+
+    def send_postcard(self, message) -> PostcardResult:
+        if not settings.CLICK2MAIL_API_KEY:
+            raise RuntimeError("CLICK2MAIL_API_KEY is not configured")
+        # Placeholder: wire full Click2Mail job API when account credentials are ready.
+        raise NotImplementedError(
+            "Click2Mail adapter stub — configure account then implement job submit"
+        )
+
+    def get_status(self, provider_id: str) -> str:
+        return "unknown"