Troubleshooting

If you followed the sections in order—from Introduction through the Express webhook guide—this matrix is still the quickest way back to green.

Symptom	Likely cause	Fix
`useUnseenConfig must be used inside UnseenProvider`	Hook outside wrapper	Wrap in `<UnseenProvider>`.
`UnseenProvider apiKey is required ...`	Browser tries to create payment without key	Pass `createPaymentSession` or set `apiKey` for non-prod only.
`Missing apiKey for merchant verify...`	Public verify without `paymentToken`	Ensure API returns `paymentToken` and pass to `verify`.
Webhook verify always false	Using parsed JSON vs raw bytes	Use `express.raw` / equivalent and verify before `express.json()`
Confirmation stuck polling	Blockchain delay / insufficient fee	Extend server-side retry windows; rely on webhooks

Run mint validate locally to catch stale MDX links after refactors. Next: Changelog