Customers

Transactional emails for customers events

Transactional emails for customers events.

The transactional emails functionality in Geins handles automated customer notifications triggered by customer-related events. These emails are typically sent automatically by the system when specific customer actions occur, ensuring that users receive relevant updates such as registration confirmations or password resets.

Transactional emails are managed through backend event flows and can be customized or disabled through system settings.

Mail types

Mail event	Description
CustomerRegistered	Sent when a customer is created automatically during the first purchase. Can be disabled by adding a setting with the name DisableMailOnUserCreate, family Site, value true. Flow: merchant-api → mgmt-api → mail-service.
CustomerUnregistered	Not implemented yet.
CustomerPasswordReset	Sent when a customer requests a new password. Flow: merchant-api → mail-service or merchant-center → mail-service. Can be replaced by subscribing to the event passwordReset.

Typical use cases

Transactional emails support automated, event-based communication with customers and ensure smooth post-interaction notifications across key account events.

1. Sending welcome emails on first purchase

The system automatically sends a registration email when a customer account is created during their first order. Examples include:

Sending a welcome email confirming account creation.
Informing the customer about account login details after checkout.

2. Handling password resets

Customers can request a password reset to regain access to their account. Examples include:

Automatically sending a reset link when a user clicks “Forgot password.”
Using the passwordReset event for a custom password recovery workflow.

3. Managing optional or disabled transactional emails

Merchants can disable specific transactional emails if they prefer to handle notifications externally. Examples include:

Turning off automatic registration emails
Replacing built-in emails with custom workflows through subscribed events.

All transactional emails in Geins use a standard email template. This template includes basic styling, structure, and content text that ensures consistent formatting across all customer-facing notifications.

Related feature	Description
Customer account	Transactional emails are tied to customer creation and account management.
Events	System events trigger the sending of transactional emails.
Mail service	Handles message delivery and formatting for all transactional emails.
Merchant API	Initiates and forwards customer-related events that generate transactional emails.
Management API	Processes email delivery configurations and routing to the mail service.

Groups

Customer groups for your sales channels or applications.

Authentication

Secure authentication system for customer management in your sales channels and applications.