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

Voir le code sur GitHub →

Deux modes d'intégration

Le même code de plugin supporte les deux modes. Démarre en mode OAuth2 aujourd'hui ; ajoute le pont plus tard via une config — sans migration de données.

Mode OAuth2

prévu

Fidélité centralisée dans ta DB, synchronisée avec Deakee via OAuth2. Pas de chaîne, pas d'exchange — mais les clients voient les soldes dans Deakee et tu peux accepter les vouchers Deakee.

Fonctionne sur le backend actuel deakee.com/api/oauth/*.
Pas de tokens, pas d'exposition légale en tant qu'émetteur.
Passage au mode pont via un changement de config.

Mode pont

prévu

Déploie un contrat ERC-8063 ; les clients peuvent transformer leur solde centralisé en tokens on-chain et trader sur l'exchange Deakee.

Ajoute le listing en exchange et l'utilisation entre marques.
Requiert le relais Deakee (pas encore livré).
Même code que le mode OAuth2 — active-le quand prêt.

Installer

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.

Exemple

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);

Comment Deakee se connecte à ton plugin

Ta clé API partenaire authentifie les appels au relais Deakee. Les URLs OAuth2 authorize/token sont utilisées une fois par client pour récupérer l'adresse du wallet (scope : identity uniquement).

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`

Vérifier la conformité

Avant la mise en production, exécute le vérificateur de conformité officiel. Il vérifie le ledger centralisé, le flux OAuth d'identité, le câblage mint/burn du pont, et l'idempotence.

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

Bloqué ? Lis le README complet ou ouvre une issue à github.com/deakee/loyalty/issues.