← Todas las integraciones
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
Ver código en GitHub →

Dos modos de integración

El mismo código de plugin soporta ambos modos. Empieza en modo OAuth2 hoy; añade el puente más tarde con un cambio de config — sin migración de datos.

Modo OAuth2
planificado

Lealtad centralizada en tu DB sincronizada con Deakee via OAuth2. Sin cadena, sin exchange — pero los clientes ven saldos en Deakee y puedes aceptar vouchers Deakee.

  • Funciona contra el backend actual deakee.com/api/oauth/*.
  • Sin tokens, sin exposición legal como emisor.
  • Migra al modo puente con un cambio de config.
Modo puente
planificado

Despliega un contrato ERC-8063; los clientes pueden acuñar saldo centralizado a tokens on-chain y operar en el exchange de Deakee.

  • Añade listado en exchange y canje entre marcas.
  • Requiere el relayer de Deakee (aún no liberado).
  • Mismo código que modo OAuth2 — actívalo cuando estés listo.

Instalar

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

Ejemplo

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

Cómo Deakee se conecta a tu plugin

Tu API key de partner autentica las llamadas al relayer de Deakee. Las URLs OAuth2 authorize/token se usan una vez por cliente para obtener la dirección de la wallet (alcance: identity únicamente).

authorize_urlhttps://deakee.com/oauth2/authorize (scope=identity)
token_urlhttps://deakee.com/oauth2/token
api_base_urlhttps://deakee.com/api/relayer/v1

Verificar conformidad

Antes de producción, ejecuta el verificador oficial. Comprueba el libro centralizado, el flujo OAuth de identidad, el cableado de mint/burn del puente y la idempotencia.

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

¿Atascado? Lee el README completo o abre un issue en github.com/deakee/loyalty/issues.