VotePipe

Callback Troubleshooting

Common issues and solutions for server callbacks

Callback Not Receiving Requests

Issue: No requests received

  • Verify your callback URL is publicly accessible (not localhost or private IP)
  • Check that your server firewall allows incoming POST requests
  • Ensure your endpoint is listening on the correct port
  • Test the URL manually with a tool like curl or Postman
  • Use the Test Callback button in Settings to verify connectivity

Issue: SSL/TLS errors

  • Ensure your callback URL uses HTTPS (required for production)
  • Check that your SSL certificate is valid and not expired
  • Verify the certificate chain is complete
  • For development, you can use HTTP but it's not recommended

Authentication Issues

Issue: 401 Unauthorized

  • Verify the Authorization header format: Bearer <secret>
  • Check that the secret matches exactly (no extra spaces or encoding)
  • Log the incoming Authorization header to debug
  • Regenerate the secret if needed (update both VotePipe and your server)

Timeout Issues

Issue: Requests timing out

  • Check your plan's timeout limit:
    • Growth: 5 seconds
    • Pro: 15 seconds
    • Business: 30 seconds
  • Optimize your callback endpoint to respond quickly
  • Process votes asynchronously if needed (acknowledge immediately, process later)
  • Consider upgrading to a plan with longer timeouts if needed

Retry Issues

Issue: Callbacks failing after retries

  • Check the vote details page to see retry attempts and error messages
  • Review your server logs for the specific error
  • Ensure your endpoint handles duplicate requests (idempotency)
  • Verify your server can handle the retry rate
  • Consider implementing rate limiting if needed

Payload Issues

Issue: Invalid payload format

  • Verify Content-Type header is application/json
  • Check that the request body is valid JSON
  • Review the payload format documentation
  • Log the incoming request body to debug

Debugging Tips

Enable Logging

Log all incoming requests to your callback endpoint, including headers, body, and response codes.

Test Manually

Use curl or Postman to manually send test requests to your endpoint:

bash
curl -X POST https://your-server.com/api/vote \ -H "Content-Type: application/json" \ -H "Authorization: Bearer your-secret" \ -d '{"event":"vote","vote_id":"test","voter_name":"TestUser","provider":"hytale-servers-pro","received_at":"2026-01-02T15:30:00Z"}'

Check Vote History

Review the Votes page to see callback status, retry attempts, and error messages for each vote.

API Testing

You can test your callback endpoint programmatically using the API:

→ Test callback endpoint via API→ List all callbacks

Still Need Help?

If you're still experiencing issues: