Dunning Management

GetPaidHQ provides dunning management capabilities to handle failed payment recovery through configurable campaigns and retry strategies.

Overview

Dunning management handles the process of recovering failed payments through:

• Automated retry attempts with configurable timing
• Customer communication campaigns
• Payment method update workflows
• Campaign analytics and reporting

How Dunning Works

When a payment fails, GetPaidHQ can automatically:

1. Categorize the failure type (technical, decline, insufficient funds)
2. Apply appropriate retry strategies based on failure reason
3. Send customer communications with payment update links
4. Track recovery attempts and outcomes
5. Generate analytics on campaign performance

Core Components

Dunning Campaigns

Campaigns define the recovery strategy for failed payments:

Campaign Configuration

• Timing: Specify retry intervals (immediate, hours, days)
• Attempts: Configure maximum retry attempts
• Communications: Set up customer notification schedules
• Conditions: Define when campaigns should trigger

Campaign Lifecycle

1. Trigger: Payment failure occurs
2. Categorization: Failure type is determined
3. Strategy Application: Appropriate campaign is selected
4. Execution: Retry attempts and communications are sent
5. Resolution: Payment succeeds or campaign completes

Campaign Types

• Immediate Retry: For technical failures and temporary issues
• Progressive Engagement: Graduated customer outreach over time
• Grace Period: Allow account access during recovery period
• Final Notice: Last attempt before subscription cancellation

Payment Recovery Methods

Automatic Retries

Technical failures are retried automatically:

• API timeouts: Immediate retry
• Network errors: Exponential backoff
• Gateway issues: Delayed retry with alternative routing

Customer-Initiated Updates

For declined payments, customers can:

• Update payment methods via secure links
• Add backup payment methods
• Resolve account issues directly

Manual Recovery

Support teams can:

• Trigger manual retry attempts
• Override campaign settings
• Apply custom recovery strategies

Implementation

API Integration

Dunning operations are managed through dedicated API endpoints:

• /api/dunning/campaigns - Campaign management
• /api/dunning/configurations - Settings and rules
• /api/payment-tokens/verify - Payment update verification
• /api/customers/{id}/dunning-history - Customer recovery history

Monitoring and Analytics

Track dunning performance with built-in analytics:

• Recovery rates by failure type
• Campaign effectiveness metrics
• Customer communication engagement
• Revenue recovery attribution

Next Steps

1. Configure your first dunning campaign
2. Set up customer communications
3. Implement payment update workflows
4. Monitor recovery performance