SocialHub.AI
Ressourcen · Entwicklerzentrum

Shopify, Amazon & TikTok Shop

Verbinden Sie Ihre E-Commerce-Kanäle, damit Online-Bestellungen Treuepunkte sammeln. Shopify synchronisiert Produkte und vergibt automatisch Punkte für Bestellungen. Amazon und TikTok Shop ermöglichen es Mitgliedern, Punkte für Bestellungen zu sammeln, die wir mit dem Marktplatz abgleichen – niemals mit der Aussage des Käufers. Sie können alle drei in der App unter Einstellungen → Online-Shop konfigurieren.

Drei Kanäle, ein Ort

Alle drei sind auf der Seite Einstellungen → Online-Shop als einzelne Registerkarte zu finden. Shopify ist eine vollständige Synchronisierung (Produkte + automatische Bestellpunkte). Amazon und TikTok Shop sind verifizierte Bestellkanäle: Ein Mitglied meldet seine Bestellung number selbst im Portal, und die Plattform ruft die offizielle Bestellung vom vom Verkäufer autorisierten API ab, bevor Punkte vergeben werden. Personenbezogene Daten des Käufers werden niemals gespeichert.

Online-Shop

Shopify

Verbinden Sie Ihren Shopify-Shop, um Produktdaten in Ihre Kampagnen einzubinden und abgeschlossene Bestellungen in Treuepunkte umzuwandeln – ganz ohne Code, nur mit einer Shop-Domain und einem Admin-API-Zugriffstoken.

1 · Erstellen Sie ein Administrator-Zugriffstoken API in Shopify

Gehen Sie in Ihrem Shopify-Adminbereich zu Einstellungen → Apps und Vertriebskanäle → Apps entwickeln → erstellen Sie eine App, erteilen Sie ihr die Berechtigungen read_products und read_orders (fügen Sie Schreibberechtigungen nur bei Bedarf hinzu) und installieren Sie sie, um das Admin-Zugriffstoken API (shpat_…) anzuzeigen.

2 · Verbinden Sie den Shop mit SocialHub

In der App: Einstellungen → Onlineshop → Tab „Onlineshop“. Geben Sie Ihre Shop-Domain (my-store.myshopify.com) und das Admin-Zugriffstoken API ein. Das Token wird vor dem Speichern mit Ihrem Shop abgeglichen und im Ruhezustand verschlüsselt (AES-256-GCM) – es wird weder protokolliert noch angezeigt.

3 · Synchronisieren & verdienen

Klicken Sie auf „Jetzt synchronisieren“, um Ihren Produktkatalog für Kampagnen abzurufen. Ab sofort werden für abgeschlossene Bestellungen automatisch Treuepunkte gutgeschrieben (nach der gleichen Formel wie für Belege), und Erst-/Wiederholungskäufe lösen die Automatisierungsereignisse nach dem Kauf aus.

// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect      { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET  /api/shopify/status       // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync         // pull products now
POST /api/shopify/disconnect   // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.
Marktplatz

Amazon

Ermöglichen Sie Mitgliedern, Punkte für ihre verifizierten Amazon-Bestellungen zu sammeln. Sie autorisieren eine Amazon SP-API-App (Anmeldung mit Amazon) in Ihrem Seller Central-Konto; die Plattform verwendet diese Anmeldeinformationen, um jede selbst gemeldete Bestellung abzurufen und nur dann Punkte zu vergeben, wenn die Bestellung tatsächlich vorliegt. Richten Sie es unter Einstellungen → Online-Shop → Amazon ein (Team- und Systemadministratoren).

Verbindungseinstellungen

Verbindungsname
Eine Bezeichnung für diesen Anschluss, z.B. „Amazon US – BrandX“. Mehrfachverkäufer? Verwenden Sie für jede Verbindung einen eindeutigen Namen.
Region
AWS-Region des SP-API-Endpunkts, z. B. us-east-1.
Endpunkt
dem SP-API-Host für Ihre Region, z. B. https://sellingpartnerapi-na.amazon.com.
Marktplatz-IDs
Kommagetrennt, z. B. ATVPDKIKX0DER (Amazon US).
Verkäufer-ID
Optional – Ihre Vertriebspartner-/Händler-ID.

