La organización contiene tu equipo y tu facturación; la aplicación tiene flujos y claves de API, en producción o sandbox. Entenderlo evita la mayoría de líos.
Organización = tu equipo, tu saldo de facturación, tu registro de auditoría. Aplicación = flujos de trabajo, claves de API, endpoints de webhook, política de retención y productos, en dos entornos: Producción y Sandbox. La mayoría de los problemas de "hice un cambio y no pasó nada" son estar en la aplicación equivocada, o en el entorno equivocado.
#Los dos niveles
Organización es tu cuenta. Es propietaria de:
- Tu equipo y sus roles
- Tu saldo de facturación y tus facturas
- Tu registro de auditoría
- Todas tus aplicaciones
Aplicación es un espacio de trabajo dentro de la organización. Es propietaria de:
- Sus propios flujos de trabajo
- Sus propias claves de API
- Sus propios endpoints de webhook
- Su propia política de retención de datos
- Sus propios productos, donde ya se ha desplegado la activación de productos por aplicación. Consulta los productos y lo que incluyen
- Dos entornos: Producción y Sandbox
Cambia de aplicación desde la tarjeta de aplicación de la parte superior de la barra lateral. El cambio se aplica de inmediato. El mismo menú abre Configuración de la aplicación y Crear aplicación.
#Por qué esto importa más de lo que parece
Casi todos los reportes de "lo cambié y no pasó nada" se resuelven con esta estructura:
- Editaste un flujo de trabajo en la aplicación A mientras tus sesiones se ejecutan bajo la aplicación B.
- Añadiste un endpoint de webhook a una aplicación y esperabas eventos de otra.
- Estás mirando Sandbox mientras tu tráfico se ejecuta en Producción, o al revés.
- Estás llamando con una clave de una aplicación distinta del recurso al que te diriges, y obtienes un 404 o un 403 para algo que claramente existe.
Antes de depurar cualquier otra cosa, confirma la aplicación. Consulta errores de la API y qué significan.
#Producción y Sandbox son entornos separados
Las aplicaciones nuevas son de Producción. Las pruebas se hacen en Sandbox: la aplicación de prueba compartida de tu organización, con sus propios datos y sus propias claves. Cambia entre ellos con el selector Producción y Sandbox que aparece bajo el nombre de la aplicación en la barra lateral.
Las verificaciones, las claves de API, los webhooks y las listas están separados en cada entorno. La marca se comparte, y los flujos de trabajo se crean una vez y se pueden copiar entre entornos. Esa separación es la clave: el tráfico de prueba y los datos de producción nunca se mezclan, y una clave de sandbox no puede gastar créditos reales por accidente. Consulta pruebas en sandbox.
Nombra las aplicaciones de forma que nunca puedas confundirlas de un vistazo:
acme-onboarding y acme-payments es mejor que "Application" y "Application (2)".
Guarda las claves en tu gestor de secretos con nombres que incluyan el entorno, y
nunca dejes que una sola variable de entorno contenga "la clave que toque en cada
momento".
#¿Cuántas aplicaciones deberías tener?
La mayoría de los equipos empiezan con una, que ya te da Producción y Sandbox. Más allá de eso, divide por cualquier cosa que necesite su propia configuración o su propio aislamiento:
- Por producto, cuando productos distintos necesiten flujos de trabajo y endpoints de webhook distintos.
- Por entorno de preproducción, si necesitas más que el único Sandbox.
- Por marca, si ofreces verificación bajo varias marcas con estilos distintos.
- Por política de retención, ya que la retención se configura por aplicación.
Lo que no se divide por aplicación: tu saldo, que es a nivel de organización. Todas las aplicaciones consumen de los mismos créditos.
#Crear aplicaciones adicionales
Abre la tarjeta de aplicación de la parte superior de la barra lateral, elige Crear aplicación e introduce un Nombre de la aplicación (donde ya se han desplegado los productos por aplicación, también eliges para qué sirve). Si falta la opción, o necesitas crear una a través de la API en lugar de la consola, eso es una cuestión de permisos a nivel de cuenta que conviene preguntar a soporte en lugar de intentar sortear.
#Varias organizaciones
Una persona puede pertenecer a varias organizaciones, y cambia entre ellas desde el menú de organización de la parte superior de la barra lateral, donde también aparecen las invitaciones pendientes. Crear tú mismo más de una organización está limitado a las cuentas de reseller (contacta con soporte para activarlo), y no hay forma de crear suborganizaciones ni subcuentas bajo la tuya. Si das servicio a varios clientes propios, la estructura soportada es una aplicación por cliente dentro de tu única organización: cada aplicación tiene sus propios flujos, marca, claves de API, resultados e informes de uso, totalmente aislados del resto, mientras la facturación se queda a nivel de organización.
#Revender Didit
Si quieres integrar Didit en tu propio producto y cobrárselo a tus clientes, eso es el modelo de reseller. Así funciona, en los términos que soporte da a todo el que pregunta:
- Crédito prepagado. Una compra inicial mínima de $5,000 USD, prepagada, con un acuerdo de un año. El crédito nunca caduca, está a nivel de tu organización y se consume entre todos los clientes finales que incorpores, y lleva un descuento por volumen que crece con el importe.
- El panel lo construyes tú. Integras la API de Didit en tu propio front-end y tus clientes gestionan ahí sus flujos, su marca y sus roles. Didit no ofrece una copia de marca blanca de la Business Console; las pantallas de verificación que ven tus usuarios finales sí pueden llevar tu marca (consulta marca blanca), la consola no.
- Tu margen es tuyo. Tú fijas el precio que pagan tus clientes. Didit te factura por función completada a los precios unitarios fijados durante la vigencia del acuerdo.
- No es un programa de partners locales. Didit hace las demos, la incorporación y el soporte directamente con los clientes y no busca partners de distribución ni de implementación.
Si prefieres no gestionar la reventa, usa la opción de referidos: en la Business Console, abre Configuración → Recomienda y gana, obtén tu enlace y compártelo. Ganas una comisión del 10% sobre cada depósito en efectivo que haga una organización referida, durante 36 meses desde su primer depósito, utilizable como crédito de Didit o cobrable por transferencia bancaria cuando madure, sin obligaciones de entrega ni de soporte. Puedes construir y probar tu integración en el plan gratuito antes de comprometerte con cualquiera de las dos.
#Eliminar una aplicación
La eliminación permanente de una aplicación todavía no está disponible: Configuración de la aplicación tiene una Zona de peligro, pero indica que la eliminación no está disponible y no elimina nada. Tus opciones hasta entonces:
- Deja de usarla. Cámbiale el nombre (algo como
acme-old) para que nadie la elija por error, y revoca sus claves de API en Desarrolladores → Claves de API. - Borra sus datos de clientes. Los datos de verificación siguen la política de retención y las reglas de eliminación de esos datos, no el ciclo de vida de la aplicación: elimina los datos de forma explícita. Consulta eliminar sesiones y datos personales.
- Empieza de cero. Soporte puede eliminar la organización entera para que puedas crear una nueva; es el último recurso, ya que se lleva consigo el equipo, el saldo y el historial.
#Todo es atribuible
Cada cambio registra a qué aplicación pertenecía, en el registro de auditoría. Eso es lo que hace que una estructura con varias aplicaciones sea auditable y no solo ordenada. Consulta cómo usar los registros de auditoría.
¿Sigues atascado? Habla con una persona.
Incluye el ID de tu organización y el ID de la sesión sobre la que preguntas.