---
title: "API de Ticket Fairy, webhooks, CLI y servidor MCP España"
description: "Cada pedido pagado llega a tus propios sistemas en segundos. Cada herramienta tiene su propio token de acceso, puedes automatizar con scripts la configuración que repites y los asistentes de IA ayudan dentro de tu rol."
canonical: "https://www.ticketfairy.com/es/features/api-and-developers"
---

API y desarrolladores

# Envía cada pedido a tus propios sistemas en segundos

Recibes cada pedido en tu propia dirección segundos después de que el comprador paga. Puedes automatizar con scripts la configuración que repites o dejársela a tu asistente de IA, dentro de tus permisos.

  [Empieza gratis](https://manage.ticketfairy.com/registration) [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo)    ![Tarjeta Tokens de acceso personal de Ticket Fairy con tokens y sus fechas de creación, último uso y vencimiento](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--personal-access-tokens.png)

- Cada venta en tus propios sistemas en segundos
- Ninguna contraseña del panel entregada a una herramienta
- Automatizas una sola vez la configuración y los reportes repetitivos

- **25\.000+** eventos con Ticket Fairy
- **10M+** boletos emitidos
- **10+** países
- **20%** más boletos con recompensas por recomendación

## Conecta tus propias herramientas sin compartir una contraseña

Si tu agencia o tu empresa de promoción tiene su propio CRM, sus propios reportes o su propio sitio web, puedes conectarlos directamente con Ticket Fairy.

En la configuración de tu cuenta, creas un token de acceso personal para cada laptop, servidor, script o agente, le pones el nombre de la herramienta que lo usa y le das un vencimiento adecuado para el trabajo. Cada token tiene tu propio rol, así que solo abre las marcas y los eventos que puedes abrir tú, y si se pierde una laptop, puedes revocar su token de inmediato. Tus scripts usan la API de Ticket Fairy para crear eventos y consultar sus ventas, y si un script reintenta después de un error de red, sigues teniendo un solo evento, no dos.

- **Tokens de acceso personal**: uno para cada herramienta, con su propio vencimiento, revocable al instante
- **API de Ticket Fairy**: crea eventos y consulta sus ventas desde tus scripts
- **Cliente de Python**: listados públicos sin cuenta, y tus propios eventos con un token

## Recibe cada pedido en tus sistemas segundos después de que pagan los compradores

Tu CRM y tus reportes se mantienen al día sin que nadie exporte un archivo. Con un webhook en una marca, una gira o un evento, recibes cada pedido en una dirección tuya segundos después de que el comprador paga, con los boletos, los complementos, los totales y los datos de los titulares de boletos.

Cuando alguien cambia, transfiere o reembolsa un pedido, recibes de nuevo el pedido completo. Los webhooks de marca y de gira también pueden avisarte de eventos nuevos, modificados y publicados. Puedes elegir el pedido completo, o el formato que espera Zapier, Iterable o Symmetry, y conectar Zapier con tu clave de API de webhook. Una prueba desde la página Webhooks comprueba que tu dirección la acepta.

- **Webhooks de pedidos**: para una marca, una gira o un solo evento
- **Zapier**: conecta con tu clave de API de webhook
- **Enviar prueba**: datos de ejemplo que revisan tu dirección antes de tu primer pedido

    ![Tarjetas Clave de API y Clave de API de webhook de Ticket Fairy, cada una con la clave, un control para copiarla y otro para regenerarla](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png)

## Vende boletos en tu propio sitio web o en tu propia app

Los compradores eligen boletos y pagan sin salir de tu sitio web. El fragmento de inserción del evento pone tu pago en la página de tu evento.

El SDK de pago para React te da un pago sin la marca Ticket Fairy en tu propio sitio web hecho con React, y el SDK de pago para React Native vende dentro de tu propia app de iPhone o Android. Tu sitio web también puede mostrar tus eventos públicos activos a través de la API pública de eventos, sin necesidad de clave.

- **Inserción del evento**: checkout en la página de tu propio evento
- **SDK de checkout para React**: un checkout con tu propia marca en tu sitio web hecho con React
- **SDK de checkout para React Native**: boletos a la venta dentro de tu propia app de iOS o Android

    ![Página de seguridad de la inserción del evento en Ticket Fairy con las direcciones de sitios web autorizadas para mostrar el checkout](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--allowed-sites.png)

## Deja que tu propio asistente de IA se encargue de las tareas rutinarias de tus eventos

Con la herramienta de línea de comandos de Ticket Fairy (CLI) instalada y con la sesión iniciada una vez, puedes automatizar con scripts la configuración y los reportes que repites, como copiar un evento o guardar un resumen de ventas cada noche.

La CLI también ejecuta un servidor MCP en tu propia computadora, para que Claude Code, Cursor y otros asistentes puedan ver tus ventas en vivo y hacer por ti configuraciones rutinarias, solo con lectura si así lo eliges. Antes de que se ejecute una eliminación o una cancelación, tu cliente de IA te pide aprobarla. Un agente de IA que pide actuar en tu nombre obtiene acceso solo después de que lo apruebas, y puedes terminar ese acceso en Configuración de cuenta.

- **CLI de Ticket Fairy**: eventos, boletos, pedidos y reportes desde la terminal
- **Servidor MCP**: tu asistente actúa como tú, con tu rol
- **Agentes de IA que tú apruebas**: termina el acceso de un agente en cualquier momento

[Empieza gratis](https://manage.ticketfairy.com/registration) [Reservar Llamada Demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo)

## Crea sobre Ticket Fairy con todo lo que necesita tu desarrollador

- ### Tokens de acceso personal

  Cada herramienta recibe un token con nombre y su propio vencimiento. Puedes rotarlo con un periodo de superposición para que un proceso en curso siga funcionando, y revocarlo al instante.
- ### Clave de API de la marca

  Puedes generar la clave que piden las API de eventos, como tu tabla de clasificación de recomendaciones, y regenerarla cuando necesites una nueva.
- ### API de Ticket Fairy

  Tus propios scripts pueden crear eventos y consultar sus ventas, y tu desarrollador trabaja a partir de una descripción OpenAPI.

  [Más información](https://www.ticketfairy.com/developers)
- ### API pública de eventos

  Los eventos públicos activos, incluidos los tuyos, se consultan sin cuenta, y puedes preguntar por los próximos eventos con palabras sencillas.

  [Más información](https://www.ticketfairy.com/developers)
- ### Webhooks de pedidos

  Recibes cada pedido en tu propia dirección en cuanto el comprador paga, y otra vez cada vez que alguien lo cambia, lo transfiere o lo reembolsa.

  [Más información](https://www.ticketfairy.com/developers)
- ### Webhooks de eventos

  Los webhooks en una marca o una gira te avisan de los eventos nuevos, modificados y publicados.

- ### Zapier, Iterable y Symmetry

  Cada una de estas herramientas recibe el formato de webhook que espera, y conectas Zapier con tu clave de API de webhook.
- ### CLI de Ticket Fairy

  Eventos, boletos, pedidos, clientes y tu equipo se pueden manejar desde la línea de comandos o una tarea programada.

  [Más información](https://www.ticketfairy.com/cli)
- ### Servidor MCP

  Claude Code, Cursor u otro cliente MCP pueden conectarse a tus eventos, empezando solo con lectura si lo prefieres.

  [Más información](https://www.ticketfairy.com/mcp-server)
- ### Aprobación de agentes de IA

  Cada agente de IA que pide actuar en tu nombre necesita tu aprobación, y puedes terminar su acceso en Configuración de cuenta.
- ### Inserción del evento

  Tu checkout puede estar en la página de tu propio evento para que los compradores paguen sin salir de tu sitio web.

  [Más información](https://www.ticketfairy.com/es/features/event-pages-and-website)
- ### SDK de checkout

  Puedes crear tu propio checkout en tu sitio web hecho con React, o dentro de tu propia app de iPhone o Android.

  [Más información](https://www.ticketfairy.com/developers)
- ### Integraciones de marketing

  Los compradores llegan a Klaviyo, Mailchimp, Laylo y Hive sin escribir nada de código.

  [Más información](https://www.ticketfairy.com/es/features/integrations)
- ### Fai y tus webhooks

  Fai, la compañera de equipo con IA de tu panel, puede mostrar, agregar, cambiar, probar o eliminar tus webhooks, y te pide aprobar cada cambio.

  [Más información](https://www.ticketfairy.com/es/features/fai)
- ### Eventos creados por tu asistente de IA

  Un asistente de IA puede crear tu evento a partir de su nombre, fechas, recinto y descripción. El enlace que te da abre el registro o el inicio de sesión, y el evento se une a tu marca como borrador para que lo revises.
- ### Mapas de asientos y verificación de identidad en tu propio proceso de pago

  Con el SDK de pago para React, los compradores eligen asientos en tu mapa de asientos y pagan con tarjeta con Stripe o Xendit, y en tu app el SDK verifica la identidad de los compradores y mantiene iniciada la sesión de los compradores.
- ### Un proceso de pago con tus propios colores

  Defines el color de acento, los fondos, los colores del texto, las esquinas y la tipografía en modo claro u oscuro, o acomodas las secciones del proceso de pago en tu propio diseño.
- ### Códigos promocionales y crédito por recomendación en tu app

  Tu proceso de pago puede abrirse con un código promocional ya aplicado, acreditar una venta a quien recomendó al comprador y mostrar a los compradores sus recompensas por recomendación después de pagar.
- ### Quién configuró cada webhook

  Ves quién agregó cada webhook y cuándo, puedes desactivarlo y volver a activarlo sin perder su dirección, y puedes enviar una prueba que te dice si tu dirección la recibió.
- ### Tokens que ya ninguna herramienta usa

  Ves cuándo se usó por última vez cada token de acceso personal, para que puedas revocar los que ya no necesita ninguna herramienta.

## Así se ve en tu panel

- ![Página de instalación de Inserción del evento de Ticket Fairy con el código del checkout listo para pegar](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--install.png)
  *Con el código de Inserción del evento en la página de tu evento, los compradores pagan sin salir de tu sitio web.*
- ![Tarjeta de Laylo en la página Integraciones de Ticket Fairy, con el campo de URL del webhook de Laylo, Mostrar y Guardar](https://www.ticketfairy.com/embeds/posters/marketing-brand-integrations--laylo.png)
  *Un solo enlace pegado envía cada pedido pagado a Laylo, sin necesidad de código.*

## Conecta tus propias herramientas paso a paso

Las guías están en inglés.

- [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/guides/create-an-api-key-for-your-own-app)
- [Get a webhook each time you take a ticket order](https://www.ticketfairy.com/guides/get-a-webhook-when-a-ticket-sells)
- [Sell tickets on your own website](https://www.ticketfairy.com/guides/sell-tickets-on-your-own-website)

## Preguntas sobre API y desarrolladores

            Browse by category

### API y desarrolladores

#### ¿Uso un token de acceso personal o la clave de API?

Usa un token de acceso personal para la línea de comandos, el servidor MCP, tus propios scripts y tus agentes. Usa la clave de API de tu marca para las API de eventos, como tu tabla de clasificación de recomendaciones. Regenerar la clave de API detiene todas las aplicaciones que usan la clave anterior hasta que las actualices.

#### ¿Cuánto dura un token de acceso personal?

Un año de forma predeterminada, que también es lo máximo. Elige un vencimiento más corto para un script de una sola vez. El token se muestra una sola vez, así que cópialo antes de cerrar la ventana. Cuando rotas un token, el anterior sigue funcionando hasta siete días mientras lo reemplazas.

#### ¿Cuántos tokens puedo crear?

Diez por hora, contando las rotaciones, y no puedes crear uno nuevo mientras haya cincuenta activos. Puedes revocar todos los que quieras.

#### ¿Qué pasa cuando mi dirección de webhook no funciona?

Ese envío falla y no se vuelve a enviar, y el siguiente pedido llega con normalidad. Si tu dirección responde 410 Gone, eliminamos el webhook. Las direcciones de webhook deben empezar con https://.

#### ¿Puedo comprobar que una solicitud de webhook viene de Ticket Fairy?

Sí. Agrega un secreto de firma al webhook, y a partir de ahí cada solicitud lleva un encabezado X-Signature que tu sistema verifica con el mismo secreto. La documentación de webhooks explica cómo hacerlo.

#### ¿El mismo pedido llegará a mi webhook más de una vez?

Sí. El pedido completo se vuelve a enviar cada vez que cambia, y un webhook de marca y un webhook de evento que envían a la misma dirección lo envían los dos. Identifícalo por el número de pedido en lugar de contar cada envío como una venta nueva.

#### ¿Cómo pagan los compradores en mi propia app?

A través de Stripe. El SDK de checkout para React Native cobra los pagos con el SDK de Stripe para React Native, y su documentación indica la configuración para iOS y Android.

#### ¿La CLI y el servidor MCP cuestan algo?

No. Los dos son gratis con tu cuenta de Ticket Fairy y necesitan Node 20 o una versión más reciente. El servidor MCP viene con la CLI. Los comandos y las herramientas de Vault son para marcas con acceso a Vault, y solo consultan información.

#### ¿Un asistente de IA o un token pueden hacer más que yo?

No. Cada uno actúa como tú, con tu rol y tus marcas, así que no puede abrir los datos de otra marca ni darse permisos nuevos.

#### ¿Cuánto dura el enlace de mi asistente de IA?

Tres días, o hasta que te registres o inicies sesión con él. El primer navegador que abre el enlace se queda con el evento, y el asistente ya no puede cambiar el evento después de eso.

#### ¿Qué necesita el SDK de pago para apps?

React Native 0.81 o posterior con la Nueva Arquitectura, React 19.1 o posterior, iOS 15.1 o posterior y Android API 24 o posterior. Necesita un development build, porque Expo Go no puede cargarlo. Instala tf-checkout-react para un sitio web y tf-checkout-react-native para una app, ambos desde npm.

#### ¿Qué vencimiento le puedo dar a un token de acceso personal?

Una hora, 7 días, 30 días, 90 días o un año, en Establecer expiración personalizada. Cada miembro del equipo crea sus propios tokens, y revocar uno deja funcionando tu contraseña y tus otros tokens.

#### ¿Puedo probar un webhook desde mi propia computadora?

Sí, a través de un servicio de túnel que le da a tu computadora una dirección https. Una prueba que falla muestra el código de respuesta que devolvió tu dirección.

#### ¿Cómo obtengo un ID de cliente para el SDK de checkout?

Abre tu marca en el panel, selecciona Checkout apps y agrega una app. Ingresa cada sitio web que vende boletos, o ninguno para una app móvil, y luego copia el ID de cliente y el código de configuración. No hay ningún secreto de cliente que guardar, y una app vende solo los eventos de tu marca.

### Event Ticketing Platform in Espa&ntilde;a

#### What can Ticket Fairy do for events in España?

Sell tickets in EUR, grow sales with buyer referrals, see which campaigns produce revenue and scan guests from most iOS or Android phones and tablets.

#### How can ticket buyers pay in España?

Buyers can pay in EUR by card, Apple Pay or Google Pay, and you can offer [payment plans](https://www.ticketfairy.com/event-ticketing/event-payment-plans). You can be paid daily on your own connected Stripe account, where your country supports it.

#### Can your festival ticketing platform handle summer festivals in España?

Yes. Sell multi-day passes, camping, parking and VIP upgrades. Connect your existing RFID or cashless partner after we confirm the integration for your event. Current integrations include Billfold, MyCashless, Weezevent or Weeztix, PlayPass, WRSTBND and Intellitix.

## Más de Ticket Fairy

- ### [Suma a cada comprador de boletos a tus herramientas de marketing](https://www.ticketfairy.com/es/features/integrations)

  Tus compradores de boletos llegan a Klaviyo, Mailchimp, Laylo y Hive sin que exportes una lista, y conectas cada herramienta una sola vez para toda tu marca.
- ### [Convierte a más de tus visitantes en compradores de boletos](https://www.ticketfairy.com/es/features/event-pages-and-website)

  Puedes crear páginas de evento que responden las preguntas de los compradores y darle a cada campaña su propia página, probar qué versión vende más y vender boletos en tu propio sitio web.
- ### [Saca adelante tus tareas de boletaje pidiéndoselas a Fai](https://www.ticketfairy.com/es/features/fai)

  Recibes respuestas sobre tus ventas en segundos, Fai se encarga de configurar tu evento, tus promociones y tus correos, y ella prepara tu trabajo financiero. Tú apruebas cada cambio antes.
- ### [Da a cada miembro del equipo el acceso que su trabajo necesita](https://www.ticketfairy.com/es/features/teams-and-security)

  Puedes invitar a tu equipo con el acceso que necesita cada trabajo y proteger tu inicio de sesión. Todo tu equipo se une a cualquier plan de pago sin precio por usuario. Desde tu primer día, Inicio te muestra por dónde empezar.

      [Anterior **Integraciones**](https://www.ticketfairy.com/es/features/integrations) [Funciones **Todas las funciones**](https://www.ticketfairy.com/es/features)

Descubre cómo Ticket Fairy, [plataforma de boletos para organizadores de eventos](https://www.ticketfairy.com/event-ticketing/), te ayuda a vender más boletos, con todas las funciones, los precios y el soporte que obtienes.

## Empieza a vender boletos online

Crea una cuenta gratuita y prepara un evento de prueba antes de comprometerte. Configura los boletos, explora las recompensas por recomendación y abre la venta cuando quieras.

Eventos ilimitados sin cuota mensual

Comienza a vender boletos inmediatamente

Herramientas de boletos, puerta y web en todos los planes, también en Free

   [Comenzar](https://manage.ticketfairy.com/welcome)

No se requiere tarjeta de crédito

The Ticket Fairy, Inc. es una empresa fintech y una plataforma tecnológica. The Ticket Fairy, Inc. no es un banco, una institución financiera ni un proveedor de servicios financieros regulado. Los servicios bancarios de Vault se ofrecen a través de socios bancarios regulados.
