En esta página, aprenderá los conceptos básicos clave para integrarse con Clover si es un ISV que opera en Brasil o México.

👍

Documentos de integración

Mexico: https://docs.clover.com/dev/docs/quick-reference-guides-for-latam-mexico-developers

Brazil: https://docs.clover.com/dev/docs/quick-reference-guides-for-latam-region-brazil-developers

¿Cómo funciona?

Como parte de la familia First Data y Fiserv, Clover ofrece una sólida plataforma de gestión empresarial junto con una amplia oferta de servicios comerciales para potenciar el crecimiento de su pequeña empresa.

Los dispositivos Clover utilizan una potente aplicación de Fiserv para el procesamiento de pagos, conocida como "SITEF Sales app", esta aplicación es compatible con los servicios de adquisición de Fiserv reconocidos en todo el mundo.

Además, las aplicaciones de Clover son el comienzo de la solución completa para unir ambos mundos: Fiserv y Clover.
Si usted es un ISV en Brasil o México, debe utilizar la "aplicación de ventas SITEF" para aprovechar los servicios de adquisición de Fiserv junto con la aplicación de Clover para crear su propia solución.

Para tener tu propia solicitud como ISV tendrás que seguir este proceso general:

1. Crear una cuenta de desarrollador global.
2. Crear comercios de prueba.
3. Crear una aplicación
   a. Utilizar la "aplicación de ventas de Sitef" para las autorizaciones de tarjetas de crédito/débito.
   b. Usa cualquier otra aplicación de Clover que quieras.
4. Instala tu aplicación en un comercio de prueba.
5. Haz que se apruebe tu aplicación.

SITEF Sales App SDK

La App de Ventas SiTef es una aplicación desarrollada por Fiserv para la plataforma Android en terminales Clover que permite la integración con automatizaciones que deseen realizar transacciones (TEF) a través de Fiserv SiTef con integración en la plataforma y beneficios del ecosistema Clover y ecosistema Fiserv.

Consulte la documentación de la aplicación SITEF Sales SDK para obtener más detalles.

SDKs de los dispositivos Clover

Los dispositivos Clover ejecutan una versión personalizada del sistema operativo Android. Las aplicaciones que se ejecutan en dispositivos Clover deben escribirse para ejecutarse en el sistema operativo (SO) Android. Clover proporciona soporte para múltiples dispositivos en múltiples regiones.

A continuación, se enumeran las aplicaciones estándar de Clover que puede usar como predeterminadas para su solución en cada región de LATAM.

Revisa la API o el SDK de cada aplicación para saber cómo integrarla con su propia aplicación. Esa es la forma de crear una nueva aplicación personal para tu negocio.

Comenzar a usar la plataforma global para desarrolladores.

Nuestra plataforma abierta permite conectar sin problemas sus aplicaciones y llegar a los comercios de nuevas maneras. La plataforma abierta Clover proporciona herramientas para diseñar, configurar, probar y administrar integraciones de aplicaciones para los comercios de Clover en los entornos de sandbox y producción. En América Latina (LATAM)l. La plataforma global para desarrolladores de Clover ofrece una experiencia consolidada para desarrolladores con acceso al panel de control global para desarrolladores.

En el panel de control global para desarrolladores, puede acceder tanto al entorno de pruebas como al de desarrollador con una sola cuenta de desarrollador global de Clover. Obtienes una experiencia fluida para la administración de cuentas de desarrollador y para desarrollar y lanzar integraciones. Puedes:

• Inicie sesión con una única cuenta de desarrollador global y cambie entre los entornos de sandbox y producción.
  • Una nueva cuenta en la plataforma global para desarrolladores creará automáticamente un usuario para ambos: el entorno de sandbox y el entorno productivo.
• Invita a otros desarrolladores de tu organización a unirse a tu cuenta. Una vez que aceptan la invitación, se agregan automáticamente tanto al entorno de sandbox como al de producción.

Entorno Sandbox

Primero compila y prueba tus aplicaciones en el espacio sandbox. Es necesario:

1. Instalar tu app en comercios de prueba (test merchants). Cuando te registras en la plataforma global para desarrolladores para crear una cuenta de desarrollador, Clover crea una cuenta de comercio de prueba predeterminada para entornos de producción y sandbox.
2. Crea cuentas de comercio de prueba adicionales con diferentes configuraciones para simular los efectos de regiones, zonas horarias, monedas o permisos.
3. Prueba las aplicaciones que interactúan con las funciones de pago de Clover. El entorno sandbox está conectado a una pasarela de pago de prueba que comprueba la validez de las tarjetas de prueba y proporciona respuestas realistas a las solicitudes de pago. Esto permite crear aplicaciones que puedan manejar todas las respuestas posibles al completar una transacción.

Entorno Productivo

Después de crear y enviar mensajes a tu aplicación en el entorno sandbox, debe ser aprobada para su lanzamiento. Utiliza el entorno de producción para:

1. Completar el proceso de verificación y aprobación de la cuenta de desarrollador.
2. Volver a crear la aplicación en el entorno de producción.
3. Enviar la aplicación para su aprobación después de probarla. El equipo de Clover revisa y aprueba cada cuenta de desarrollador que se crea en el entorno de producción. Una vez que se apruebe y publique su aplicación, los comercios pueden descargarla e instalarla desde Clover App Market.
4. Supervisar el estado de la aprobación de tu aplicación y comunicarse con el equipo de Clover desde el panel de control del desarrollador de producción. Para obtener más información, consulta Descripción del proceso de aprobación de aplicaciones.

Lista de verificación para desarrolladores de aplicaciones

Contruye tu app

Para comenzar a crear aplicaciones para Clover, debes crear tu cuenta de desarrollador. Estos son los pasos de alto nivel que debe seguir:

