Pide tu alta

En corto

Hoy el alta es manual: escribe a [email protected] con los datos de tu app (abajo tienes la plantilla), y el equipo te crea client_id/client_secret y un comercio de pruebas para que integres sin tocar comercios reales.

Las apps públicas (OAuth) entran por invitación: hoy no hay registro abierto. Escribe a nuestro correo con los datos de tu app y el equipo de Wink te da de alta.

[email protected]Copiar

Qué incluir en el correo

Copia esta plantilla y complétala:

Asunto: Alta de app — <nombre de tu app>

Nombre de la app:
Empresa:
Contacto técnico (nombre y correo):

Qué hace la app y para quién:

URLs de retorno (redirect_uri) exactas:
-

Permisos que necesita y por qué (uno por línea):
- catalog.view —
- sales.create —

URL de política de privacidad:

URL de instalación (install_url):
Logo de la app (URL, o indica que lo envías como archivo adjunto):

Ficha de la app (lo que ve el Dueño en el catálogo):
- Descripción corta (máx. 120 caracteres):
- Descripción larga:
- Sitio web:
- Correo de soporte:

• Las URLs de retorno deben coincidir exactas (esquema, host, puerto y ruta) con las que uses al pedir el código de autorización: un redirect_uri que no coincide nunca redirige, se muestra como error en Wink POS. Ver OAuth 2.0 con PKCE.
• La URL de instalación es adonde Wink POS manda al Dueño cuando hace clic en “Instalar” desde el catálogo de apps, con ?business_id=<id> agregado a la query string. Desde ahí, tu app arranca su propio flujo OAuth (ver cómo llega el comercio a tu app). Wink POS también la usa para el botón «Abrir» de las apps ya instaladas (Ajustes → Integraciones), con el mismo ?business_id=<id>: tu app debe aceptar que el comercio llegue ya instalado (por ejemplo, llevarlo a su panel en vez de repetir la instalación).
• Pide solo los permisos que tu app usa de verdad: la revisión los compara contra lo que hace la app (ver Revisión y publicación). La lista completa está en Permisos (scopes).
• Si solo necesitas conectar un único comercio (el tuyo, o el de un cliente que confía en ti), no hace falta este paso: usa una app privada en su lugar.

Qué responde Wink

El equipo responde al correo con la decisión y, si corresponde, los siguientes pasos para probar tu app con el comercio de pruebas.