Primeros pasos

Elige el camino correcto

Caso de uso	Usa	Credencial
Backend propio que crea o gestiona inscripciones	`@wodira/sdk`	Secret key `wd_live_...`
Web pública que muestra eventos y crea checkout	`@wodira/browser`	Publishable key `wpk_live_...`
Web pública sin construir UI desde cero	`@wodira/browser/ui`	Publishable key `wpk_live_...`
Integración sin SDK	HTTP directo	Secret o publishable según endpoint

Obtener tus API keys en WODira

Las claves se crean desde el panel privado del organizador, en Perfil de organización → API.

Secret keyPara backends propios con scopes y wd_live_....Publishable keyPara webs públicas con allowed origins y wpk_live_....

Entra en WODira con una cuenta organizadora.
Abre tu organización y ve a Perfil de organización.
Selecciona la pestaña API. Ruta orientativa: /organizer/{organizationId}/profile?tab=api.
En Nueva clave, elige el tipo:
- Secret key (backend) para usar @wodira/sdk o la Organizer API.
- Publishable key (frontend) para usar @wodira/browser, @wodira/browser/ui o la Browser API.
Pon un nombre reconocible, por ejemplo web oficial, backend producción o landing 2026.
Si es publishable, añade Orígenes permitidos: un dominio por línea, por ejemplo https://organizador.com y https://www.organizador.com.
Si es secret, selecciona los scopes mínimos necesarios.
Opcionalmente configura una fecha de caducidad y pulsa Crear clave.
Copia la clave completa en ese momento: WODira solo la muestra una vez.

Flujo browser recomendado

Crear una publishable key con el dominio de la web externa en allowedOrigins.
Instalar @wodira/browser o @wodira/browser/ui.
Leer evento y categorías públicas con getEvent y getPricingCards.
Crear una Checkout Session con createRegistrationCheckoutSession, termsAccepted, waivers requeridos e idempotencyKey.
Redirigir a sessionUrl de Stripe Checkout.

import { createWodiraBrowserClient } from '@wodira/browser';

const wodira = createWodiraBrowserClient({ publishableKey: 'wpk_live_...' });
const event = await wodira.getEvent('event_...');
const pricing = await wodira.getPricingCards(event.id);