​
Overview

Mercur uses a notification system that supports multiple channels including email and in-app feeds. The system is built using the Resend service for email notifications and a local notification provider for in-app feeds.

​
Notification Channels

  • Email: Used for transactional emails and important updates
  • Feed: Used for in-app notifications in the admin panel
  • Seller Feed: Used for in-app notifications in the seller dashboard

​
Email Notifications

​
Buyer Notifications

  1. Account Created

    • Template: buyerAccountCreatedEmailTemplate
    • Trigger: When a new buyer account is created
    • Content: Welcome message with buyer’s name

  2. New Order

    • Template: buyerNewOrderEmailTemplate
    • Trigger: When an order is placed
    • Content: Order confirmation with order details and items

  3. Order Canceled

    • Template: buyerCancelOrderEmailTemplate
    • Trigger: When an order is canceled
    • Content: Order cancellation confirmation with order details

  4. Order Shipped

    • Template: buyerOrderShippedEmailTemplate
    • Trigger: When an order is shipped
    • Content: Shipping confirmation with tracking details

​
Seller Notifications

  1. Account Submission

    • Template: sellerAccountSubmissionEmailTemplate
    • Trigger: When a seller submits their account for review
    • Content: Confirmation of submission receipt with seller’s name

  2. Account Approval

    • Template: sellerAccountApprovedEmailTemplate
    • Trigger: When admin approves a seller’s account
    • Content: Approval confirmation with seller’s name

  3. Account Rejection

    • Template: sellerAccountRejectedEmailTemplate
    • Trigger: When admin rejects a seller’s account
    • Content: Rejection notification

  4. Product Approval

    • Template: sellerProductApprovedEmailTemplate
    • Trigger: When admin accepts a seller’s product listing
    • Content: Approval notification

  5. Product Rejection

    • Template: sellerProductRejectedEmailTemplate
    • Trigger: When admin rejects a seller’s product listing
    • Content: Rejection notification

  6. Team Invitation

    • Template: sellerTeamInviteEmailTemplate
    • Trigger: When a seller is invited to join a team
    • Content:
      • Invitation details
      • Store name
      • Team member name
      • Registration link

  7. New Order

    • Template: sellerNewOrderEmailTemplate
    • Trigger: When a new order is placed
    • Content:
      • Order ID
      • Customer name
      • Order details
      • Seller name

  8. New Seller Invitation

    • Template: newSellerInvitation
    • Trigger: When marketplace administrator invites seller to join the platform
    • Content: Registration link and platform information

​
Admin Notifications

  1. Request Management
    • New Seller Request: adminSellerRequestCreatedEmailTemplate

​
In-App Notifications

​
Admin Feed

  • New request notifications
  • Other system notifications (Medusa defaults)

​
Seller Feed

  • Product Requests - approved/rejected
  • Product Category Requests - approved/rejected
  • Product Collection Requests - approved/rejected
  • Product Type Requests - approved/rejected
  • Product Tag Requests - approved/rejected
  • Order Notifications - new order created

​
System Notifications

  1. Password Reset

    • Template: forgotPasswordEmailTemplate
    • Trigger: When a user requests a password reset
    • Content: Password reset link and instructions