Notifications & Emails Overview

Play Money sends automated email notifications to investors and the operations team at key moments throughout the investment lifecycle. These emails are triggered by domain events -- when something significant happens in the system (a payment completes, a verification fails, a funding close settles), the appropriate email is sent automatically.

Two Categories of Emails

Investor-Facing Emails

Emails sent directly to investors to keep them informed about their investments. These include confirmation emails, wire instructions, payment status updates, and settlement notifications.

See Investor Emails for the complete list.

Operations Alerts

Emails sent to the ops team when something requires attention or when significant events occur. These include payment failure escalations, verification issues, and settlement summaries.

See Operations Alerts for the complete list.

Event-Driven Architecture

Emails are not sent by clicking a button -- they're triggered automatically by domain events:

For example, when a payment completes:

1. The payment provider sends a webhook
2. The system processes the webhook and updates the payment order status
3. A payments.order_completed event is published
4. The orchestration handler evaluates the investment and marks it as funded
5. The settlement process (when triggered) sends the investor a confirmation email

Key Security Principle

Sensitive financial information is never included in emails. This is a critical security measure to prevent wire fraud via business email compromise (BEC).

Specifically:

• No banking details -- routing numbers, account numbers, and bank names are never in email bodies
• No SSN or tax IDs -- personal identification numbers are never emailed
• Links instead of details -- emails contain links to the authenticated investor portal where sensitive information is displayed behind login

For example, when an investor needs wire instructions, they receive an email with a link to the portal -- not the actual routing and account numbers.

Transactional vs. Preference-Based

• Transactional emails (marked as "essential"): Always delivered regardless of email preferences. These include wire instructions, payment failures, and settlement confirmations. The investor cannot unsubscribe from these.
• Preference-based emails: Can be managed through email preferences. These include deal announcements, achievement notifications, and referral prompts.

What Admins Should Know

• Emails are automatic -- you don't need to manually send any of the emails described in this section. They fire based on system events.
• Check the audit trail if an email should have sent -- if an investor says they didn't receive an email, check the audit trail to verify the triggering event occurred.
• Ops emails go to the SPV ops address -- all operations alerts are sent to the configured ops email address, not to individual admins.
• No banking details in email -- if an investor asks for wire details via email, direct them to their investor portal instead.