This resource is designed for advanced users who need detailed guidance on troubleshooting common setup and installation issues, as well as integration issues with payment processors. If you’re experiencing any difficulties, this page should help you resolve them quickly and effectively.

Common Setup and Installation Issues

1. Plugin Installation Problems

  • Issue: Unable to install the plugin.
  • Solution: Ensure your WordPress version is up to date. Donor Merchant requires WordPress 5.0 or higher. Check your site’s PHP version as well; it should be 7.4 or higher. If you continue to experience issues, download the plugin directly from our website and upload it manually via the “Upload Plugin” option in the WordPress dashboard.

2. Plugin Activation Errors

  • Issue: Error messages when activating the plugin.
  • Solution: Ensure there are no conflicting plugins. Disable all other plugins and try activating Donor Merchant again. If it works, reactivate your plugins one by one to identify the conflict.

Integration Issues with Payment Processors

1. Payment Processor Configuration

  • Issue: Unable to connect with payment processors (Authorize.net, PayPal, Stripe).
  • Solution:
    • Authorize.net: Verify API Login ID and Transaction Key. Ensure your account is set to live mode and not in test mode.
    • PayPal: Confirm you are using the correct PayPal API credentials. Check if your account is verified and has IPN (Instant Payment Notification) enabled.
    • Stripe: Ensure you are using live API keys for live transactions and test keys for test transactions. Double-check your webhook settings.

2. Transaction Errors

  • Issue: Transactions are not processing correctly.
  • Solution: Review the error messages provided. Common issues include incorrect API keys, account settings, or communication errors with the payment gateway. Check your server logs for detailed error information. Contact your payment processor’s support for assistance if the issue persists.

System Compatibility Issues

1. CMS Compatibility

  • Issue: Donor Merchant is not functioning correctly.
  • Solution: Donor Merchant is designed specifically for WordPress. If you are using a different CMS, Donor Merchant will not be compatible. Ensure your website is powered by WordPress 5.0 or higher.

2. Theme and Plugin Conflicts

  • Issue: Donor Merchant conflicts with your theme or other plugins.
  • Solution: Temporarily switch to a default WordPress theme (e.g., Twenty Twenty-One) and disable other plugins. If Donor Merchant works correctly, there may be a conflict with your theme or another plugin. Reactivate your theme and plugins one by one to identify the source of the conflict.

Advanced Troubleshooting

1. Debug Mode

  • Issue: Need detailed error information.
  • Solution: Enable WordPress debug mode by adding define('WP_DEBUG', true); to your wp-config.php file. This will provide detailed error messages that can help identify the issue.

2. Server Requirements

  • Issue: Server-related problems affecting plugin performance.
  • Solution: Ensure your server meets the following requirements:
    • PHP 7.4 or higher
    • MySQL 5.6 or higher
    • HTTPS enabled
    • Proper file permissions set on your WordPress directories

3. API Rate Limits

  • Issue: Exceeding API rate limits with payment processors.
  • Solution: Review the API rate limits for your payment processor and ensure your usage does not exceed these limits. Optimize your API calls and consider upgrading your plan with the payment processor if necessary.

Need More Help?

If you’ve tried the above solutions and are still experiencing issues, please visit our Support Center for more detailed guides and resources. You can also contact our support team directly at support@donormerchant.com for personalized assistance.

Thank you for choosing Donor Merchant. We’re here to support you every step of the way!