Troubleshooting Guide
Structured troubleshooting guide with common issues, diagnostic steps, and solutions. Reduce support burden.
Available Variables
Use these variables with Handlebars syntax {{variableName}} in your content.
{{issue1Title}}Connection timeout errors
{{issue2Title}}Transaction declined unexpectedly
{{issue3Title}}Webhook not receiving events
{{serviceName}}Payment Gateway
{{issue1Causes}}Network connectivity issues, firewall blocking, or service overload.
{{issue2Causes}}Invalid card details, insufficient funds, or fraud detection triggers.
{{relatedIssue1}}SSL certificate errors
{{relatedIssue2}}Rate limiting issues
{{issue1Symptoms}}Requests to the payment API return ETIMEDOUT or connection refused errors.
{{issue2Symptoms}}Valid transactions are being declined with error code CARD_DECLINED.
{{issue3QuickFix}}curl -X POST https://api.payment.com/webhooks/test \ -H 'Authorization: Bearer YOUR_API_KEY'
{{issue3Symptoms}}Webhook endpoint is not receiving payment events.
{{issue1Step1Code}}curl -X GET https://api.payment.com/health
{{issue1Step1Desc}}Verify the payment service is running and healthy
{{issue1Step2Desc}}Ensure your server can reach the payment API endpoint
{{issue1Step3Desc}}Verify outbound connections to port 443 are allowed
{{issue2Step1Code}}// Check the last 4 digits match console.log(card.last4);
{{issue2Step1Desc}}Ensure card number, expiry, and CVV are correct
{{issue2Step2Desc}}Review fraud detection settings in the dashboard
{{issue1Step1Title}}Check service status
{{issue1Step2Title}}Verify network connectivity
{{issue1Step3Title}}Check firewall rules
{{issue2Step1Title}}Verify card details
{{issue2Step2Title}}Check fraud rules
More developer Templates
Release Changelog
Developer-friendly changelog template with version timeline, categorized changes (Added, Changed, Fixed), and contributor badges.
API Documentation
Professional API documentation template with sidebar navigation, endpoint cards, and code examples. Developer-friendly design.
GitHub README
Beautiful GitHub-style README template with badges, feature grid, installation guide, and code examples. Perfect for open source projects.