TOTP Authentication

Add enterprise-grade Time-based One-Time Password (TOTP) authentication to your application with Akedly. Support for Google Authenticator, Microsoft Authenticator, and other standard TOTP apps with seamless integration and pay-per-success billing.

Overview

TOTP (Time-based One-Time Password) authentication provides a powerful second factor of authentication that significantly enhances security for your users. Unlike SMS-based OTP that can be intercepted, TOTP generates codes locally on users' devices, making it virtually impossible to compromise.

Key Features:

• Universal Compatibility: Works with Google Authenticator, Microsoft Authenticator, Authy, and any RFC 6238 compliant app
• Offline Generation: Codes generated locally on user devices - no network dependency
• Cost Effective: Pay only for successful authentications (starting at 0.25 EGP per success)
• 5-Minute Expiration: Authentication requests expire automatically for security
• Multi-Platform: Native mobile apps, web applications, and desktop support
• White-Label: Hosted setup and authentication pages with your branding

Why TOTP Authentication?

📱 Google Authenticator
   • Most popular TOTP app globally
   • Available on iOS and Android
   • Simple setup with QR codes
   • Backup and sync capabilities

📱 Microsoft Authenticator
   • Enterprise-focused features
   • Cloud backup and recovery
   • Push notifications support
   • Business account integration

📱 Authy
   • Multi-device synchronization
   • Desktop app available
   • Encrypted cloud backups
   • Teams and business features

Cost Comparison

Traditional 2FA solutions charge per user or per month, regardless of usage. Akedly's TOTP authentication uses pay-per-success billing - you only pay when users successfully authenticate.

Cost Savings Examples:

• 1,000 registered users, 500 monthly authentications = 500 × 0.25 EGP = 125 EGP/month
• Traditional solutions: 1,000 × 2 EGP/user = 2,000 EGP/month
• Your Savings: 94% cost reduction

Integration Options

Choose the integration approach that best fits your application architecture and requirements:

Option 1: Hosted Integration (Recommended)

1. Create TOTP Pipeline in dashboard
   ↓
2. Redirect users to hosted setup page
   https://app.akedly.io/totp/setup?pipeline=ID&identifier=email
   ↓
3. User completes setup on Akedly's page
   ↓
4. User redirected back to your app
   ↓
5. For authentication: redirect to hosted auth page
   https://app.akedly.io/totp/request?requestID=ID
   ↓
6. Receive webhook notifications + frontend callbacks

Option 2: Direct API Integration

1. Call API to create TOTP user
   POST /api/v1/totp/create
   ↓
2. Build UI to display QR code/deep link
   Your custom React/Angular/Vue components
   ↓
3. Call API to verify setup
   POST /api/v1/totp/verify-setup
   ↓
4. For authentication: call API to request auth
   POST /api/v1/totp/request-auth
   ↓
5. Build UI to collect TOTP code
   Your custom token input components
   ↓
6. Call API to verify authentication
   POST /api/v1/totp/verify-auth/{requestID}

Getting Started

Prerequisites

Before implementing TOTP authentication, ensure you have:

1. Akedly Account: Sign up if you haven't already
2. API Key: Available in your dashboard under "View API Key"
3. Company Profile: Set up your company information for branding
4. TOTP Pipeline: Create a pipeline for hosted integration (Option 1 only)

Quick Start Guide

For Hosted Integration:

1. Complete the Hosted Integration Guide
2. Set up TOTP Pipeline in your dashboard
3. Redirect users to Akedly's hosted pages
4. Handle callbacks and webhooks

For Direct API Integration:

1. Complete the Direct API Integration Guide
2. Implement custom UI components
3. Integrate with Akedly's TOTP APIs
4. Handle all authentication states

Need Help Choosing?

Choose Hosted Integration if:

• You want the fastest implementation
• You're building a standard web or mobile app
• You want Akedly to handle all UI edge cases
• You prefer zero frontend TOTP development

Choose Direct API Integration if:

• You need complete UI control
• You have specific branding requirements
• You want to integrate TOTP into complex flows
• You have frontend development resources

What's Next?

Select your preferred integration approach and follow the comprehensive step-by-step guides: