Skip to main content

Troubleshooting Overview

This section is the starting point for diagnosing integration and operational issues across the Ikawaari platform.

Primary troubleshooting domains

  • authentication and scopes
  • environment and sandbox mismatches
  • payment and payout failures
  • webhook delivery issues
  • merchant settings and onboarding blockers
  • app installation, grants, tokens, and webhook issues
  • operator and provider health issues
  1. Identify the route family involved.
  2. Check the returned error code in the platform error catalog.
  3. Confirm environment, credentials, and scopes.
  4. Check merchant or app ownership constraints.
  5. Review webhook, events, and notification traces.