Tier 2 — Full Deakee partner

Laravel

Laravel 10+ (any e-commerce layer)

For Laravel apps with their own checkout (Bagisto, Aimeos, custom). Publishes migrations for `deakee_loyalty_members` + `deakee_loyalty_transactions`, exposes a `DeakeeLoyalty` facade, fires `DeakeeLoyaltyEarned` + `DeakeeLoyaltyWithdrawn` events.

Composer

composer require deakee/loyalty-laravel

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

composer require deakee/loyalty-laravel
php artisan migrate
Set DEAKEE_API_KEY in .env, run php artisan deakee:deploy-token (one-time).
Call DeakeeLoyalty::credit() in your order-complete logic.
Mount the bridge routes (one line in your routes file) to expose withdraw/deposit endpoints.

Beispiel

use Deakee\Loyalty\Facades\DeakeeLoyalty;

// Centralized earn — no chain:
DeakeeLoyalty::members()->credit(
    userId: $order->user_id,
    points: DeakeeLoyalty::computePoints($order->total_cents),
    reference: "order_{$order->id}",
);

// User-initiated bridge (called from the customer's
// "Send to Deakee" form):
DeakeeLoyalty::bridge()->withdraw($user, $amount);

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.