Ενσωμάτωση für Προγραμματιστές

Dein Widget mit einer Script-Zeile einbinden.

Kopiere den Code aus dem Περιοχή πελατών in dein globales Layout. Das Script lädt das Widget in einem getrennten iFrame; der öffentliche Widget-Key ordnet die gespeicherte Διαμόρφωση zu und ist kein geheimer API-Schlüssel.

Ξεκίνησε δωρεάν Έωςm Schnellstart

Πληρωμές υποστήριξης laufen als Stripe-Connect-Direktzahlungen an das verbundene Λογαριασμός 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 Πίνακας ελέγχου zum sichtbaren Widget.

Für die Auslieferung müssen Widget-Key, aktiver Κατάσταση und aufrufender Host zur gespeicherten Διαμόρφωση passen.

Widget speichern

Lege Περιεχόμενοe, Ποσά und Εμφάνιση im Περιοχή πελατών fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Ενέκρινε το domain

Trage den Host ein, auf dem das Widget 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 Widget-Προβολές ohne Referer oder Origin werden abgewiesen.

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

Für die Auslieferung prüft ΥποστήριξηTheWork den Widget-Key, den aktiven Κατάσταση und den freigegebenen Host. Der persönliche DNS-TXT-Eintrag dient als separater Eigentumsnachweis; ein echter Widget-Aufruf bestätigt anschließend die Installation.

1
Nur den Host eintragenΈωςm Beispiel istoselidasou.gr, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.istoselidasou.gr.
3
Nachweis und Έλεγχος εγκατάστασηςBeide Έωςstände werden im Περιοχή πελατών getrennt angezeigt.

Auslieferung

Φόρτωση, wenn …

der öffentliche Key gültig ist,
das Widget den Κατάσταση „Ενεργό“ hat,
der aufrufende Host für das Widget 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

Ενσωμάτωση und Checkout mit klar getrennten Aufgaben.

Das Script lädt und steuert das iFrame. Nach der Bestätigung im Widget fordert es eine Checkout-URL an und leitet den Browser zu Stripe weiter. Karten- und Πληρωμή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 Widget

Das Προορισμός ist /support-widget/<PUBLIC_KEY>. Das iFrame lädt lazy und nutzt eine Sandbox für Scripts und Same-Origin.

03 · Server

Begrenzt die Ενσωμάτωση

Domainprüfung und eine passende frame-ancestors-Richtlinie beschränken die erlaubten Ενσωμάτωσηsseiten.

04 · Interaktion

Steuert Größe und Weiterleitung

Geprüfte Μήνυμαen vom iFrame steuern Größe und Θέση. Beim Bezahlen fordert das Script die Checkout-URL an und leitet ausschließlich zu checkout.stripe.com weiter.

Debug-Λίστα ελέγχου

Wenn das Widget nicht erscheint.

Prüfe zuerst Script, Key, Κατάσταση widget und Host. Die öffentlichen Απάντησηen unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

embed.js wird mit Κατάσταση 200 geladen.
Der Code enthält den unveränderten Key aus dem Πίνακας ελέγχου.
Der aktuelle Host ist beim aktiven Widget 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 Widget ist nicht aktiv.
403Referer/Origin fehlt oder der Host ist nicht freigegeben.
503Die Widget-Διαμόρφωση ist vorübergehend nicht verfügbar.

WordPress

Als Plugin installieren statt Code einzufügen.

Das ΥποστήριξηTheWork-Plugin verbindet deine WordPress-Seite über den öffentlichen Widget-Key. Es kann das Widget global oder gezielt per [supportthework]-Shortcode laden.

Plugin als ZIP laden Widget-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Widget-Key hinterlegenUnter Ρυθμίσεις → ΥποστήριξηTheWork den öffentlichen Key eintragen.
3
Ενσωμάτωση επίλεξεGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & webhooks

Projekt- und Πληρωμήsdaten sicher weiterverarbeiten.

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

Widget abrufen

GET /api/v1/widgets liefert ausschließlich Widget des zugehörigen Λογαριασμόςs oder des gewählten Widget-Scopes.

Πληρωμές abrufen

GET /api/v1/payments stellt die eigenen Πληρωμές υποστήριξης schreibgeschützt bereit.

Ereignisse empfangen

Πληρωμήsstatus werden per HTTPS zugestellt und mit HMAC-SHA256 über Zeitstempel und unveränderten JSON-Body signiert.

Έωςstellung prüfen

Delivery Logs, Testzustellungen und manuelle Wiederholungen sind direkt im Περιοχή πελατών verfügbar.

Πληρωμήsfluss

Stripe Connect

Die Unterstützung wird über das verbundene Stripe-Λογαριασμός verarbeitet.

Der Checkout wird für das verbundene Stripe-Λογαριασμός des Websitebetreibers erstellt. ΥποστήριξηTheWork stellt Widget, Διαμόρφωση und technische Anbindung bereit, verwahrt oder verteilt die Unterstützungsbeträge aber nicht zentral.

Πληρωμήsfluss ansehen Technische Frage stellen