Troubleshooting Overview
This section is the starting point for diagnosing integration issues visible to merchants, developers, and partners.
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
- payment method availability issues visible in a merchant flow
Recommended diagnostic path
- Identify the route family involved.
- Check the returned error code in the platform error catalog.
- Confirm environment, credentials, and scopes.
- Check merchant or app ownership constraints.
- Review webhooks, events, and notifications exposed to your integration.