Reference
Errors
When the service refuses to open the viewer, the viewer shows a notice with the refusal code in place of the item, and tells your page the family and the code of the refusal.
Where refusals show
Visitors see a short notice in place of the item, in the language of lang (locale with the SDK), English by default. It shows the refusal code, such as VSKIN-K2, with a link to its entry on this page. Your code gets the family and the code: the SDK rejects with them (family, refusalCode), and an iframe posts them in a refused message. refusalCode is the code without its prefix, K2.
Setupsetup
The integration is not finished. Only you can fix it.
VSKIN-K1VSKIN-C1The viewer address was opened directly, outside an iframe.
Embed it in an iframe on a declared domain, or on your own machine with your test key.
Access cut offcut_off
Your key cannot open the viewer here. Visitors only read that the viewer is off; each code below gives its fix.
VSKIN-K2The key does not exist.
Check that it was copied in full, or copy it again from your dashboard.
VSKIN-K3The key no longer exists.
Put one of your active keys on your page: they are listed in your dashboard.
VSKIN-K4The key has passed its end date.
Use a key from your dashboard, or contact us on Discord or at contact@vskin.gg.
VSKIN-T1Your account was disabled by us.
Contact us on Discord or at contact@vskin.gg to find out why.
VSKIN-T2No domain is declared on your account, so your production keys work only in the builder.
Declare the domains you embed on, in your dashboard.
VSKIN-T3VSKIN-P1Your plan does not include this integration.
Use an integration your plan includes, or change plans on Pricing.
VSKIN-C2The page embedding the viewer is on a domain this key does not allow: one you did not declare; with your test key, any domain but your own machine; with a sandbox key, any page outside the builder.
Declare that domain in your dashboard, and embed with one of your production keys. On your own machine, use your test key: it works only on localhost and 127.0.0.1. Sandbox keys work only in the builder: copy the line from the builder with one of your keys. If your page sends Referrer-Policy: no-referrer, let it send at least the origin, as the default policy does.
VSKIN-Q1Your plan's renders for this billing period are used up, extra blocks included.
If your spending cap is below your plan's maximum, raise it in your dashboard: the viewer comes back within a minute. Otherwise, move to a plan without a render limit on Pricing, or wait for the next billing period, when renders resume.
VSKIN-Q2Your test key's renders for this month are used up. They are counted apart from your production renders.
Your test key works again when its next month starts, as your dashboard shows. Previews in the builder never count.
Outageoutage
The problem is on our side: contact us on Discord or at contact@vskin.gg.
VSKIN-S1Our service could not serve the viewer.
Try again in a moment. If it lasts, contact us on Discord or at contact@vskin.gg.
VSKIN-S2Our service could not open the viewer.
Contact us on Discord or at contact@vskin.gg.
Item not rendered
An item that cannot be rendered is not a refusal: the viewer says so in place of the item, and no view message follows. The SDK emits unavailable.