Desarrolladores · Widget v1.1

Tu carrera, en tu web.

Pega una línea de código en la web de tu carrera y tus corredores tendrán a mano la vía oficial para publicar y comprar dorsales, en lugar de buscarlos en grupos de Facebook o Wallapop. Sin cambiar tu plataforma de inscripciones.

5 minutos
para quien actualiza tu web
0 cookies
ni datos personales en tu web
0 €
incluido en EntrySwap

Vista previa

Así lo ven tus corredores

Es el widget de verdad, funcionando en esta página con una carrera de demostración. Ocupa el ancho disponible y su alto se ajusta solo.

La vista previa no está disponible ahora mismo. Más abajo puedes generarla con tu propia carrera.

Instalación

En marcha en tres pasos

  1. 1

    Abre los cambios de dorsal en tu carrera

    En tu portal, en Mis carreras, edita la carrera, activa las transferencias y ponles una fecha límite. ¿Aún no tienes cuenta? Date de alta y la revisamos en menos de 48 h.

  2. 2

    Copia tu código

    Escribe el identificador de tu carrera (si has iniciado sesión, elige una de las tuyas), escoge los colores y copia el código.

    Es la última parte de la dirección de tu carrera: entryswap.com/carreras/tu-carrera-2026

    Una línea. El widget aparece justo donde la pegues y ajusta su alto solo.

    HTML
    <script src="https://entryswap.com/embed.js" data-carrera="tu-carrera-2026" async></script>
    tucarrera.es/inscripciones
  3. 3

    Pégalo junto a tu botón de inscripción

    Donde más ayuda es en tu página de inscripciones y, sobre todo, el día que cuelgues el «agotado»: es justo cuando tus corredores salen a buscar dorsal. En tu portal, en Mis carreras, tienes también el código de cada carrera listo para copiar.

    ¿No sabes tocar tu web? En ese mismo bloque, el botón Enviar instrucciones al desarrollador web le manda a quien la lleve el código y los pasos para su plataforma. A esa persona le lleva cinco minutos.

Comprar en tu web

Que el pago no saque al corredor de tu web

Si autorizas tu dominio, «Comprar» abre el pago en una ventana encima de tu web en lugar de en otra pestaña. Con el mismo script: no hay que cambiar el código.

  1. 1

    Autoriza la dirección de tu web

    En tu portal, en Mis carreras, bloque Compra en tu web, añade la dirección desde la que se ve el widget, por ejemplo https://www.tucarrera.es. Si tu web se abre con y sin «www», añade las dos. Vale para todas tus carreras.

  2. 2

    Ya está

    El widget detecta que está en una web autorizada y «Comprar» pasa a abrir la ventana. En cualquier otra web, o si quitas el dominio, vuelve a abrir EntrySwap en otra pestaña.

Siempre se ve quién cobra

En la barra de direcciones se ve tu web, así que la ventana lleva siempre arriba «Pago gestionado por EntrySwap · Stripe».

Pago con tarjeta

En la ventana se paga con tarjeta, con la verificación de su banco. Apple Pay, Google Pay y los demás métodos siguen disponibles en la compra en EntrySwap.

Solo en las webs que autorizas

La ventana de compra se niega a cargarse en cualquier web que no esté en tu lista. Nadie puede montar tu pago en una web falsa.

Publicar sigue en EntrySwap

Publicar exige iniciar sesión, verificar el email de inscripción y dar de alta el cobro en Stripe, y nada de eso funciona dentro de la web de otro. «Publica tu dorsal» abre EntrySwap en otra pestaña.

Así se ve

¿Prefieres probarlo? Abre la demostración : es esta misma web haciéndose pasar por la de una carrera, con el widget de verdad pegado dentro.

Capturas de una web de carrera de ejemplo, montada por nosotros para probarlo. Fíjate en la barra de direcciones: el corredor sigue en la web de la carrera mientras paga.

