Integracja für Dla deweloperów

Dein Widżet mit einer Script-Zeile einbinden.

Kopiere den Code aus dem Panel klienta in dein globales Layout. Das Script lädt das Widżet in einem getrennten iFrame; der öffentliche Widżet-Key ordnet die gespeicherte Konfiguracja zu und ist kein geheimer API-Schlüssel.

Zacznij bezpłatnie Dom Schnellstart

Płatności wsparcia laufen als Stripe-Connect-Direktzahlungen an das verbundene Konto des Websitebetreibers.

HTML · vor </body>

<script src="https://supportthework.com/_modules/support-widget/embed.js" data-widget-key="stw_DEIN_PUBLIC_KEY" async></script>

async lazy iFrame Domainprüfung

Schnellstart

Vom Panel zum sichtbaren Widżet.

Für die Auslieferung müssen Widżet-Key, aktiver Status und aufrufender Host zur gespeicherten Konfiguracja passen.

Widżet speichern

Lege Treśće, Kwoty und Wygląd im Panel klienta fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Zatwierdź domenę

Trage den Host ein, auf dem das Widżet geladen werden darf. Der getrennte DNS-TXT-Nachweis bestätigt, dass du die Domain kontrollierst.

Script einfügen

Setze den generierten Code einmal vor den schließenden </body>-Tag deines globalen Layouts.

Auf dem echten Host testen

Rufe die Seite über die freigegebene Domain auf. Direkte Widżet-Wyświetlenia ohne Referer oder Origin werden abgewiesen.

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

Für die Auslieferung prüft WsparcieTheWork den Widżet-Key, den aktiven Status und den freigegebenen Host. Der persönliche DNS-TXT-Eintrag dient als separater Eigentumsnachweis; ein echter Widżet-Aufruf bestätigt anschließend die Installation.

1
Nur den Host eintragenDom Beispiel twojastrona.pl, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.twojastrona.pl.
3
Nachweis und Sprawdź instalacjęBeide Dostände werden im Panel klienta getrennt angezeigt.

Auslieferung

Wczytywanie, wenn …

der öffentliche Key gültig ist,
das Widżet den Status „Aktywny“ hat,
der aufrufende Host für das Widżet freigegeben ist und
Referer oder Origin zu diesem Host passt.

Wichtig

Mehrstufige Prüfung

01Fehlender Referer oder Origin führt zur Ablehnung.
02Eine nicht freigegebene Subdomain wird nicht übernommen.
03Der DNS-Nachweis ersetzt nicht die getrennte Installationsprüfung.

Was das Embed ausführt

Osadzanie und Checkout mit klar getrennten Aufgaben.

Das Script lädt und steuert das iFrame. Nach der Bestätigung im Widżet fordert es eine Checkout-URL an und leitet den Browser zu Stripe weiter. Karten- und Płatnośćsdaten werden ausschließlich im Stripe Checkout eingegeben und nicht an das Embed übermittelt.

01 · Script

Prüft das Key-Format

data-widget-key muss 16 bis 64 Zeichen aus Buchstaben, Zahlen, Unterstrich oder Bindestrich enthalten. Erst danach wird das iFrame angelegt.

02 · iFrame

Lädt das öffentliche Widżet

Das Cel ist /support-widget/<PUBLIC_KEY>. Das iFrame lädt lazy und nutzt eine Sandbox für Scripts und Same-Origin.

03 · Server

Begrenzt die Osadzanie

Domainprüfung und eine passende frame-ancestors-Richtlinie beschränken die erlaubten Osadzaniesseiten.

04 · Interaktion

Steuert Größe und Weiterleitung

Geprüfte Wiadomośćen vom iFrame steuern Größe und Pozycja. Beim Bezahlen fordert das Script die Checkout-URL an und leitet ausschließlich zu checkout.stripe.com weiter.

Debug-Lista kontrolna

Wenn das Widżet nicht erscheint.

Prüfe zuerst Script, Key, Stan widżetu und Host. Die öffentlichen Odpowiedźen unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

embed.js wird mit Status 200 geladen.
Der Code enthält den unveränderten Key aus dem Panel.
Der aktuelle Host ist beim aktiven Widżet freigegeben.
Eine eigene CSP erlaubt Script und Frame von https://supportthework.com.
Das Embed steht nur einmal im Layout; gleiche Keys werden ohnehin nicht doppelt gemountet.

Typische Signale

Konsole und Netzwerk

WARNdata-widget-key fehlt oder hat ein ungültiges Format.
404Der Key ist unbekannt oder das Widżet ist nicht aktiv.
403Referer/Origin fehlt oder der Host ist nicht freigegeben.
503Die Widżet-Konfiguracja ist vorübergehend nicht verfügbar.

WordPress

Als Plugin installieren statt Code einzufügen.

Das WsparcieTheWork-Plugin verbindet deine WordPress-Seite über den öffentlichen Widżet-Key. Es kann das Widżet global oder gezielt per [supportthework]-Shortcode laden.

Plugin als ZIP laden Widżet-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Widżet-Key hinterlegenUnter Ustawienia → WsparcieTheWork den öffentlichen Key eintragen.
3
Integracja wybierzGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & webhooki

Projekt- und Płatnośćsdaten sicher weiterverarbeiten.

Pro-Kunden können im Integrationsbereich schreibgeschützte Klucze API und signierte Webhooks für einzelne Widżety anlegen. Geheimnisse werden nur einmal angezeigt.

Widżety abrufen

GET /api/v1/widgets liefert ausschließlich Widżety des zugehörigen Kontos oder des gewählten Widżet-Zakress.

Płatności abrufen

GET /api/v1/payments stellt die eigenen Płatności wsparcia schreibgeschützt bereit.

Ereignisse empfangen

Płatnośćsstatus werden per HTTPS zugestellt und mit HMAC-SHA256 über Zeitstempel und unveränderten JSON-Body signiert.

Dostellung prüfen

Delivery Logs, Testzustellungen und manuelle Wiederholungen sind direkt im Panel klienta verfügbar.

Płatnośćsfluss

Stripe Connect

Die Unterstützung wird über das verbundene Stripe-Konto verarbeitet.

Der Checkout wird für das verbundene Stripe-Konto des Websitebetreibers erstellt. WsparcieTheWork stellt Widżet, Konfiguracja und technische Anbindung bereit, verwahrt oder verteilt die Unterstützungsbeträge aber nicht zentral.

Płatnośćsfluss ansehen Technische Frage stellen