Integravimas für Programuotojams

Dein Valdiklis mit einer Script-Zeile einbinden.

Kopiere den Code aus dem Klientų sritis in dein globales Layout. Das Script lädt das Valdiklis in einem getrennten iFrame; der öffentliche Valdiklis-Key ordnet die gespeicherte Konfigūracija zu und ist kein geheimer API-Schlüssel.

Pradėti nemokamai Įm Schnellstart

Paramos mokėjimai laufen als Stripe-Connect-Direktzahlungen an das verbundene Paskyra 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 Valdymo skydelis zum sichtbaren Valdiklis.

Für die Auslieferung müssen Valdiklis-Key, aktiver Būsena und aufrufender Host zur gespeicherten Konfigūracija passen.

Valdiklis speichern

Lege Turinyse, Sumos und Išvaizda im Klientų sritis fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Leisk naudoti domeną

Trage den Host ein, auf dem das Valdiklis 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 Valdiklis-Peržiūros ohne Referer oder Origin werden abgewiesen.

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

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

1
Nur den Host eintragenĮm Beispiel tavosvetaine.lt, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.tavosvetaine.lt.
3
Nachweis und Tikrinti diegimąBeide Įstände werden im Klientų sritis getrennt angezeigt.

Auslieferung

Įkeliama, wenn …

der öffentliche Key gültig ist,
das Valdiklis den Būsena „Aktyvus“ hat,
der aufrufende Host für das Valdiklis 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

Įterpimas und Checkout mit klar getrennten Aufgaben.

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

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

03 · Server

Begrenzt die Įterpimas

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

04 · Interaktion

Steuert Größe und Weiterleitung

Geprüfte Žinutėen vom iFrame steuern Größe und Padėtis. Beim Bezahlen fordert das Script die Checkout-URL an und leitet ausschließlich zu checkout.stripe.com weiter.

Debug-Kontrolinis sąrašas

Wenn das Valdiklis nicht erscheint.

Prüfe zuerst Script, Key, Valdiklio būsena und Host. Die öffentlichen Atsakymasen unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

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

WordPress

Als Plugin installieren statt Code einzufügen.

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

Plugin als ZIP laden Valdiklis-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Valdiklis-Key hinterlegenUnter Nustatymai → PagalbaTheWork den öffentlichen Key eintragen.
3
Integravimas pasirinktiGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & Webhook

Projekt- und Mokėjimassdaten sicher weiterverarbeiten.

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

Valdikliai abrufen

GET /api/v1/widgets liefert ausschließlich Valdikliai des zugehörigen Paskyras oder des gewählten Valdiklis-Aprėptiss.

Mokėjimai abrufen

GET /api/v1/payments stellt die eigenen Paramos mokėjimai schreibgeschützt bereit.

Ereignisse empfangen

Mokėjimassstatus 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 Klientų sritis verfügbar.

Mokėjimassfluss

Stripe Connect

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

Der Checkout wird für das verbundene Stripe-Paskyra des Websitebetreibers erstellt. PagalbaTheWork stellt Valdiklis, Konfigūracija und technische Anbindung bereit, verwahrt oder verteilt die Unterstützungsbeträge aber nicht zentral.

Mokėjimassfluss ansehen Technische Frage stellen