E-Mail-Grundsätze
PayCal behandelt Transaktions-E-Mails als Teil der Kontosicherheit und Kontokontinuität, nicht als Marketinginfrastruktur.
- Flow-spezifische Vorlagen werden für die Verifizierung, Wiederherstellung, Kontoänderung und Kontaktsupportpfade verwendet.
- Die E-Mail-Erstellung wird zentralisiert, um unterschiedliche Nachrichtenlogiken zwischen den Controllern zu vermeiden.
- Zustellungsfehler geben explizite Ergebnisse zurück, sodass Aufrufflüsse sicher fehlschlagen und Benutzer klar informiert werden können.
Was wir senden
| Fließen | Zweck | Vorlagenfamilie |
|---|---|---|
| E-Mail-Bestätigung | Bestätigen Sie den Besitz während Kontolebenszyklusereignissen | email-verification-* |
| Bestätigung der Wiederherstellungs-E-Mail | Beweisen Sie den Besitz des Ziels vor sensiblen Wiederherstellungsmaßnahmen | email-recovery-email-code-* |
| Lieferung des Wiederherstellungsschlüssels | Stellen Sie Material zur Kontowiederherstellung bereit | email-recovery-key-* |
| Kontowiederherstellungstransaktion | Geben Sie den Bestätigungscode für die Kontowiederherstellung aus | email-account-recovery-code-* |
| E-Mail-Änderung (alter/neuer Posteingang) | Doppelte Posteingangsbestätigung für die E-Mail-Mutation des Kontos | email-change-code-* and email-change-confirmation-* |
| Kontaktieren Sie das Support-Relay | Leiten Sie Supportanfragen mit normalisiertem Inhalt an den Support-Posteingang weiter | contact-email-* |
Lieferpipeline
PayCal verwendet einen zweischichtigen E-Mail-Stack:
PayCal\Domain\EmailGarum: workflow-level orchestration and template selection.PayCal\Domain\EmailTransport: SMTP protocol transport (connect, STARTTLS, AUTH, send, close).
Template rendering is performed via PayCal\Domain\Render::template(), with both HTML and text bodies built for each flow.
Verifizierungslinks werden mithilfe der Anforderungshostauflösung umgebungslokalisiert, sodass Links am aktuellen Bereitstellungskontext ausgerichtet bleiben.
Unterstützen Sie E-Mail-Telemetrie und Überprüfbarkeit
Kontakt-Support-Übermittlungen umfassen Best-Effort-Telemetrie, sodass der Lieferzustand überwacht werden kann, ohne dass Benutzerübermittlungen blockiert werden.
- Aggregate counters are recorded under
telemetry:contact:*keys. - JSONL event records are appended to rotated logs via
PayCal\Domain\ContactSupportTelemetry. - Das Schreiben von Protokollen ist nicht blockierend, um die Support-Formular-UX bei einer Beeinträchtigung des Telemetriespeichers aufrechtzuerhalten.
Verifizierungs- und Zuverlässigkeitsprüfungen
html/tests/Unit/EmailTemplateRenderTest.phpverifies all supported templates render with expected placeholder substitution.html/tests/Integration/LiveEmailTemplateSweepTest.phpprovides opt-in live SMTP end-to-end template coverage.html/tests/Integration/EmailSendTest.phpprovides opt-in single-message verification for SMTP, DKIM, DMARC, and Message-ID health.
# Opt-in live template sweep cd html PAYCAL_RUN_LIVE_EMAIL_SWEEP=1 PAYCAL_LIVE_EMAIL_RECIPIENT=you@example.com \ ./vendor/bin/phpunit --configuration phpunit.xml tests/Integration/LiveEmailTemplateSweepTest.php # Opt-in single email stack verification cd html PAYCAL_RUN_LIVE_EMAIL=1 PAYCAL_LIVE_EMAIL_RECIPIENT=you@example.com \ ./vendor/bin/phpunit --configuration phpunit.xml tests/Integration/EmailSendTest.php
Bereichsgrenze
Auf dieser Seite wird das Transaktions- und Support-E-Mail-Verhalten für den PayCal-Produktbetrieb dokumentiert. Es dokumentiert keine Marketingautomatisierung, da PayCal in dieser Codebasis keinen Marketing-E-Mail-Trichter verwendet.
Letzte Aktualisierung: March 21, 2026.