# Abra — integrar venta de entradas en un sitio

Contrato para agentes que trabajan en el sitio del festival. Cara humana: https://app.abratickets.com/developers

Abra es infraestructura de ticketing. No custodia fondos: Mercado Pago, MODO o Ualá Bis cobran en la cuenta del organizador. El mail con el QR de puerta y las métricas viven en Abra (https://app.abratickets.com), no en el sitio del festival.

Un solo permiso abre el widget y el SDK: Abra setea `embed_authorized_at`. El organizador no puede habilitarse solo. Sin eso no hay snippet en Publicar, no se crean `abra_pk_` / `abra_sk_`, `/embed/…` no muestra checkout y `GET/POST /api/v1/sdk/*` responde 403 `site_not_authorized`.

## Obligatorio

1. Cuenta en Abra: https://app.abratickets.com/signup
2. Organización, cobro conectado (Cobros) y evento publicado.
3. Abra habilita la organización.

No hay métricas, stock interno, QR de puerta, reembolsos ni check-in en el sitio del festival. Eso se ve en la consola.

## Camino fácil — widget

Pegar este script. No integrar Mercado Pago, MODO ni Ualá en el sitio.

```html
<div id="abra-entradas"></div>
<script
  src="https://app.abratickets.com/embed.js"
  data-event="tu-org/tu-evento"
  data-target="abra-entradas"
></script>
```

`data-event` es `slug-de-la-org/slug-del-evento`, no un `evt_`. El snippet real se copia en Publicar.

## Camino propio — cards del festival + API

Ellos pintan las cards. Abra da tipos, includes, `soldOut`, `paymentProviders` y el cobro.

1. Crear `abra_pk_` en Configuración (solo si la org está habilitada).
2. `GET /api/v1/sdk/events/:eventId` con `Authorization: Bearer abra_pk_…`
3. `POST /api/v1/sdk/orders` (mismo body que una orden online) o `abra.checkout({ eventId, items, customer, provider })`
4. Optativo: `abra.mountPayCard("#abra-pagar", { eventId, items, customer })` — card “Pagar con Abra” (logo + montañas + medios conectados).

CDN: https://app.abratickets.com/sdk/abra.js (`new AbraSdk.Abra({ publicKey })`). Los paquetes `@abra/js` / `@abra/react` no están en npm.

Ejemplo mínimo:

```html
<div id="mis-entradas"></div>
<div id="abra-pagar"></div>
<script src="https://app.abratickets.com/sdk/abra.js"></script>
<script>
  const abra = new AbraSdk.Abra({ publicKey: "abra_pk_…" })
  const customer = { name: "Ana", email: "ana@festival.com" }
  abra.getEvent("evt_…").then((event) => {
    for (const type of event.ticketTypes) {
      const card = document.createElement("button")
      card.textContent = type.name
      card.disabled = type.soldOut
      card.onclick = () => {
        abra.mountPayCard("#abra-pagar", {
          eventId: event.id,
          items: [{ ticketTypeId: type.id, quantity: 1 }],
          customer,
        })
      }
      document.getElementById("mis-entradas").append(card)
    }
  })
</script>
```

## Qué no hacer

- No enmarcar `https://app.abratickets.com/e/…` (`X-Frame-Options: DENY`). El iframe válido es `/embed/{org}/{evento}`, creado por `embed.js`.
- No poner `abra_sk_` ni secretos de webhook en el browser.
- No hablar con la API de Mercado Pago / MODO / Ualá desde el sitio del festival.
- No inventar un panel de ventas en la web del festival.
- No crear claves ni llamar `/sdk/*` si Abra no habilitó la org.

Guías internas (repo Abra): docs/guides/embed.md (widget) y docs/guides/public-api.md (SDK).