Skip to content
VSkin Render

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-K1

No key in the URL.

Add your key to the iframe address, or pass key to createViewer. Your keys are in your dashboard, and the builder writes the line with one of them.

VSKIN-C1

The 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-K2

The key does not exist.

Check that it was copied in full, or copy it again from your dashboard.

VSKIN-K3

The key no longer exists.

Put one of your active keys on your page: they are listed in your dashboard.

VSKIN-K4

The key has passed its end date.

Use a key from your dashboard, or contact us on Discord or at contact@vskin.gg.

VSKIN-T1

Your account was disabled by us.

Contact us on Discord or at contact@vskin.gg to find out why.

VSKIN-T2

No 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-T3

Your account has no subscription in force: it was never taken, it ended, or a payment has been failing for more than 72 hours.

Subscribe from Pricing, or settle the payment due from your dashboard: your key works again as soon as it is paid, with no change on your site.

VSKIN-P1

Your plan does not include this integration.

Use an integration your plan includes, or change plans on Pricing.

VSKIN-C2

The 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-Q1

Your 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-Q2

Your 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-S1

Our service could not serve the viewer.

Try again in a moment. If it lasts, contact us on Discord or at contact@vskin.gg.

VSKIN-S2

Our 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.