> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trepzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Public request IDs, webhook deliveries, and safe diagnostics.

# Troubleshooting

[Intro](#intro)

<h2 id="intro">
  Intro
</h2>

When a call fails, keep the public `request_id` and `correlation_id` from the envelope. Do not send secrets, PAN, or live credentials to support. Start again from [getting started](./getting-started#intro) or read the [changelog](./changelog#intro).

<h2 id="diagnostics">
  Diagnostics
</h2>

| Symptom         | What to check                                            |
| --------------- | -------------------------------------------------------- |
| 401             | credential, environment header, `tpztest_` vs `tpzlive_` |
| 403             | grant for the `operation_id`                             |
| 404             | public ref format such as `refund_ref`                   |
| webhook invalid | exact bytes, `Trepzy-Signature`, 300s skew               |

Docs Try It never targets live. If the portal origin is not exactly `https://docs.trepzy.com`, CORS denies the request.