Integreerimine für Arendajatele

Dein Vidin mit einer Script-Zeile einbinden.

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

Alusta tasuta Kunim Schnellstart

Toetusmaksed 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 Juhtpaneel zum sichtbaren Vidin.

Für die Auslieferung müssen Vidin-Key, aktiver Olek und aufrufender Host zur gespeicherten Seadistamine passen.

Vidin speichern

Lege Sisue, Summad und Välimus im Kliendiala fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Luba domeen

Trage den Host ein, auf dem das Vidin 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 Vidin-Vaatamised ohne Referer oder Origin werden abgewiesen.

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

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

1
Nur den Host eintragenKunim Beispiel sinuveebisait.ee, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.sinuveebisait.ee.
3
Nachweis und Kontrolli installimistBeide Kunistände werden im Kliendiala getrennt angezeigt.

Auslieferung

Laaditakse, wenn …

der öffentliche Key gültig ist,
das Vidin den Olek „Aktiivne“ hat,
der aufrufende Host für das Vidin 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

Manustamine und Checkout mit klar getrennten Aufgaben.

Das Script lädt und steuert das iFrame. Nach der Bestätigung im Vidin fordert es eine Checkout-URL an und leitet den Browser zu Stripe weiter. Karten- und Maksesdaten 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 Vidin

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

03 · Server

Begrenzt die Manustamine

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

04 · Interaktion

Steuert Größe und Weiterleitung

Geprüfte Sõnumen vom iFrame steuern Größe und Asukoht. Beim Bezahlen fordert das Script die Checkout-URL an und leitet ausschließlich zu checkout.stripe.com weiter.

Debug-Kontrollnimekiri

Wenn das Vidin nicht erscheint.

Prüfe zuerst Script, Key, Vidina olek und Host. Die öffentlichen Vastusen unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

embed.js wird mit Olek 200 geladen.
Der Code enthält den unveränderten Key aus dem Juhtpaneel.
Der aktuelle Host ist beim aktiven Vidin 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 Vidin ist nicht aktiv.
403Referer/Origin fehlt oder der Host ist nicht freigegeben.
503Die Vidin-Seadistamine ist vorübergehend nicht verfügbar.

WordPress

Als Plugin installieren statt Code einzufügen.

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

Plugin als ZIP laden Vidin-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Vidin-Key hinterlegenUnter Seaded → TugiTheWork den öffentlichen Key eintragen.
3
Integreerimine valiGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & Webhookid

Projekt- und Maksesdaten sicher weiterverarbeiten.

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

Vidinad abrufen

GET /api/v1/widgets liefert ausschließlich Vidinad des zugehörigen Kontos oder des gewählten Vidin-Õiguste ulatuss.

Maksed abrufen

GET /api/v1/payments stellt die eigenen Toetusmaksed schreibgeschützt bereit.

Ereignisse empfangen

Maksesstatus werden per HTTPS zugestellt und mit HMAC-SHA256 über Zeitstempel und unveränderten JSON-Body signiert.

Kunistellung prüfen

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

Maksesfluss

Stripe Connect

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

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

Maksesfluss ansehen Technische Frage stellen