Principios del correo electrónico
PayCal trata el correo electrónico transaccional como parte de la seguridad y continuidad de la cuenta, no como una infraestructura de marketing.
- Las plantillas específicas de flujo se utilizan para las rutas de verificación, recuperación, cambio de cuenta y soporte de contacto.
- La composición del correo electrónico está centralizada para evitar una lógica de mensajes divergente entre los controladores.
- Los errores de entrega devuelven resultados explícitos, por lo que los flujos de llamadas pueden fallar de forma segura e informar a los usuarios con claridad.
Lo que enviamos
| Flujo | Propósito | Familia de plantillas |
|---|---|---|
| Verificación de correo electrónico | Confirmar la propiedad durante los eventos del ciclo de vida de la cuenta | email-verification-* |
| Verificación de correo electrónico de recuperación | Demuestre la propiedad del destino antes de acciones de recuperación sensibles | email-recovery-email-code-* |
| Entrega de clave de recuperación | Proporcionar material de recuperación de cuenta. | email-recovery-key-* |
| Transacción de recuperación de cuenta | Emitir código de verificación de recuperación de cuenta | email-account-recovery-code-* |
| Cambio de correo electrónico (bandeja de entrada antigua/nueva) | Confirmación de bandeja de entrada dual para la mutación del correo electrónico de la cuenta | email-change-code-* and email-change-confirmation-* |
| Contactar con el relé de soporte | Reenviar solicitudes de soporte a la bandeja de entrada de soporte con contenido normalizado | contact-email-* |
Tubería de entrega
PayCal utiliza una pila de correo electrónico de dos capas:
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.
Los enlaces de verificación se localizan en el entorno mediante la resolución del host de solicitudes, de modo que los enlaces permanecen alineados con el contexto de implementación actual.
Soporte de telemetría y auditabilidad del correo electrónico
Los envíos de soporte de contacto incluyen telemetría de mejor esfuerzo para que se pueda monitorear el estado de la entrega sin bloquear los envíos de los usuarios.
- Aggregate counters are recorded under
telemetry:contact:*keys. - JSONL event records are appended to rotated logs via
PayCal\Domain\ContactSupportTelemetry. - La escritura de registros no bloquea para preservar la experiencia de usuario del formulario de soporte si el almacenamiento de telemetría se degrada.
Verificaciones de verificación y confiabilidad
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
Límite del alcance
Esta página documenta el comportamiento transaccional y de soporte del correo electrónico para las operaciones de productos PayCal. No documenta la automatización del marketing porque PayCal no utiliza un embudo de correo electrónico de marketing en este código base.
Última actualización: March 21, 2026.