Skip to main content
Una app se registra desde una cuenta de Craqui: la crea el propietario de un negocio cuyo plan incluye la API, y queda a nombre de ese negocio. Cualquier propietario de ese negocio la puede gestionar, así que la app no depende de una sola persona.
Si tu empresa no tiene un negocio en Craqui, escríbenos antes de empezar: te preparamos una cuenta para registrar y probar tu app.

​
1. Crea la app

En Craqui, Configuración → Integraciones → API, abre Tus aplicaciones y elige Nueva aplicación.

​
La descripción

Puedes nombrar Craqui para contar con qué se conecta tu app: «Sincroniza tus pagos de Craqui con tu contabilidad» está bien. Lo que no puede hacer la descripción es presentar tu app como si fuera de Craqui: empezar con «Craqui…», decir que es oficial, hecha, verificada o aprobada por Craqui, o hablar en nombre de Craqui («Craqui te pide…»). La marca Verificada por Craqui la pone la pantalla de conexión cuando aprobamos tu app, no la descripción.

​
Las direcciones de retorno

Se comparan exactamente, letra por letra: sin normalizar mayúsculas, barras finales ni puertos. La redirect_uri que mandas al conectar tiene que ser una de estas, tal cual.
  • Con https://, sin # y sin usuario ni contraseña.
  • Mientras la app está en desarrollo también sirven http://localhost y http://127.0.0.1, para probar en tu máquina. El puerto es parte de la dirección: registra exactamente el que usas (http://localhost:3000/craqui/callback). En cualquier otro estado, esas direcciones no funcionan aunque sigan en la lista, y no podemos aprobar una app que todavía las tenga: quítalas antes de enviarla a revisión.
  • Usa una dirección de tu propio dominio, el mismo de tu sitio o un subdominio: https://app.tuempresa.com/craqui/callback. En la revisión lo miramos.

​
2. Guarda el identificador y el secreto

Al crear la app, Craqui te muestra dos valores: Craqui no guarda el secreto en claro y no lo puede volver a mostrar. Cópialo en ese momento al gestor de secretos o a las variables de entorno de tu servidor:
El secreto va solo en tu servidor: nunca en una página web, en una app de teléfono ni en un repositorio. Quien lo tenga puede hacerse pasar por tu app. Lee Seguridad.
Si lo pierdes, crea uno nuevo desde la app (Credenciales → Nuevo secreto). Una app puede tener hasta dos secretos activos, para cambiar uno por otro sin cortar el servicio.

​
3. Pruébala en desarrollo

La app nace en desarrollo. Así ya funciona de punta a punta, con dos límites:
  • Solo la pueden conectar los propietarios del negocio que la registró.
  • Solo la pueden conectar a negocios donde ellos también son propietarios.
Para probarla, conéctala a tu propio negocio siguiendo Conectar un negocio y haz algunos pedidos. Son datos reales: las apps no tienen un negocio de prueba. Cada pedido aparece en la Actividad de tu app, en el panel, y en la Actividad de la API del negocio.

​
4. Envíala a revisión

Cuando funciona, elige Enviar a revisión en la app. Mientras la revisamos no se puede editar. Si la aprobamos, cualquier propietario la puede conectar; si nos falta algo, la app pasa a Necesita cambios con lo que pedimos, y la envías de nuevo. Lee Revisión de tu app.

​
Los estados de una app

​
Si el plan del negocio que la registró cambia

Si el plan de tu negocio deja de incluir la API, tu app sigue funcionando en los negocios que la tienen conectada. Tu panel queda en solo lectura: puedes ver la app, crear y revocar secretos y eliminarla, pero no editarla ni enviarla a revisión hasta volver a un plan con API.

​
Eliminar la app

Desde la app, Zona de peligro → Eliminar aplicación. Se desconecta de todos los negocios que la usan, sus secretos dejan de funcionar y no se puede deshacer.