Troubleshooting
A safe checklist for diagnosing common integration failures.
Working scaffold: Add ONE's actual status codes, logs, support channels, and account-management paths after verification.
Start with the request
Check that the request uses the documented host and path, the credential is available to the server process, required fields are present, and the chosen identifier is supported. Compare the outgoing request with a known-good example without sharing secrets.
Collect useful diagnostics
Record the time, request ID if provided, endpoint, status code, and a redacted error summary. Do not include credentials or sensitive input in a support ticket unless explicitly requested through an approved secure process.
Decide whether to retry
Correct configuration and validation errors before retrying. For transient failures, follow the retry guidance in Errors and retries. If the issue persists, follow the verified support path and include only the safe diagnostic information requested there.