Skip to main content

Merchant Management

The Merchant Management module handles merchant relationships and data management within PulseCRM.

Overview​

This module provides:

  • Merchant account management
  • ISO relationship tracking
  • Agent associations
  • Processing oversight
  • Support management

Core Components​

Key Tables​

merchants​

Primary table for merchant information:

- id: Primary key
- businessName: Merchant name
- accountId: Associated account
- status: Merchant status
- created_at: Creation timestamp
- updated_at: Last update timestamp

merchantIsos​

Maps relationships between merchants and ISOs:

- merchant_id: Reference to merchants
- iso_id: Reference to ISO accounts
- relationship_type: Type of relationship
- revenue_share: Revenue sharing details
- created_at: Creation timestamp

merchantAgents​

Maps relationships between merchants and agents:

- merchant_id: Reference to merchants
- agent_id: Reference to agents
- assignment_type: Type of assignment
- commission_plan: Commission details
- created_at: Creation timestamp

Features​

Account Management​

  • Merchant profiles
  • Status tracking
  • Information updates
  • Support management
  • Document handling

Relationship Management​

  • ISO associations
  • Agent assignments
  • Revenue sharing
  • Commission tracking
  • Territory management

Processing Management​

  • Volume tracking
  • Fee management
  • Settlement oversight
  • Chargeback handling
  • Risk monitoring

Support Tools​

  • Ticket management
  • Communication logs
  • Issue tracking
  • Resolution management
  • Service history

API Endpoints​

Merchant Management​

List Merchants​

GET /api/merchants

Query Parameters:

  • status: Filter by status
  • iso: Filter by ISO
  • agent: Filter by agent

Create Merchant​

POST /api/merchants

Request body:

{
  "businessName": "string",
  "accountId": "string",
  "status": "string",
  "relationships": {
    "iso": "string",
    "agent": "string"
  },
  "processing": {
    "volume": "number",
    "category": "string"
  }
}

Update Merchant​

PUT /api/merchants/{merchantId}

Update merchant information:

{
  "status": "string",
  "relationships": {
    "iso": "string",
    "agent": "string"
  },
  "settings": {
    "processing": "object",
    "support": "object"
  }
}

Relationship Management​

Assign Agent​

POST /api/merchants/{merchantId}/agents

Create agent assignment:

{
  "agentId": "string",
  "assignmentType": "string",
  "commissionPlan": {
    "type": "string",
    "rate": "number"
  }
}

Merchant Statuses​

Active​

  • Full processing
  • Regular monitoring
  • Support access
  • Feature availability

Suspended​

  • Processing hold
  • Investigation status
  • Limited access
  • Support priority

Terminated​

  • Account closure
  • Final settlement
  • Documentation
  • Archive process

UI Components​

MerchantProfile​

Merchant information display:

interface MerchantProfileProps {
  merchant: Merchant;
  onUpdate: (data: Partial<Merchant>) => void;
  onStatus: (status: string) => void;
}

RelationshipManager​

Relationship management interface:

interface RelationshipManagerProps {
  merchantId: string;
  relationships: Relationship[];
  onAssign: (relationship: Relationship) => void;
  onRemove: (relationshipId: string) => void;
}

ProcessingOverview​

Processing information display:

interface ProcessingOverviewProps {
  merchantId: string;
  metrics: ProcessingMetrics;
  onUpdate: (metrics: Partial<ProcessingMetrics>) => void;
}

Best Practices​

  1. Account Management

    • Regular status reviews
    • Information updates
    • Relationship monitoring
    • Support tracking

  2. Relationship Management

    • Clear assignments
    • Commission accuracy
    • Territory respect
    • Communication logs

  3. Processing Oversight

    • Volume monitoring
    • Fee reconciliation
    • Risk assessment
    • Compliance checks

  4. Support Management

    • Response time
    • Issue resolution
    • Communication records
    • Service quality

Integration Points​

Application Processing​

  • Account creation
  • Information transfer
  • Setup completion
  • Status tracking

Transaction Management​

  • Processing setup
  • Volume monitoring
  • Fee calculation
  • Settlement management

Support System​

  • Ticket creation
  • Issue tracking
  • Resolution management
  • Communication history

Revenue Management​

Commission Tracking​

  • Rate calculation
  • Payment processing
  • Split management
  • Adjustment handling

Revenue Sharing​

  • ISO splits
  • Agent commissions
  • Override management
  • Bonus calculations

Reconciliation​

  • Fee verification
  • Payment tracking
  • Adjustment processing
  • Report generation