tucarrera.es/inscripciones
La web de un club con la ventana de compra de EntrySwap abierta encima: cabecera «Pago gestionado por EntrySwap · Stripe» y el formulario con los datos del comprador
En un ordenador, la ventana se abre centrada sobre la web.
La misma ventana de compra en un móvil, ocupando toda la pantalla
En el móvil ocupa la pantalla completa.

Para quien lleva la web

  • Hace falta el script (o el contenedor + script). Con el iframe directo no hay ventana: «Comprar» abre otra pestaña.
  • Si tu web tiene una Content-Security-Policy, permite https://entryswap.com en script-src y en frame-src.
  • La ventana se pinta por encima de todo (z-index máximo) y bloquea el scroll de la página mientras está abierta. Se cierra con la X, con Esc o pulsando fuera.
  • Tras una compra, al cerrar la ventana el widget se recarga para no seguir ofreciendo ese dorsal.

Referencia

Todo lo que admite el widget

Atributos

AtributoValoresPor defectoPara qué sirve
data-carrera

Obligatorio

El identificador de tu carrera—Qué carrera muestra el widget. Es la última parte de la dirección de tu carrera en EntrySwap: entryswap.com/carreras/identificador.
data-tema

Opcional

oscuro · clarooscuroColores del widget. Usa «claro» si el fondo de tu web es blanco o muy claro.

En el iframe, las mismas opciones van en la dirección, por ejemplo ?tema=claro.

Si tu web mueve los scripts al final

Algunos editores y plantillas juntan todos los scripts al final de la página. En ese caso marca el sitio con un contenedor y carga el script una sola vez. Así también puedes poner varias carreras en la misma página: un contenedor por carrera y un solo script.

HTML
<!-- Donde quieras que aparezca el widget -->
<div data-entryswap-carrera="tu-carrera-2026"></div>

<!-- Una sola vez por página, por ejemplo antes de </body> -->
<script src="https://entryswap.com/embed.js" async></script>

Qué ve el corredor

Hay dorsales publicados

Cada distancia con sus dorsales disponibles y el precio. «Comprar» abre el pago en una ventana encima de tu web si has autorizado tu dominio; si no, la ficha de tu carrera en EntrySwap.

No hay dorsales ahora mismo

En lugar de un «agotado» sin salida, «Avísame» lleva a la ficha de la carrera para apuntarse y enterarse en cuanto alguien venda el suyo.

Plazo cerrado

Pasada tu fecha límite de cambios de titular, o si desactivas las transferencias, el widget lo indica y deja de ofrecer compras y ventas.

Carrera no encontrada

El identificador no corresponde a ninguna carrera activa. El widget lo dice y deja un aviso en la consola del navegador para quien lo esté instalando.

Alta en revisión

Mientras revisamos tu alta, el widget ya se puede instalar: anuncia que el cambio de dorsal oficial llega pronto. En cuanto la aprobamos, pasa solo a mostrar los dorsales, sin tocar tu web.

Qué pasa cuando alguien pulsa

  • Comprar abre el pago en una ventana encima de tu web (si has autorizado tu dominio) o la ficha de tu carrera en EntrySwap, en una pestaña nueva. En los dos casos el dinero queda retenido hasta que apruebas el cambio.
  • Publica tu dorsal abre el formulario de publicación con tu carrera ya elegida.
  • Tú apruebas cada cambio desde tu portal, como siempre: el widget no añade ningún paso.
  • Tu web no procesa pagos ni recoge datos: todo eso lo hace EntrySwap, también dentro de la ventana.

Guías

Dónde pegarlo según tu web

Si tu editor no ejecuta scripts, usa el iframe. Si tampoco admite iframes, el enlace funciona en cualquier sitio.

WordPress

Script

En el editor de la página, añade un bloque «HTML personalizado» y pega el código.

En WordPress.com algunos planes eliminan scripts e iframes: si no aparece, usa el enlace.

Wix

Iframe

Añade un elemento de «Insertar HTML», pega el iframe y dale unos 440 px de alto.

Wix mete el código en un recuadro de alto fijo, por eso aquí va mejor el iframe.

