Tier 2 — Full Deakee partner

Shopify

Shopify App Store

Hosted Shopify app. Install from the App Store; earn fires on `orders/paid` webhooks and updates a centralized balance in the app's DB. Customers see a "Connect Deakee" widget in the storefront and can move points on-chain whenever they want to trade or redeem cross-brand.

App marketplace

Shopify App Store: Deakee Loyalty

Quellcode auf GitHub anzeigen →

Zwei Integrationsmodi

Derselbe Plugin-Code unterstützt beide Modi. Starte heute im OAuth2-Modus; ergänze die Brücke später per Config-Flip — keine Datenmigration.

OAuth2-Modus

geplant

Zentralisierte Loyalty in deiner DB, mit Deakee via OAuth2 synchronisiert. Keine Chain, keine Exchange — aber Kunden sehen Salden in Deakee und du kannst Deakee-Voucher akzeptieren.

Funktioniert mit dem aktuellen deakee.com/api/oauth/* Backend.
Keine Token, keine rechtliche Belastung als Emittent.
Upgrade auf Brückenmodus per Config-Flip.

Brückenmodus

geplant

Stelle einen ERC-8063-Vertrag bereit; Kunden können zentralisiertes Guthaben in On-Chain-Token verwandeln und auf der Deakee-Exchange handeln.

Bringt Exchange-Listing und Cross-Brand-Einlösung.
Benötigt den Deakee-Relayer (noch nicht live).
Gleicher Plugin-Code wie OAuth2-Modus — aktivierbar wenn bereit.

Installieren

Install Deakee Loyalty from the Shopify App Store.
Approve scopes (read_orders, read_customers, write_customer_metafields).
Configure earn rate + paste your Deakee partner API key.
Click "Deploy My Token" to spin up your ERC-8063 contract.
Done — points flow centrally; customers can bridge via the customer-account block.

Wie Deakee sich mit deinem Plugin verbindet

Dein Partner-API-Key authentifiziert Aufrufe an den Deakee-Relayer. Die OAuth2-authorize/token-URLs werden einmal pro Kunde verwendet, um die Wallet-Adresse zu holen (Scope: nur identity).

authorize_url	`https://deakee.com/oauth2/authorize (scope=identity)`
token_url	`https://deakee.com/oauth2/token`
api_base_url	`https://deakee.com/api/relayer/v1`

Konformität prüfen

Vor dem Livegang den offiziellen Konformitäts-Verifier ausführen. Prüft das zentralisierte Ledger, den Identity-OAuth-Flow, das Mint/Burn-Wiring der Brücke und Idempotenz.

npx @deakee/loyalty-verifier \
  --partner-api-key   <your key> \
  --plugin-url        <your plugin URL> \
  --contract-address  <your ERC-8063 contract> \
  --test-user-email   test@example.com

Festgefahren? Lies die vollständige README oder öffne ein Issue unter github.com/deakee/loyalty/issues.