Troubleshooting Guide

This guide covers common issues and solutions for integrating with the Netomnia Wholesale Gateway API.

Common Errors & Solutions

400 Bad Request

• Error: Validation failed: ...
• Solution:
  • Check all required fields and enum values
  • Refer to the API Reference for field requirements

404 Not Found

• Error: Resource not found
• Solution:
  • Verify the resource ID or address is correct
  • Ensure the resource exists in the environment (sandbox/production)

409 Conflict

• Error: Order already exists, Appointment slot already booked, etc.
• Solution:
  • Check for duplicate submissions
  • Ensure the resource is not already in the desired state

Webhook Issues

• Error: Not receiving webhooks, or duplicate events
• Solution:
  • Ensure your endpoint is reachable and returns 2xx status
  • Handle retries and duplicate events idempotently
  • See the Webhooks Guide

Still Need Help?

• See the General Support page
• Contact support@netomnia.com
  • Tip: When contacting support, please provide as much information as possible about your request, including the request payload, request and conversation ID(s), error codes, and error ID (if available). This will help us resolve your issue more efficiently.