Desplegar el SmartApp - Etapas de integración - Mercado Pago Developers
Recursos para IA

Desplegar el SmartApp

Después de la integración entre la aplicación y la terminal Point, la aplicación debe pasar por un proceso de homologación en Mercado Pago y definir la forma de distribución para los demás terminals que la utilizarán.

Aprobación de la aplicación

Independientemente del tipo de SmartApp, toda aplicación que se vaya a usar en terminals Point pasará por un proceso de validación para garantizar su funcionamiento, compatibilidad y seguridad. Para ello, se deben seguir algunas etapas:

Antes de enviar tu aplicación para aprobación, te recomendamos que prestes atención al versionado asignado al archivo APK, el cual se define en el parámetro versionName del AndroidManifest.

  • Versiones semánticas: cada vez que envíes una nueva versión, esta debe ser estrictamente mayor que la última versión enviada. Por ejemplo, si la última fue 1.5.0, la siguiente podría ser 1.5.1, o 2.0.0, etc. Las versiones duplicadas o inferiores a la última registrada no serán aceptadas durante la revisión del sistema.

  • Versiones no semánticas: si utilizas un formato de versión diferente (ejemplo: 1.6.1-smartApp, releaseA, etc) asegúrate de que la nueva versión sea distinta a cualquier versión que hayas enviado previamente, ya que no se permite reutilizar identificadores ya utilizados.

Se sugiere emplear versiones semánticas e incrementales para optimizar la gestión y el control de cambios. Adicionalmente, se recomienda no iniciar la numeración de versiones en 0, a fin de mantener un estándar coherente en el versionado del APK.

Contacta a tu representante de Mercado Pago y comparte el archivo APK (que debe ser menor a 50MB) para que revisen tu aplicación. El equipo de seguridad de Mercado Pago revisará que se cumplan los lineamientos indicados en el documento de Restricciones para Smartapps.

Para publicar tu aplicación en el ecosistema de Mercado Pago y garantizar la seguridad de la aplicación y de sus actualizaciones, debes firmarla digitalmente con un certificado. En la documentación oficial de Android encontrarás el paso a paso para firmar la aplicación con el certificado generado por el desarrollador.

Además, es necesario que siempre utilices la misma clave de firma para evitar conflictos en la herramienta de distribución cuando la aplicación se haya generado con diferentes claves.

Importante tener en cuenta que el archivo APK tenga la firma de google V1 y V2 para las versiones que lo requieran, de lo contrario no podrá pasar a producción. Versiones:

V1 < API 24
V1 e V2 > API 23

Comparte con el equipo de Soporte Mercado Pago los datos necesarios para poder instalar la aplicación en las terminals Point Smart que operarán con el aplicativo, asegurándose de que envíes correctamente la siguiente información:

  • Obligatorio: el número de serie de la terminal Point Smart y el user_id de la aplicación de la cuenta de Mercado Pago que estará asociada.
  • Opcional: el pos_id de la caja y el store_id de la sucursal que fueron creados y que estarán asociadas a las terminals.

Distribución de la aplicación

Después de la aprobación de la aplicación en las validaciones de seguridad, a partir del archivo APK el equipo de Mercado Pago realizará manualmente la distribución de la aplicación en los terminals que se utilizarán.