1. Crear una cuenta de desarrollador global.
2. Crear comercios de prueba adicionales, si es necesario.
3. Compilar y probrar tu aplicación en el entorno de espacio aislado.
4. Genera un token de prueba de API en el panel de control del comercio de prueba.
5. Enviar la cuenta de desarrollador para su aprobación.

Nota: Puedes enviar tu cuenta de desarrollador para su aprobación en el entorno de producción incluso mientras compilas y pruebas tu app en el entorno de espacio aislado.

Libera tu app

Usa las siguientes listas de comprobación para obtener instrucciones sobre cómo publicar tu aplicación:

1. Vuelve a crear la aplicación en el entorno de producción.
2. Prueba la aplicación y graba videos de flujo de pago para el envío de tu aplicación.
3. Completa el proceso de aprobación de la aplicación.
4. Inicia la aplicación aprobada.
5. Administra tus aplicaciones:
   • Configuración
   • Aprobaciones
   • Instala
   • Rendimiento
   • Datos de facturación
6. Mantente al día con la información de la plataforma Clover.
7. Realiza un seguimiento de las nuevas características en cada versión
8. Ver las notas de la versión para desarrolladores, incluidas las novedades , las correcciones de errores y los anuncios sobre productos y características

Cree una cuenta de desarrollador

Clover requiere que cree una cuenta de desarrollador y que se apruebe la configuración de su cuenta para iniciar el proceso de aprobación de la integración. Una vez que se apruebe la configuración de la cuenta, puede enviar integraciones para su aprobación y, a continuación, administrar y realizar un seguimiento del rendimiento de la aplicación en el Panel de control global para desarrolladores.

Paso 1 - Crea tu cuenta de usuario:

1. Ingresa en https://www.clover.com/global-developer-home o escribe esta dirección en su navegador y presione Enter.
2. En la página Iniciar sesión, haz clic en Registrarse. Aparece la página Registrarse.
3. Introduzca la siguiente información:
   • Tu nombre tal y como quieres que aparezca en tu perfil de desarrollador.
   • Correo electrónico; Esto se guarda como el nombre de usuario para iniciar sesión después de registrarse.
   • Tu contraseña para acceder a tu cuenta de desarrollador.
4. Haz clic en Crear cuenta. Se envía un correo electrónico de confirmación a tu dirección de correo electrónico.

Paso 2 - Confirma tu cuenta: Confirma tu cuenta de desarrollador dentro de las 24 horas posteriores a la creación de la cuenta; de lo contrario, tendrás que volver a crear la cuenta.

1. Revisa tu correo electrónico para obtener un correo electrónico de confirmación de cuenta de Clover.
2. Abre el correo electrónico de confirmación y haz clic en Confirmar su dirección de correo electrónico. Aparecerá la página Finalizar la configuración de la cuenta.

Paso 3 - Termina de configurar tu cuenta:

1. En la página Terminemos de configurar tu cuenta, escribe el nombre del desarrollador o de la empresa en el campo Nombre de la cuenta de desarrollador. Este nombre aparece como propietario de la aplicación en el Clover App Market.
2. En la lista desplegable Elegir dónde estarán disponibles las integraciones, seleccione la región en la que estará disponible la integración.
3. Haz clic en Crear cuenta. Aparecerá una ventana emergente Cuenta de desarrollador creada. Además, se crea una cuenta de comerciante de prueba tanto en entornos de sandbox como de producción.
4. Haz clic en Iniciar sesión e ingresa tus credenciales. Se inicia la configuración de la autenticación de dos factores (2FA).

Paso 4 - Configurar la autenticación de dos factores (2FA)

Antes de proceder a configurar la 2FA para tu cuenta, descarga una aplicación de autenticación en tu teléfono. Por ejemplo Google Authenticator.

1. Haz clic en Configurar. Aparecerá la ventana emergente Abrir la aplicación de autenticación.
2. Utiliza la aplicación de autenticación para escanear el código QR. Aparecerá un código de verificación de seis dígitos en la aplicación.
3. Ingresa el código de verificación.
4. Haz clic en Siguiente. Aparecerá una ventana emergente Habilitado correctamente en la pantalla.
5. Haz clic en Descargar códigos de recuperación. Se guarda un archivo de texto (.txt) en el dispositivo. Utilice estos códigos de recuperación en caso de que no pueda acceder a su aplicación de autenticación.
6. Haz clic en Listo. Una vez completada la configuración de 2FA, aparece la página de inicio de sesión.
7. Introduce tus credenciales y el código de verificación para acceder a tu cuenta y ver el Panel de control global para desarrolladores.

Crear comercios de prueba adicionales

Las cuentas de comercio de prueba permiten simular las interacciones de los comercios con tu aplicación. Esto incluye la instalación de la aplicación, la asignación de permisos y, a continuación, la prueba de todas las funciones de la aplicación. Al crear una cuenta de desarrollador global, Clover crea una cuenta de comercio de prueba predeterminada para entornos de sandbox y de producción en el panel de control de desarrollador global.

También puedes crear cuentas de comercio de prueba adicionales con diferentes configuraciones para simular los efectos de diferentes regiones, zonas horarias, monedas o esquemas de permisos.

Para crear comercios de prueba adicionales:

1. Inicia session en Clover global developer account. Aparece el panel de control global para desarrolladores.
2. En la pestaña Sandbox predeterminada, en el menú desplegable Panel de control, haga clic en Crear ubicación de prueba. Aparecerá la página Crea tu comerciante de prueba.
3. Agrega la siguiente información:

4. Haga clic en Crear cuenta. El comerciante que agregó se muestra en la lista de comercios de prueba.

Ahora puedes ver y administrar la información del comercio de prueba. Ver Manage test merchants para más información.