Squarespace

Script

Añade un bloque «Código» y pega el script.

Si tu plan no permite código personalizado, usa el enlace.

Webflow

Script

Arrastra un elemento «Code Embed» y pega el script.

Google Sites

Iframe

Usa la opción de insertar código del panel «Insertar», pega el iframe y ajusta el alto del recuadro.

Web propia o aplicación

Script o iframe

Pega el script donde quieras que aparezca. Si tu web es una aplicación (React, Vue…) que pinta la página después de cargar, usa el iframe.

¿La web de tu carrera la genera tu plataforma de inscripciones y no admite código? Pon el enlace en la descripción de la carrera y en los emails a tus inscritos.

Verificación de inscritos

Te decimos si quien publica está en tu lista

Opcional. Conecta tu hoja de inscritos y, en cuanto alguien publica un dorsal, comprobamos si su correo aparece en ella; al aprobar la transferencia verás el resultado. Tu lista no sale de tu cuenta: nosotros preguntamos por una dirección concreta y tu hoja contesta sí o no.

Lo que recibimos

  • Si esa dirección aparece en tu hoja: sí o no.
  • Si el dorsal que declara el vendedor cuadra con el tuyo.
  • Si esa inscripción sigue activa o está anulada.

Lo que no

  • Ninguna fila de tu hoja, ni una.
  • Ni nombres, ni DNI, ni teléfonos, ni el resto de tus inscritos.
  • Ni acceso a tu hoja: el que la lee es tu propio script, con tus permisos.

Cómo se conecta

  1. 1

    Ten a mano tu hoja de inscritos

    Una hoja de cálculo de Google con una columna de correos de inscripción. Puede tener todas las demás columnas que quieras: el script solo mira la del correo y, si existen, las de dorsal y estado. Exportar desde RockTheSport, Sportmaniacs o tu plataforma habitual y subir el archivo vale.

  2. 2

    Vacía el editor y pega el script

    En tu hoja, Extensiones → Apps Script. Se abre un editor con un archivo Código.gs que trae dentro un ejemplo de Google:

    Lo que verás al abrirlo
    function myFunction() {
    
    }

    Ese ejemplo no sirve para nada: selecciónalo todo y bórralo (⌘+A o Ctrl+A, y suprimir) antes de pegar. Luego copia el script de aquí abajo y pégalo en su lugar. Son unas 400 líneas y van en ese mismo archivo: no hay que crear ninguno nuevo.

    o descarga el archivo

    Ya pegado, lo único que tienes que cambiar son las primeras líneas. El secreto lo encuentras en EntrySwap, en Mis carreras → tu carrera → tarjeta «Verificación de inscritos»:

    Lo único que se toca
    const SECRETO = 'el que te damos en EntrySwap';
    
    // Vacío = la primera pestaña y las columnas se buscan solas
    const PESTANA = '';
    const COLUMNA_EMAIL = '';

    Guarda con ⌘+S. El nombre que le pongas al proyecto da igual.

  3. 3

    Ejecuta «probar» y autoriza el script

    Arriba del editor hay un desplegable de funciones: elige probar y pulsa Ejecutar.

    La primera vez Google te pedirá permiso, y te va a enseñar un aviso que asusta más de lo que debería: Revisar permisos → elige tu cuenta → «Google no ha verificado esta aplicación» → Configuración avanzada → Ir a (nombre del proyecto) → Permitir. Ese aviso sale con cualquier script que no esté publicado en el Marketplace de Google. Lo que estás autorizando es tu propio script a leer tu propia hoja.

    El resultado aparece abajo, en el Registro de ejecución: cuántos inscritos ha encontrado y qué columnas ha reconocido como correo, dorsal y estado. Si algo no cuadra te lo dice en una línea. No modifica nada de tu hoja.

  4. 4

    Impleméntalo como aplicación web

    Implementar → Nueva implementación, y en el engranaje de la izquierda elige Aplicación web. Después: «Ejecutar como» yo, «Quién tiene acceso» cualquier persona.

    Copia la URL que te da al terminar, que es la que acaba en /exec. En el editor verás también una que acaba en /dev: esa no vale, solo responde mientras tú tengas la sesión abierta. Si abres la buena en el navegador verás un aviso: es normal, esa dirección no está pensada para abrirse sino para pegarla en EntrySwap.

    Lo de «cualquier persona» hace falta porque EntrySwap no tiene usuario dentro de tu Google; no abre tu hoja a nadie, porque quien llame sin el secreto no recibe nada. No compartas la hoja con «cualquiera con el enlace»: no se necesita.

  5. 5

    Pega la URL en EntrySwap

    Vuelve a la tarjeta de donde copiaste el secreto: Mis carreras → tu carrera → «Verificación de inscritos». Pega la dirección en el campo de debajo del secreto y pulsa Conectar. Probamos la conexión en ese momento, con una dirección inventada, para confirmar que responde sin usar los datos de nadie: si todo va bien verás «Conexión correcta. Tu hoja responde».

