Trasparenza della posta elettronica

Questa pagina spiega quali e-mail invia PayCal, come ogni messaggio viene assemblato e consegnato e come ne verifichiamo l'affidabilità.

Principi di posta elettronica

PayCal tratta la posta elettronica transazionale come parte della sicurezza e della continuità dell'account, non come un'infrastruttura di marketing.

  • I modelli specifici del flusso vengono utilizzati per i percorsi di verifica, ripristino, modifica dell'account e contatto con l'assistenza.
  • La composizione dell'e-mail è centralizzata per evitare logiche di messaggio divergenti tra i controller.
  • Gli errori di recapito restituiscono risultati espliciti in modo che i flussi di chiamata possano fallire in modo sicuro e informare chiaramente gli utenti.

Cosa inviamo

Flusso Scopo Famiglia di modelli
Verifica e-mail Conferma la proprietà durante gli eventi del ciclo di vita dell'account email-verification-*
Verifica dell'e-mail di recupero Dimostrare la proprietà della destinazione prima di azioni di recupero sensibili email-recovery-email-code-*
Consegna della chiave di ripristino Fornire materiale per il recupero dell'account email-recovery-key-*
Operazione di recupero del conto Emetti il codice di verifica per il recupero dell'account email-account-recovery-code-*
Modifica email (vecchia/nuova casella di posta) Conferma della doppia casella di posta per la mutazione dell'e-mail dell'account email-change-code-* and email-change-confirmation-*
Contattare il relè di supporto Inoltra le richieste di supporto alla casella di posta con contenuto normalizzato contact-email-*

Conduttura di consegna

PayCal utilizza uno stack di posta elettronica a due livelli:

  • 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.

I collegamenti di verifica sono localizzati nell'ambiente utilizzando la risoluzione dell'host della richiesta in modo che i collegamenti rimangano allineati al contesto di distribuzione corrente.

Supporta la telemetria e la verificabilità della posta elettronica

Gli invii al supporto dei contatti includono la telemetria best-effort in modo che lo stato della consegna possa essere monitorato senza bloccare gli invii degli utenti.

  • Aggregate counters are recorded under telemetry:contact:* keys.
  • JSONL event records are appended to rotated logs via PayCal\Domain\ContactSupportTelemetry.
  • La scrittura del log non è bloccante per preservare l'esperienza utente del modulo di supporto se l'archiviazione della telemetria è ridotta.

Verifica e controlli di affidabilità

  • html/tests/Unit/EmailTemplateRenderTest.php verifies all supported templates render with expected placeholder substitution.
  • html/tests/Integration/LiveEmailTemplateSweepTest.php provides opt-in live SMTP end-to-end template coverage.
  • html/tests/Integration/EmailSendTest.php provides 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

Confine dell'ambito

Questa pagina documenta il comportamento delle e-mail transazionali e di supporto per le operazioni del prodotto PayCal. Non documenta l'automazione del marketing perché PayCal non utilizza una canalizzazione di posta elettronica di marketing in questa codebase.

Ultimo aggiornamento: March 21, 2026.