Comhtháthú für Forbróirí

Dein Giuirléid mit einer Script-Zeile einbinden.

Kopiere den Code aus dem Limistéar custaiméara in dein globales Layout. Das Script lädt das Giuirléid in einem getrennten iFrame; der öffentliche Giuirléid-Key ordnet die gespeicherte Cumraíocht zu und ist kein geheimer API-Schlüssel.

Tosaigh saor in aisce Chuigm Schnellstart

Íocaíochtaí tacaíochta laufen als Stripe-Connect-Direktzahlungen an das verbundene Cuntas 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 Deais zum sichtbaren Giuirléid.

Für die Auslieferung müssen Giuirléid-Key, aktiver Stádas und aufrufender Host zur gespeicherten Cumraíocht passen.

Giuirléid speichern

Lege Ábhare, Méideanna und Taispeáint im Limistéar custaiméara fest. Der öffentliche Key wird nach dem Speichern erzeugt.

Faomh d’fhearann

Trage den Host ein, auf dem das Giuirléid 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 Giuirléid-Amhairc ohne Referer oder Origin werden abgewiesen.

Domain-Nachweis

Domainfreigabe, Eigentumsnachweis und Installation werden getrennt geprüft.

Für die Auslieferung prüft TacaíochtTheWork den Giuirléid-Key, den aktiven Stádas und den freigegebenen Host. Der persönliche DNS-TXT-Eintrag dient als separater Eigentumsnachweis; ein echter Giuirléid-Aufruf bestätigt anschließend die Installation.

1
Nur den Host eintragenChuigm Beispiel dosuiomh.ie, ohne Pfad.
2
DNS-TXT-Eintrag setzenVeröffentliche den persönlichen Wert unter _supportthework.dosuiomh.ie.
3
Nachweis und Seiceáil an tsuiteáilBeide Chuigstände werden im Limistéar custaiméara getrennt angezeigt.

Auslieferung

Á lódáil, wenn …

der öffentliche Key gültig ist,
das Giuirléid den Stádas „Gníomhach“ hat,
der aufrufende Host für das Giuirléid 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

Leabú und Checkout mit klar getrennten Aufgaben.

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

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

03 · Server

Begrenzt die Leabú

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

04 · Interaktion

Steuert Größe und Weiterleitung

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

Debug-Seicliosta

Wenn das Giuirléid nicht erscheint.

Prüfe zuerst Script, Key, Stádas na giuirléide und Host. Die öffentlichen Freagraen unterscheiden die wichtigsten Fehlerfälle.

Im Browser prüfen

Einbau und Richtlinien

embed.js wird mit Stádas 200 geladen.
Der Code enthält den unveränderten Key aus dem Deais.
Der aktuelle Host ist beim aktiven Giuirléid 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 Giuirléid ist nicht aktiv.
403Referer/Origin fehlt oder der Host ist nicht freigegeben.
503Die Giuirléid-Cumraíocht ist vorübergehend nicht verfügbar.

WordPress

Als Plugin installieren statt Code einzufügen.

Das TacaíochtTheWork-Plugin verbindet deine WordPress-Seite über den öffentlichen Giuirléid-Key. Es kann das Giuirléid global oder gezielt per [supportthework]-Shortcode laden.

Plugin als ZIP laden Giuirléid-Key erstellen

1
ZIP installierenIn WordPress unter Plugins → Installieren → Plugin hochladen.
2
Giuirléid-Key hinterlegenUnter Socruithe → TacaíochtTheWork den öffentlichen Key eintragen.
3
Comhtháthú roghnaighGlobal aktivieren oder den Shortcode auf ausgewählten Seiten verwenden.

API & Webhooks

Projekt- und Íocaíochtsdaten sicher weiterverarbeiten.

Pro-Kunden können im Integrationsbereich schreibgeschützte Eochracha API und signierte Webhooks für einzelne Giuirléidí anlegen. Geheimnisse werden nur einmal angezeigt.

Giuirléidí abrufen

GET /api/v1/widgets liefert ausschließlich Giuirléidí des zugehörigen Cuntass oder des gewählten Giuirléid-Scóips.

Íocaíochtaí abrufen

GET /api/v1/payments stellt die eigenen Íocaíochtaí tacaíochta schreibgeschützt bereit.

Ereignisse empfangen

Íocaíochtsstatus werden per HTTPS zugestellt und mit HMAC-SHA256 über Zeitstempel und unveränderten JSON-Body signiert.

Chuigstellung prüfen

Delivery Logs, Testzustellungen und manuelle Wiederholungen sind direkt im Limistéar custaiméara verfügbar.

Íocaíochtsfluss

Stripe Connect

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

Der Checkout wird für das verbundene Stripe-Cuntas des Websitebetreibers erstellt. TacaíochtTheWork stellt Giuirléid, Cumraíocht und technische Anbindung bereit, verwahrt oder verteilt die Unterstützungsbeträge aber nicht zentral.

Íocaíochtsfluss ansehen Technische Frage stellen