Si algún día tocas el script —cambiar el secreto, fijar una columna— guardar no basta: la URL sigue sirviendo el código anterior. Hay que ir a Implementar → Gestionar implementaciones, editar la que ya tienes y elegir Versión: nueva. La dirección no cambia, así que no hay que volver a pegarla en EntrySwap.

Quien decide sigues siendo tú. Si la dirección no aparece no rechazamos nada: te lo enseñamos como «no hemos podido confirmarlo», porque lo normal es que la hoja se haya quedado atrás o que el corredor se inscribiera con otro correo. Y si tu script no responde, la transferencia sigue su curso con la verificación manual de siempre.

Privacidad y seguridad

Tu web sigue siendo tuya

Solo datos públicos

Nombre de la carrera, distancias, precio oficial y cuántos dorsales hay. Nunca datos de quien publica o compra.

Sin cookies ni rastreadores

El widget no instala cookies ni carga herramientas de terceros: el código y las fuentes se sirven desde entryswap.com. No afecta a tu banner de cookies. Si activas la compra en ventana, el pago lo procesa Stripe, que usa sus propias cookies antifraude, como en cualquier pago con Stripe.

Tu web no recoge nada

No hay formularios dentro del widget. Los de compra, en otra pestaña o en la ventana, son de EntrySwap: los datos y el pago van directamente a EntrySwap y nunca pasan por tu web.

Aislado de tu página

Se carga en un iframe con sandbox: no puede leer tu página ni cambiar la que está viendo tu visitante.

No frena tu web

El script pesa menos de 10 KB, se carga en diferido y el widget no se descarga hasta que el visitante se acerca a él.

Siempre al día

Los dorsales disponibles se actualizan solos, en cuestión de un minuto. No tienes que tocar nada cuando cambian.

Como cualquier contenido incrustado, al cargar el widget el navegador del visitante se conecta a entryswap.com. Te recomendamos mencionarlo en tu política de privacidad junto a tus otros servicios externos.

Versiones

Lo que pegues hoy seguirá funcionando

El widget está en su versión 1.1. Nuestro compromiso: los atributos y direcciones que ya existen no cambian de nombre ni de significado. Las novedades llegan como opciones nuevas que no tienes que tocar si no las quieres. No tendrás que volver a pegar nada.

  1. v1.1 · 11 de septiembre de 2026

    Compra en una ventana encima de tu web para los dominios que autorices. Instrucciones por email para tu desarrollador web. No hay que cambiar el código pegado.

  2. v1 · 11 de septiembre de 2026

    Primera versión: script, contenedor, iframe y enlace; temas oscuro y claro; alto automático.

Preguntas frecuentes

Lo que suelen preguntarnos

¿Tu carrera aún no está en EntrySwap?

Date de alta gratis, en unos minutos: la revisamos en menos de 48 h. ¿Dudas con la instalación? Escríbenos y te ayudamos.

Contactar por WhatsApp