Payment Attempts¶

Monitor and manage failed and retrying payment transactions.

Payment Attempts shows all payment processing attempts, including successful, failed, and retrying transactions. Use this tool to troubleshoot payment issues and recover failed payments.

Navigation: Admin → Tools → Payment Attempts

Viewing Payment Attempts¶

List View¶

Shows all payment attempts with:

Transaction ID - Reference number
Amount - Payment amount
Status - Pending/Success/Failed/Retrying
Payment Method - Card/Cash/Other
Date/Time - When attempted
Retry Count - Number of retries
Error - Failure reason (if failed)

Filter by:

Date Range - Today, This Week, Custom
Status - All, Success, Failed, Retrying
Amount Range - Min/max amounts
Payment Method - Card, Cash, etc.
Error Type - Specific error

Sort Options¶

By Date (newest first)
By Amount
By Status
By Retry Count

Understanding Payment Statuses¶

Status	Meaning	Action
Pending	Awaiting authorization	Wait or timeout
Success	Payment authorized and captured	Complete
Failed	Payment declined/error	Retry or troubleshoot
Retrying	Automatic retry in progress	Wait or manual retry
Abandoned	Customer cancelled	No action

Failed Payment Details¶

View Failure Reason¶

Click payment to see:

Error Code - Payment processor error code
Error Message - Human-readable explanation
Response Details - Full processor response
Card Last 4 - Partial card number (if card)
Auth Code - Authorization code (if obtained)

Common Payment Errors¶

Error	Cause	Solution
Declined	Card declined by bank	Use different card, contact bank
Insufficient Funds	Not enough balance	Use different card
Expired Card	Card expired	Use different card
AVS Failed	Address verification failed	Verify address
CVC Failed	CVV verification failed	Verify CVV
Timeout	No response from processor	Retry payment
Network Error	Connection issue	Check network, retry
Configuration Error	Merchant setup issue	Contact support

Retrying Failed Payments¶

Manual Retry¶

Find failed payment
Click Retry Payment
System attempts payment again
Check status

Batch Retry¶

Select multiple failed payments (checkboxes)
Click Retry Selected
System retries all
Monitor status

Automatic Retries¶

System automatically retries based on settings:

Retry Interval (e.g., every 5 minutes)
Max Attempts (e.g., 3 times)
Max Age (e.g., 24 hours)

See Settings → Admin for retry policy.

Refunding Payments¶

Manual Refund¶

Find successful payment
Click Refund
Confirm amount (full or partial)
Reason (optional)
Complete refund

Refund Status¶

Pending - Refund in progress
Success - Refund completed
Failed - Refund failed (try again)

Payment Analysis¶

Payment Summary¶

Shows statistics:

Total Payments - Count this period
Total Amount - Sum of all payments
Success Rate - % successful
Failure Rate - % failed
Average Amount - Mean transaction

Failure Analysis¶

Most Common Errors - Top failure reasons
Failure Trend - Increasing/decreasing
Peak Failure Times - When most failures occur
Payment Methods - Which methods failing

Troubleshooting Payments¶

Frequent Failures¶

Check payment gateway connection (Diagnostics)
Verify merchant account active
Check processor status page
Review error codes
Contact payment processor support

Timeouts¶

Check network connectivity
Verify payment gateway responding (Diagnostics)
Increase timeout setting (if available)
Retry payment

Authorization Issues¶

Verify card details
Check card not expired
Confirm customer has sufficient funds
Try different card
Contact bank if issue persists

Batch Failures¶

If many payments failing:

Check Diagnostics for gateway connection
Review error messages for pattern
Verify merchant account status
Check payment processor status page
Contact support if widespread

Best Practices¶

✅ Monitor payment failures regularly
✅ Address failures quickly
✅ Retry failed payments
✅ Investigate failure trends
✅ Keep customer informed
✅ Document recurring issues
✅ Review refund audit trail
✅ Test payment gateway regularly
✅ Verify processor status periodically