Fanup Agent Management System

A smart platform for registering and verifying card reader applicants, integrated with Shaparak

About the system

This system is the core of managing how sales agents for Fanup card readers are recruited and activated. Agents across the country use their dedicated panel to register applicants’ information and verify it in real time against government systems (Shaparak, the Iranian National Tax Administration). After final approval, a Merchant ID and a Terminal ID are issued and the device is activated.

Technical specifications and workflow

1. System architecture

Transaction routing system design diagram

2. A 5-step process

Step

Process

Technology used

1. Initial registration

The agent enters the applicant’s information

Dynamic forms with client-side validation

2. Verification

Four sources checked at once:
- National ID match (identity verification system)
- Postal code validity (postal system)
- Tax code accuracy (Iranian National Tax Administration)
- No restrictions (bounced-cheque system)

RESTful API over HTTPS

3. Final approval

Risk analysis and data matching

An AML (anti-money laundering) analysis engine

4. Code issuance

Unique generation of:
- Merchant ID
- Terminal ID

SHA-256 + timestamp algorithm

5. Activation

Coordination with the warehouse and support

Warehouse management system (WMS)

Key technical features

1. Agent management panel

  • Two-factor authentication (national ID + dynamic SMS password)
  • Hierarchical access levels (provincial supervisor, city agent)
  • Real-time monitoring of agent performance

2. Smart verification module

  • Secure connections to government systems using:
    • End-to-end encryption
    • An EV SSL certificate
  • A fallback mechanism when government services are unavailable

3. Code issuance system

  • Generation of unique codes

4. Integration with Shaparak

Function

Implementation

Final merchant registration

Shaparak API (version 3)

Receiving confirmation

Webhook with an encrypted payload

Reporting

Secure file transfer over SFTP

Business benefits

Benefit

Operational impact

70% faster activation

From 72 hours to 2 hours

No human errors

100% automated verification

Regulatory compliance

Compliance with Article 169 of the Direct Taxes Act

Centralized agent management

Supervising 1,000+ agents on a single platform

40% lower operating costs

No more paper-based processes

System security

Protection layers:

1. Data encryption

  • Sensitive information stored with AES-256
  • Tokenization of banking data

2. Access security

  • IP restrictions for agents
  • JWT-based authentication

3. API protection

  • Rate limiting (1,000 requests/minute)
  • DDoS protection with Cloudflare

Use cases

  • Banks: recruiting new merchants for the payment network
  • Payment companies: expanding the device distribution network
  • Chain stores: launching new branches quickly

Analytical reports

Report

Purpose

Registration conversion rate

Analyzing agent performance

Geographic map of applicants

Identifying new markets

Verification error statistics

Optimizing processes

Average activation time

Assessing the efficiency of government systems

Summary

By creating an integrated ecosystem connecting agents, applicants and government systems, the Fanup agent management system has cut card reader activation from a 72-hour process to under 2 hours. Using:

  • Secure Shaparak web services
  • Unique code generation algorithms
  • Real-time analytics dashboards

the platform has become the backbone of the country’s payment network expansion.