Skip to main content
If you followed the sections in order—from Introduction through the Express webhook guide—this matrix is still the quickest way back to green.
SymptomLikely causeFix
useUnseenConfig must be used inside UnseenProviderHook outside wrapperWrap in <UnseenProvider>.
UnseenProvider apiKey is required ...Browser tries to create payment without keyPass createPaymentSession or set apiKey for non-prod only.
Missing apiKey for merchant verify...Public verify without paymentTokenEnsure API returns paymentToken and pass to verify.
Webhook verify always falseUsing parsed JSON vs raw bytesUse express.raw / equivalent and verify before express.json()
Confirmation stuck pollingBlockchain delay / insufficient feeExtend server-side retry windows; rely on webhooks
Run mint validate locally to catch stale MDX links after refactors. Next: Changelog