Geheimnisse (verschlüsselt im Ruhezustand · schreibgeschützt)

LWA-Aktualisierungstoken
Atzr|… – durch die Autorisierung Ihrer SP-API-App in Seller Central.
LWA-Client-ID
amzn1.application-oa2-client… — Client-ID Ihrer SP-API-App.
LWA-Client-Geheimnis
Der Client-Schlüssel Ihrer SP-API-App.

Save & Verify führt eine Live-Aktivitätsprüfung für SP-API durch und listet die Marktplätze auf, die es sehen kann. Das LWA-Aktualisierungstoken rotiert nicht – überprüfen Sie es jederzeit erneut von der Verbindungszeile aus.

Marktplatz

TikTok Shop

Gleiches „Verifizieren-nicht-vertrauen“-Modell wie bei Amazon, gegen den TikTok-Shop-Partner API. Sie autorisieren eine TikTok-Shop-Partner-App in Ihrem Shop, einen App-Schlüssel/App-Geheimnis und ein Aktualisierungstoken zu erhalten. Richten Sie es unter Einstellungen → Online-Shop → TikTok-Shop ein (Teamadministratoren und Systemadministratoren).

Verbindungseinstellungen

Verbindungsname
Eine Bezeichnung für diese Verbindung, z. B. „TikTok US - Marke X“.
Region
Shop-Region, z.B. uns.
Kaufen Sie Cipher
Optional – leer lassen; Save & Verify entdeckt es in Ihrem autorisierten Shop.

Geheimnisse (verschlüsselt im Ruhezustand · schreibgeschützt)

App-Schlüssel
Ihr TikTok Shop Partner App-Schlüssel.
App-Geheimnis
Das Geheimnis Ihrer TikTok Shop Partner App
Aktualisierungstoken
ROW_… – von der Autorisierung der App in Ihrem Shop. TikTok wechselt dies bei jeder Aktualisierung; Die Plattform behält die Rotation für Sie bei.

Lassen Sie das Feld „Shop-Verschlüsselung“ leer – „Speichern & Verifizieren“ ermittelt es automatisch von Ihrem autorisierten Shop. TikTok ändert das Aktualisierungstoken bei jeder Aktualisierung; die Plattform serialisiert und speichert die Rotation, sodass sich gleichzeitig laufende Prozesse nicht gegenseitig beeinträchtigen.

// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels            { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping  // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.

Wie Anmeldeinformationen sicher aufbewahrt werden

Im Ruhezustand verschlüsselt

Jedes Geheimnis (Zugriffstoken, Aktualisierungstoken, Client-/App-Geheimnis) wird sofort nach dem Empfang mit AES-GCM verschlüsselt. Geheimnisse sind schreibgeschützt – sie werden niemals an den Browser zurückgesendet und niemals in Protokolle oder E-Mails geschrieben.

Mandantenisoliert

Kanalzugangsdaten sind an ein Team gebunden. Teamadministratoren (org_owner / org_admin) und Systemadministratoren verwalten diese und können ausschließlich die Verbindungen ihres eigenen Teams lesen und bearbeiten.

Prüfen statt vertrauen.

Für Amazon & TikTok Shop werden Punkte nur für Bestellungen gutgeschrieben, die die Plattform beim autorisierten Verkäufer API abgerufen hat. Die personenbezogenen Daten des Käufers werden abgeglichen und dann verworfen und nie im Bestelldatensatz gespeichert.

Idempotentes Einkommen

Shopify Bestell-Webhooks und Marktplatz-Bestellnummern werden anhand der Bestell-ID identifiziert, sodass Wiederholungen oder doppelte Einreichungen niemals doppelte Punkte vergeben.

Verwandte Bereiche: REST API · POS · OMS · ERP · Mitgliederportal Einbetten

Anbindung eines Vertriebskanals?

Sprechen Sie mit einem unserer Entwickler über Shopify-Bereiche, SP-API-Autorisierung, TikTok Shop Partner-Apps oder die Funktionsweise von Punkten für verifizierte Bestellungen.

Sprechen Sie mit der Technik