Troubleshooting

Quick reference

Status	Message	Fix
401	Token has expired	Re-run OTP verification to get a fresh token. Never cache tokens across sessions.
403	Origin not allowed	Add your domain or bundle ID to Settings → API Settings → Allowed Domains.
403	Not authorized	The bearer token was issued for a different userId than the one in the path. Fetch a fresh token.
404	Banner or collection point not found	Verify assetId, bannerId, and X-Org-Id. Re-run the asset and collection point fetch steps.
409	All consents already completed	Consent links are single-use. Issue a new link if the user needs to re-consent.
429	Too many requests	Respect the Retry-After header before retrying. Contact support for a raised limit.
503	OTP delivery failed	Transient MSG91 failure. Retry with exponential backoff.

Banner not loading

1. Check the browser console for network errors on the banner fetch (/api/v1/internal/banners/…).
2. Confirm assetId and bannerId are not swapped — bannerId is the collection point display_id.
3. Confirm the SDK base URL points to https://trukit-dev.truconsent.io, not the management API URL.

Consent not recording

1. Confirm X-Org-Id is set — this routes the request to your tenant schema.
2. Confirm X-API-Key uses the consent-scope key, not the admin key.
3. Confirm collectionPointId in the request path matches a collection point in your dashboard.

OTP not delivered

1. Phone number must be E.164 format: +919876543210.
2. Check MSG91 delivery reports under Settings → Notifications in the dashboard.

Still stuck?

Open a support ticket from the platform dashboard or email support with your X-Org-Id, the full request (minus API key), and the response body.

← Changelog