Payment Processors
Payment Processors configuration allows administrators to set up and manage the various payment processing methods and gateways used by DebtRecoup. This ensures secure, compliant payment processing across all channels.

Accessing Payment Processors
- Click the settings icon in the top navigation bar
- Select Payments from the left sidebar
- Click on Processors
Processor Types
ACH Processors
Supported Providers
- CheckGateway
- PaymentVision
- Vantiv
- First Data
- Custom API
Configuration Requirements
- Merchant ID
- API Keys
- Routing validation
- Return handling
- Settlement timing
Credit Card Processors
Supported Gateways
- Authorize.Net
- PayPal Payflow
- Stripe
- Square
- Worldpay
Setup Requirements
- Merchant Account
- Gateway Credentials
- PCI Compliance
- Tokenization
- Fee structure
Check Processing
Check 21 Providers
- CrossCheck
- Certegy
- TeleCheck
- RDM
- Custom integration
Features
- Check verification
- Guarantee services
- Electronic deposit
- Return handling
Adding a Processor
Basic Configuration
- Click Add Processor
- Select processor type
- Enter configuration:
General Settings
- Processor Name
- Display Name
- Description
- Active Status
- Default for Type
Credentials
- Merchant ID
- Username/API Key
- Password/Secret
- Terminal ID
- Test Mode
Advanced Settings
- API Endpoint
- Timeout Settings
- Retry Attempts
- Batch Timing
- Custom Headers
Testing Configuration
Always Test First
Use test credentials to verify configuration before enabling production processing.
- Enable test mode
- Process test transaction
- Verify response
- Check settlement
- Switch to production
Processor Settings
Transaction Limits
Set limits by:
Amount Limits
Minimum Transaction: $5.00
Maximum Transaction: $10,000.00
Daily Limit: $50,000.00
Monthly Limit: $500,000.001
2
3
4
2
3
4
Velocity Controls
Max Transactions/Day: 500
Max per Account/Day: 2
Max per Card/Month: 5
Duplicate Window: 5 minutes1
2
3
4
2
3
4
Fee Configuration
Processing Fees
- Percentage rate
- Transaction fee
- Monthly minimum
- Batch fees
- Return fees
Fee Handling
- Add to payment amount
- Deduct from payment
- Bill separately
- Absorb fees
Risk Management
Fraud Prevention
- AVS verification
- CVV requirement
- Velocity checking
- Blacklist management
- IP restrictions
Decline Handling
- Retry logic
- Alternative processors
- Decline codes
- Customer messaging
ACH Configuration
NACHA Compliance
SEC Codes
- PPD (Personal)
- CCD (Corporate)
- WEB (Internet)
- TEL (Telephone)
- ARC (Check conversion)
Authorization Requirements
- Written authorization
- Recorded verbal
- Web form capture
- Retention period
ACH Validation
Account Verification
- Routing number check
- Account validation
- Micro-deposits
- Instant verification
- NOC handling
Return Processing
- Return codes
- Auto-retry rules
- Fee assessment
- Status updates
- Notification
Credit Card Setup
PCI Compliance
Security Requirements
- SSL encryption
- Tokenization
- No card storage
- Secure transmission
- Access controls
Compliance Features
- PCI scanning
- Vulnerability tests
- Security training
- Incident response
- Annual attestation
Card Features
Supported Types
- Visa
- Mastercard
- Discover
- American Express
- Debit cards
Transaction Types
- Authorization only
- Sale (Auth + Capture)
- Refund
- Void
- Recurring
Check Processing Setup
Check 21 Configuration
Image Requirements
- Front image capture
- Back endorsement
- Image quality
- File format
- Compression
Deposit Options
- Same-day deposit
- Next-day deposit
- Electronic submission
- Physical deposit
Verification Services
Identity Verification
- Driver's license
- State ID
- Check history
- Account status
Risk Assessment
- Check approval
- Guarantee limits
- Decline reasons
- Override options
Multi-Processor Setup
Load Balancing
Distribute transactions:
Primary Processor: 70%
Secondary Processor: 20%
Backup Processor: 10%1
2
3
2
3
Failover Configuration
Automatic switching:
- Primary fails
- Route to secondary
- Log failure
- Retry primary later
- Alert administrators
Smart Routing
Route based on:
- Payment amount
- Payment method
- Geographic location
- Processor fees
- Success rates
Integration Settings
API Configuration
RESTful APIs
json
{
"endpoint": "https://api.processor.com/v2",
"auth_type": "bearer",
"timeout": 30,
"retry_count": 3
}1
2
3
4
5
6
2
3
4
5
6
Webhook Setup
- Payment notifications
- Status updates
- Return alerts
- Batch confirmations
Response Handling
Success Responses
- Parse confirmation
- Store reference
- Update account
- Calculate fees
Error Handling
- Log errors
- Retry logic
- Fallback options
- User messaging
Reporting Integration
Settlement Reports
Daily Settlement
- Transaction list
- Batch totals
- Fee breakdown
- Net deposits
Reconciliation
- Match transactions
- Identify discrepancies
- Balance accounts
- Exception reports
Analytics
Track metrics:
- Approval rates
- Decline reasons
- Processing time
- Fee analysis
- Processor performance
Maintenance
Regular Tasks
Daily Checks
- Connection status
- Error rates
- Settlement files
- Return processing
Monthly Review
- Fee analysis
- Performance metrics
- Security updates
- Compliance check
Updates and Changes
Processor Updates
- API version changes
- Security patches
- Feature additions
- Requirement changes
Testing Protocol
- Review changes
- Update test environment
- Validate functionality
- Schedule production update
- Monitor after deployment
Troubleshooting
Connection Issues
Timeout Errors
- Check network
- Verify endpoints
- Review firewall
- Increase timeout
Authentication Failures
- Verify credentials
- Check IP whitelist
- Review permissions
- Reset passwords
Transaction Failures
Decline Analysis
- Review decline codes
- Check limits
- Verify data
- Contact processor
Settlement Issues
- Check batch status
- Verify cut-off times
- Review exceptions
- Contact support
Security Best Practices
Credential Management
- Rotate API keys quarterly
- Use strong passwords
- Limit access
- Audit usage
- Secure storage
Monitoring
- Real-time alerts
- Unusual activity
- Failed attempts
- High-value transactions
- After-hours processing
Compliance
- Regular audits
- Security scans
- Documentation updates
- Training records
- Incident procedures
Related Documentation
- Manage Payments - Payment transaction management
- Payment Processing - Collector payment entry
- Company Settings - Organization configuration
- Audit Logs - Processor activity tracking