Skip to main content

Transaction Management

The Transaction Management module processes and tracks financial transactions within PulseCRM.

Overview​

This module provides:

  • Transaction processing
  • Gateway integration
  • Settlement management
  • Chargeback handling
  • Reporting tools

Core Components​

Key Tables​

transactions​

Primary table for transaction information:

- id: Primary key
- merchantId: Reference to merchant
- amount: Transaction amount
- type: Transaction type
- status: Transaction status
- gatewayId: Processing gateway
- created_at: Transaction timestamp
- updated_at: Last update timestamp

Transaction Types​

  • Sales
  • Refunds
  • Chargebacks
  • Voids
  • Authorizations

Transaction Status​

  • Pending
  • Approved
  • Declined
  • Settled
  • Voided

Features​

Transaction Processing​

  • Real-time processing
  • Authorization handling
  • Settlement tracking
  • Batch management
  • Fee calculation

Gateway Integration​

  • Multiple gateway support
  • Routing rules
  • Response handling
  • Error management
  • Status synchronization

Settlement Management​

  • Batch closure
  • Fund distribution
  • Fee reconciliation
  • Adjustment handling
  • Report generation

Chargeback Management​

  • Case tracking
  • Response management
  • Documentation handling
  • Resolution tracking
  • Prevention tools

API Endpoints​

Transaction Processing​

Process Transaction​

POST /api/transactions

Request body:

{
  "merchantId": "string",
  "amount": "number",
  "type": "sale" | "refund" | "void",
  "card": {
    "number": "string",
    "expiry": "string",
    "cvv": "string"
  },
  "billing": {
    "address": "string",
    "zip": "string"
  }
}

Get Transaction​

GET /api/transactions/{transactionId}

Returns transaction details:

{
  "id": "string",
  "merchantId": "string",
  "amount": "number",
  "type": "string",
  "status": "string",
  "gatewayResponse": {
    "code": "string",
    "message": "string",
    "authCode": "string"
  },
  "timestamps": {
    "created": "string",
    "updated": "string",
    "settled": "string"
  }
}

Batch Management​

Close Batch​

POST /api/merchants/{merchantId}/batch/close

Close current batch:

{
  "batchId": "string",
  "totalAmount": "number",
  "transactionCount": "number",
  "autoClose": "boolean"
}

Gateway Integration​

Supported Gateways​

  • Major processors
  • Regional gateways
  • Alternative payments
  • Digital wallets
  • ACH processors

Integration Features​

  • Transaction routing
  • Response mapping
  • Error handling
  • Status tracking
  • Reconciliation

Gateway Configuration​

interface GatewayConfig {
  id: string;
  name: string;
  credentials: {
    apiKey: string;
    merchantId: string;
    terminalId?: string;
  };
  features: string[];
  settings: {
    timeout: number;
    retryCount: number;
    batchClose: string;
  };
}

Settlement Process​

Batch Management​

  • Auto-close configuration
  • Manual close options
  • Batch monitoring
  • Error handling
  • Reporting

Fund Distribution​

  • Split calculations
  • Fee deductions
  • Reserve management
  • Adjustment processing
  • Payment scheduling

Reconciliation​

  • Transaction matching
  • Fee verification
  • Adjustment tracking
  • Report generation
  • Exception handling

Reporting​

Transaction Reports​

  • Daily summaries
  • Batch reports
  • Settlement reports
  • Fee reports
  • Exception reports

Analysis Tools​

  • Volume analysis
  • Trend monitoring
  • Fee analysis
  • Performance metrics
  • Risk indicators

Best Practices​

  1. Transaction Processing

    • Validation checks
    • Error handling
    • Response logging
    • Status monitoring
    • Security measures

  2. Gateway Management

    • Configuration verification
    • Response monitoring
    • Error tracking
    • Performance optimization
    • Security compliance

  3. Settlement Management

    • Batch monitoring
    • Reconciliation checks
    • Exception handling
    • Report verification
    • Timeline adherence

  4. Security

    • Data encryption
    • PCI compliance
    • Access control
    • Audit logging
    • Fraud prevention

Integration Points​

Merchant Management​

  • Account configuration
  • Processing setup
  • Fee management
  • Status updates

Financial Management​

  • Revenue tracking
  • Fee calculation
  • Split management
  • Reporting integration

Risk Management​

  • Transaction monitoring
  • Fraud detection
  • Risk scoring
  • Compliance checks

Security Measures​

Data Protection​

  • Encryption standards
  • Tokenization
  • Access controls
  • Audit trails
  • Compliance monitoring

Fraud Prevention​

  • Real-time screening
  • Pattern detection
  • Velocity checks
  • Risk scoring
  • Block lists

Compliance​

  • PCI DSS requirements
  • Industry regulations
  • Security standards
  • Audit requirements
  • Documentation