Vdelava für Razvijalci

Dein Gradnik mit einer Script-Zeile einbinden.

Kopiere den Code aus dem Območje za stranke in dein globales Layout. Das Script lädt das Gradnik in einem getrennten iFrame; der öffentliche Gradnik-Key ordnet die gespeicherte Konfiguracija zu und ist kein geheimer API-Schlüssel.

Začni brezplačno Nam Schnellstart

Plačila podpore laufen als Stripe-Connect-Direktzahlungen an das verbundene Račun 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 Nadzorna plošča zum sichtbaren Gradnik.

Für die Auslieferung müssen Gradnik-Key, aktiver Stanje und aufrufender Host zur gespeicherten Konfiguracija passen.

Gradnik speichern

Lege Vsebinae, Zneski und Prikaz im Območje za stranke fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Odobri domeno

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

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

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

1
Nur den Host eintragenNam Beispiel tvojaspletna.si, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.tvojaspletna.si.
3
Nachweis und Preveri namestitevBeide Nastände werden im Območje za stranke getrennt angezeigt.

Auslieferung

Nalaganje, wenn …

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

Vdelava und Checkout mit klar getrennten Aufgaben.

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

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

03 · Server

Begrenzt die Vdelava

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

04 · Interaktion

Steuert Größe und Weiterleitung

Geprüfte Sporočiloen vom iFrame steuern Größe und Položaj. Beim Bezahlen fordert das Script die Checkout-URL an und leitet ausschließlich zu checkout.stripe.com weiter.

Debug-Kontrolni seznam

Wenn das Gradnik nicht erscheint.

Prüfe zuerst Script, Key, Stanje gradnika und Host. Die öffentlichen Odgovoren unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

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

WordPress

Als Plugin installieren statt Code einzufügen.

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

Plugin als ZIP laden Gradnik-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Gradnik-Key hinterlegenUnter Nastavitve → PodporaTheWork den öffentlichen Key eintragen.
3
Vdelava izberiGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & Webhooki

Projekt- und Plačilosdaten sicher weiterverarbeiten.

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

Gradniki abrufen

GET /api/v1/widgets liefert ausschließlich Gradniki des zugehörigen Računs oder des gewählten Gradnik-Obsegs.

Plačila abrufen

GET /api/v1/payments stellt die eigenen Plačila podpore schreibgeschützt bereit.

Ereignisse empfangen

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

Nastellung prüfen

Delivery Logs, Testzustellungen und manuelle Wiederholungen sind direkt im Območje za stranke verfügbar.

Plačilosfluss

Stripe Connect

Die Unterstützung wird über das verbundene Stripe-Račun verarbeitet.

Der Checkout wird für das verbundene Stripe-Račun des Websitebetreibers erstellt. PodporaTheWork stellt Gradnik, Konfiguracija und technische Anbindung bereit, verwahrt oder verteilt die Unterstützungsbeträge aber nicht zentral.

Plačilosfluss ansehen Technische Frage stellen