Embedded integration settings

Choose templates for presentation assets, resource settings for configuration, and reCAPTCHA settings for its enablement/public key. These guest-readable calls do not require a member token. Resource context explains how the resource key selects the integration.

Embedded resource context

Use the API base and resource public key supplied for the embedded integration. These operations permit guest access without a member token. Shared context checks still apply where enabled; the request and recovery sections preserve each operation’s missing-resource behavior and error envelope.

Settings and template assets are data, not proof that a provider is available or a script has run. Follow the sample conventions.

Operations

curl "${WALLKIT_API_BASE}/api/v1/integrations/templates/reader-popup?v=1" \
  -H "resource: ${RESOURCE_KEY}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/integrations/templates/reader-popup", process.env.WALLKIT_API_BASE);
  url.searchParams.set("v", "1");
  const headers = { resource: process.env.RESOURCE_KEY };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/integrations/templates/reader-popup")
url += "?" + urlencode({'v': '1'})
headers = {"resource": os.environ["RESOURCE_KEY"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "name": "Reader popup",
  "title": "Subscribe",
  "slug": "reader-popup",
  "template": "PHA+SGVsbG88L3A+",
  "javascript": "",
  "css": "",
  "settings": {}
}

{
  "error": "template_not_found",
  "error_description": "Template not found"
}

curl "${WALLKIT_API_BASE}/api/v1/integrations/resource-settings" \
  -H "resource: ${RESOURCE_KEY}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/integrations/resource-settings", process.env.WALLKIT_API_BASE);
  const headers = { resource: process.env.RESOURCE_KEY };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/integrations/resource-settings")
headers = {"resource": os.environ["RESOURCE_KEY"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "single_subscription": true,
  "default_subscription_id": null,
  "default_guest_subscription_id": null,
  "default_paysystem": "stripe",
  "logo": "https://example.com/logo.png"
}

[]

curl "${WALLKIT_API_BASE}/api/v1/integrations/resource/recaptcha-settings" \
  -H "resource: ${RESOURCE_KEY}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/integrations/resource/recaptcha-settings", process.env.WALLKIT_API_BASE);
  const headers = { resource: process.env.RESOURCE_KEY };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/integrations/resource/recaptcha-settings")
headers = {"resource": os.environ["RESOURCE_KEY"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "active": false,
  "recaptcha_public_key": "EXAMPLE_RECAPTCHA_PUBLIC_KEY"
}

{
  "active": false,
  "recaptcha_public_key": null
}