Skip to main content

Email & SMS Notifications

Notification Architecture​

Email Templates​

Registration Templates​

registration:
  welcome:
    subject: Welcome to Oan Finance
    template: TIMALREGST
    variants:
      - ar: TIMALREGST_AR
    triggers:
      - successful_registration
      - account_activation

  verification:
    subject: Verify Your Account
    template: TIMALUNVER
    variants:
      - ar: TIMALUNVER_AR
    triggers:
      - pending_verification
      - verification_reminder

Loan Application Templates​

loan_application:
  offer:
    subject: Your Loan Offer
    template: TIMALOFFER
    variants:
      - ar: TIMALOFFER_AR
    triggers:
      - loan_approved
      - offer_generated

  contract:
    subject: Loan Contract for Signature
    template: TIMALCONSI
    variants:
      - ar: TIMALCONSI_AR
    triggers:
      - contract_ready
      - signature_reminder

  disbursement:
    subject: Loan Disbursement Confirmation
    template: TIMALONOBD
    variants:
      - ar: TIMALONOBD_AR
    triggers:
      - funds_disbursed
      - payment_confirmation

Template Structure​

HTML Template Example​

<!DOCTYPE html>
<html dir="{{direction}}">
<head>
    <meta charset="UTF-8">
    <style>
        body {
            font-family: 'Arial', sans-serif;
            line-height: 1.6;
            color: #333;
        }
        .header {
            background: #f8f9fa;
            padding: 20px;
            text-align: center;
        }
        .content {
            padding: 20px;
        }
        .footer {
            background: #f8f9fa;
            padding: 20px;
            text-align: center;
        }
    </style>
</head>
<body>
    <div class="header">
        <img src="{{logo_url}}" alt="Oan Finance Logo">
    </div>
    <div class="content">
        <h2>{{greeting}}</h2>
        <p>{{main_content}}</p>
        <div class="cta">
            {{call_to_action}}
        </div>
    </div>
    <div class="footer">
        {{footer_content}}
    </div>
</body>
</html>

SMS Templates​

Notification Types​

sms_templates:
  authentication:
    otp:
      template: "Your Oan Finance verification code is: {{code}}"
      expiry: 5m
      
    login:
      template: "New login detected from {{location}}. If this wasn't you, contact us immediately."
      
  loan_updates:
    approval:
      template: "Your loan application has been approved. Check your email for details."
      
    disbursement:
      template: "Your loan of {{amount}} SAR has been disbursed to your account."
      
    payment_due:
      template: "Payment reminder: {{amount}} SAR due on {{date}}."

Notification Settings​

Email Configuration​

email_settings:
  sender:
    name: Oan Finance
    email: notifications@oanfinance.com
    
  delivery:
    provider: OCI Email Delivery
    retry_attempts: 3
    retry_delay: 5m
    
  tracking:
    open_tracking: true
    click_tracking: true
    bounce_tracking: true

SMS Configuration​

sms_settings:
  provider: Unifonic
  sender_id: OanFinance
  
  delivery:
    retry_attempts: 2
    retry_delay: 1m
    
  restrictions:
    daily_limit: 5
    throttle_rate: 1/minute

Notification Flow​

Template Management​

Version Control​

version_control:
  template_versioning: true
  change_tracking: true
  approval_required: true
  
  archival:
    archive_old_versions: true
    retention_period: 1y

Testing Process​

testing_process:
  stages:
    - content_review
    - format_validation
    - rendering_test
    - delivery_test
    
  environments:
    - development
    - staging
    - production

Best Practices​

Content Guidelines​

  1. Clear subject lines
  2. Consistent branding
  3. Mobile-friendly design
  4. Multi-language support

Technical Guidelines​

  1. HTML/CSS compatibility
  2. Template variables
  3. Error handling
  4. Performance optimization

Compliance​

  1. SAMA guidelines
  2. Privacy regulations
  3. Opt-out management
  4. Record keeping

Monitoring​

  1. Delivery rates
  2. Open rates
  3. Click rates
  4. Bounce rates