GUIA LAR PAYMENT MODULE

LAR
PAY
MEN
T API
–
INTE
GRA
TION
GUID
E

V2.0

www.ingenico.com
28/32, boulevard de Grenelle, 75015 Paris - France / (T) +33 (0)1 58 01 80 00 / (F) +33 (0)1 58 01 91 35
Ingenico – S.A. au capital de 53 086 309 € / 317 218 758 RCS PARIS
 1. Información del Documento

1.1. Versiones

version Date changes Author

2 17/05/2022 Actualizacion Flujo App Camilo Henao

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 2/13
 2. Resumen

Larpayment Module es una aplicación financiera estándar hecha por Ingenico

que tiene la implementación completa para realizar transacciones de forma
segura.

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 3/13
3. Requisitos

3.1. Componentes
● Larpayment Module: Aplicación financiera estándar que maneja el flujo
de las transacciones.

● Aplicación de Servicio de Pago Seguro: puerta de entrada a la

funcionalidad de pago seguro del terminal, que permite la certificación
P2PE sin afectar a la aplicación de pago que interactúa con él.

● acc-lib: biblioteca de alto nivel desarrollada para una fácil integración

con EMV y compatibilidad con el cifrado.

● emlib: biblioteca de alto nivel desarrollada para facilitar la integración

de State Manager.

3.2. Observaciones
Todas las pruebas e instrucciones fueron realizada con Android Studio
4.2.2 y gradle 7.1.1

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 4/13
 4. Configuración

4.1. Requerimientos para el uso

Los siguientes componentes necesitan ser instalados en la Terminal:

1 com.ingenico.larpaymentmodule-vX.X-develop-debug.apk
2 ingp-secure-payment-service-1.8.1-4.apk

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 5/13
 5. Arquitectura de la Aplicación

La aplicación base está construida de forma modular donde se integran

diferentes tipos de bibliotecas y paquetes.

En el siguiente enlace es posible visualizar toda la Arquitectura y las

definiciones de módulos, apis y librerías.

https://www.figma.com/file/GARAGrV1eunODcRLP4o5H6/Architecture-
LarPaymenModule

La aplicación base está construida con una arquitectura MVVM, desarrollada

en Kotlin, con vistas desarrolladas en XML, navegación a través del
Componente de navegación Android, base de datos construida en SQLlite
utilizando ORM ROOM y el uso de Dagger Hilt para inyección de
dependencias.

Larpayment Module es la app que coordina todos los flujos de la aplicación y

es la que invoca las diferentes funcionalidades y se integra con los paquetes y
módulos para poder realizar de forma segura las transacciones que se
requieran.

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 6/13
La biblioteca ACC Secure Payment proporciona un gateway a la funcionalidad
de pago seguro de la terminal, lo que permite la certificación P2PE sin afectar
la interfaz de la aplicación de pago.

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 7/13
 6. Módulos y Navegación

Actualmente la aplicación está compuesta por módulos de ventas,

anulaciones, cierre, informes, entre otros, lo que nos lleva a un flujo diferente
en cada una de las operaciones a realizar con el fin de realizar la acción
requerida.

En el siguiente enlace es posible ver todo el flujo de la aplicación:

https://www.figma.com/file/01T6Q26uoBRIHwz96vBZTb/LarPaymentModule-
Navigation

6.1. Ventas Con Tarjetas

Este módulo admite las ventas de crédito y débito, permitiendo seleccionar

moneda local u otras monedas según necesidad, dependiendo del tipo de
tarjeta leída, permite el ingreso de propinas, cashback y cuotas, además de
esto también solicita pin de verificación de manera automática si el monto
ingresado y el tipo de tarjeta lo requiere.

El flujo básico seria este:

(Para más detalle ver el link expuesto en el capítulo 6)

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 8/13
6.1. Ventas Con QR
 Generar Código QR

La aplicación permite la creación de un código QR único con los valores

de la transacción del comercio y con el formato EMV según su normativa
con la finalidad de que el cliente final lea el código QR y genere el pago
con la aplicación de algún tercero que permita este tipo de pagos.

 Escanear Código QR

Esta opción permite leer un código QR que este generado por otra
aplicación bajo el estándar EMV con la finalidad de autorizar la
transacción, este código lo lee la terminal y procede a generar la venta
según los parámetros ingresados.

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 9/13
 6.2. Comercio

Este módulo está creado específicamente para el comercio, quien puede

realizar acciones como anulaciones, cierres y reportes de transacciones.

Para ingresar a este módulo debe ingresar la contraseña, la cual es: 123456

Las funcionalidades que proporciona este módulo son:

● Cierre: Opción que permite cerrar todas las transacciones

realizadas de acuerdo con el tipo de moneda utilizada

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 10/13
La funcionalidad de este flujo:
(Para más detalle ver el link expuesto en el capítulo 6)

● Anular: Esta opción permite anular una factura que ya se ha

generado, pero no se ha cerrado. Para realizar esta acción se debe
ingresar el número de factura a anular.

El flujo de funcionalidad es:

(Para más detalle ver el link expuesto en el capítulo 6)

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 11/13
● Informes: Esta opción permite ver el detalle de las transacciones
que aún no han sido cerradas.

Hay dos formas de verificar estos detalles.

Total: Número consolidado de facturas generadas antes del cierre.

Detalles: detalle de las facturas generadas o anuladas.

El flujo de la funcionalidad es el siguiente:

(Para más detalle ver el link expuesto en el capítulo 6)

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 12/13
 6.3. Configuración
Este módulo permite tener soporte al dispositivo, permitiendo hacer las
actualizaciones de la terminal, cargar los parámetros de la inicialización de la
terminal, pedir ayuda o realizar pruebas de conexión con el administrador
web.

Para ingresar a este módulo debe ingresar la contraseña, la cual es: 123456

Ingenico document - Reproduction or disclosure prohibited without written authorization Pág. 13/13