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

# Troubleshooting

> Fix common SDK integration issues quickly.

## Modal does not open

* Confirm `clientSecret` is present and current.

## Auth errors creating intents

* Verify your backend sends `Authorization: Bearer <api_key>`.
* Verify key mode/environment matches your test scenario.

## React modal never closes

* Wire `onClose` to set your `open` state to `false`.

## CORS/network failures

* Check frontend origin policy and server/network access.
* Confirm endpoint path and HTTPS configuration.
* `POST /v1/payment_intents` must be called from your backend, not browser code, because it uses an API key.
* `POST /v1/payment_intents/resolve` is the browser-facing endpoint and should work from arbitrary merchant domains.
* Do not keep API Gateway-managed CORS enabled for this API, because it will conflict with the route-specific Fastify CORS behavior.