CARPETA DE INTEGRACIÓN DE LIBRERÍA MPOS PARA DISPOSITIVOS MÓVILES ANDROID

Transcripción

1 CARPETA DE INTEGRACIÓN DE LIBRERÍA MPOS PARA DISPOSITIVOS MÓVILES ANDROID Página 1 de 12

2 ÍNDICE 1. OBJETIVO GENERAL DEFINICIONES REQUISITOS OBLIGATORIOS PARA EL APP DEL COMERCIO SECCIÓN DE PAGOS NO DIFERENCIACIÓN ENTRE MEDIOS DE PAGO USO E IMPLEMENTACIÓN DE LOS LOGOS DE VISA PARA APPS DIAGRAMA DE ALTO NIVEL DE LA SOLUCIÓN EJEMPLO DE INTEGRACIÓN PARA ANDROID (JAVA) RESULTADO DE LA TRANSACCIÓN PARÁMETROS DE RESPUESTA RESPUESTA FINAL AL TARJETAHABIENTE AMBIENTE DE DESARROLLO PASE A PRODUCCIÓN Página 2 de 12

3 1. Objetivo General Este documento tiene como objetivo proveer los lineamientos para integrar la librería mpos, desarrollada por VisaNet del Perú, en aplicaciones móviles de comercios afiliados y a través de esta efectuar transacciones de mpos desde cualquier dispositivo con sistemas operativos Android 4.1.x (SDK 16+) o superior. 2. Definiciones Integración: Proceso de pruebas y adecuaciones para poder realizar ventas por aplicativos móviles utilizando las librerías de VisaNet Perú y cumplir con los requerimientos especificados en este documento. Sección de Pagos: Pantalla donde se selecciona el producto o servicio a cobrar. Tarjetahabiente: Persona titular de una tarjeta, en este caso, de la marca VISA. App: Es un aplicativo informático diseñado para ser ejecutado en teléfonos inteligentes, tabletas y otros dispositivos móviles. 3. Requisitos Obligatorios para el APP del Comercio 3.1. Sección de Pagos Colocar el logo de Visa según lo especificado en el punto 4. Uso e implementación de los logos de Visa para APPS No diferenciación entre medios de pago La marca VISA, sus logos y la indicación de poder pagar con medios de pago VISA no deben tener menor prominencia que otras marcas o medios de pago. 4. Uso e implementación de los logos de Visa para APPS Los logos oficiales de la marca VISA deben ser descargados desde la web del producto en la sección Descargar Logo, tal y como se muestra en la figura. Utilizar únicamente el Logo VISA (no aplica el de Verified by Visa) Página 3 de 12

4 Los logos VISA, o alguna porción de éstos, nunca deben ocultarse, distorsionarse, desfigurarse ni alterarse de manera alguna, ni aparecer con menor prominencia que otras marcas de medios de pagos. Los comercios afiliados no podrán usar las marcas ni logos propiedad de Visa de una manera que pudiera perjudicar la reputación de Visa Inc., VisaNet del Perú o cualquiera de sus afiliadas y de las Marcas Propiedad de Visa. Los comercios que no cumplan con los requisitos para la implementación y uso de los logos VISA no podrán completar la integración ni ser activados en producción. VisaNet Perú podrá revisar periódicamente el cumplimiento de los lineamientos para la implementación de logos. 5. Diagrama de Alto Nivel de la Solución La integración de los comercios afiliados a VisaNet Perú se hará a través de una librería que se conectará a la plataforma de VisaNet Perú y enviará la información de la transacción. La librería está desarrollada para la plataforma: Android 4.1.x (SDK 16+). 6. Ejemplo de Integración para Android (Java) Para poder integrar la librería en una aplicación Android se deberá seguir los siguientes pasos: 1. Consideraciones previas: a. Utilizar IDE Android Studio o superior. b. Utilizar un Smartphone o Tablet certificada por Google (Play Store instalado de fábrica) con SO Android 4.1 o superior. c. Tener activo el Bluetooth y vincular el PINPAD que VisaNet proporcionará. d. Tener conexión a Internet desde el dispositivo móvil. 2. Incluir el archivo visanetmpos.x.x.aar (donde x.x corresponde a la versión vigente) en la carpeta libs del proyecto de aplicación. Página 4 de 12

5 3. Configurar el archivo \app\build.grandle. a. Agregar las siguientes líneas en la raíz del archivo. repositories{ flatdir{ dirs 'libs' } } b. Agregar las siguientes líneas dentro de la rama dependencies. //estas 2 librerías son necesarias en la lib 2.0. compile 'com.android.support:percent:22.2.0' compile 'com.android.support:design:23.1.1' //////////////////// compile(name:'visanetmpos.2.0', ext:'aar') El archivo debe quedar similar a la imagen Página 5 de 12

6 4. Configurar el archivo \app\src\main\androidmanifest.xml a. Agregar las siguientes líneas en la raíz del archivo. <uses-permission android:name="android.permission.bluetooth" /> <uses-permission android:name="android.permission.bluetooth_admin" /> <uses-permission android:name="android.permission.access_wifi_state" /> <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_fine_location" /> <uses-permission android:name="android.permission.read_phone_state" /> <uses-permission android:name="android.permission.write_external_storage" /> <uses-permission android:name="android.permission.access_network_state" /> b. Agregar las siguientes líneas dentro de la rama aplication. <!-- VISANET activities --> <activity android:name="pe.beyond.visanet.events.authorization.authorizationactivity" android:configchanges="keyboardhidden orientation screensize" <activity android:name="pe.beyond.visanet.events.cancellation.cancellationactivity" android:configchanges="keyboardhidden orientation screensize" <activity android:name="pe.beyond.visanet.events.history.historyactivity" android:configchanges="keyboardhidden orientation screensize" <activity android:name="pe.beyond.visanet.events.initialization.initializationactivity" android:configchanges="keyboardhidden orientation screensize" <activity android:name="pe.beyond.visanet.events.linkterminal.linkterminalactivity" android:configchanges="keyboardhidden orientation screensize" 5. Definir las variables estáticas dentro de su Proyecto/Activity para indicar el ambiente al que se desea apuntar y definir el Api Key que debe utilizar. Más adelante se indican las URL de desarrollo y de producción. a. URL_VISA_MPOS b. API_KEY 6. Inicializar el manejador de la librería para poder utilizar los métodos para esto debe realizar lo siguiente: a. Definir la variable manager de tipo MPOSManagerSession. b. Inicializar la variable en el método oncreate. c. Manejo de voucher. La librería permite dos tipos de manejo de voucher: i. Generación, presentación y envío de voucher desde de la librería de VisaNet. Página 6 de 12

7 ii. Entrega de resultado a la aplicación del comercio para que está genere, presente y envíe/imprima el voucher. Para determinar el modo de trabajar se debe indicar i. manager.setisvoucherrequired(true). Para que la generación del voucher quede dentro del manejo de la librería. ii. manager.setisvoucherrequired(false) 1. Para que la librería entregue el resultado a la aplicación del comercio y esta genere el voucher. 7. Sobrescribir el método onactivityresult. 8. Invocar a los métodos de la librería. Una vez que realizó la inicialización de variables ya se puede utilizar los métodos proporcionados por la librería de VisaNet. A continuación se indican los segmentos de código de cada una de los métodos (Autorizar, Anular, Reporte de Operaciones). a. Autorizar. b. Anular. 1 Si selecciona este tipo de integración debe revisar el anexo Generación de Voucher MPOS. Página 7 de 12

8 c. Reporte de Operaciones. Nota: A partir del momento de la invocación de algún método el control pasa a la librería de VisaNet Perú. Página 8 de 12

9 9. Procesar la respuesta. Cada uno de los métodos expuestos por la librería retorna un Bean con la información de respuesta de la transacción realizada. Para cada uno de los métodos la respuesta se obtiene de la siguiente forma. a. Autorizar. b. Anular. c. Reporte de Operaciones. Página 9 de 12

10 10. Al terminar los procesos dentro de la librería el control vuelve a la aplicación del comercio. Para conocer el estado de la transacción de autorización y anulación se debe analizar el estado del campo isresponsesuccessful (true= Tx. satisfactoria y false= Tx. denegada). 7. Resultado de la Transacción 7.1. Parámetros de Respuesta Al momento que la transacción haya sido procesada, el método invocado devolverá un objeto (MPOSBean) con los siguientes parámetros: # Parámetro Descripción 1 responsecode Estado de la transacción a. Aprobado = 00, 09 u 11 b. Denegada = Otros valores 2 transactionid Identificador Único de la transacción (sólo en caso de aprobadas) 3 merchantreference Número de referencia generado por el sistema del comercio 4 bank Nombre del emisor de la tarjeta usada en el pago 5 merchantname Nombre del comercio 6 merchantid Código del comercio 7 merchantlocation Localidad del comercio 8 track2 Número de tarjeta enmascarada 9 logicalterminalid Identificación del terminal 10 batchnumber Número de Lote 11 ticketnumber Número de referencia de la transacción 12 authorizationcode Código de autorización 13 transactionlocaldate Fecha de la transacción 14 transactionlocaltime Hora de la transacción Página 10 de 12

11 15 currencylabel Moneda de la transacción 16 transactionamount Importe de la transacción 17 prizemessage Mensaje de premio. 18 hostmessage Mensaje del host. 19 tapp Etiqueta de la aplicación (este valor sólo retorna cuando la transacción se realiza con lectura de chip) 20 taid Dato AID = Application ID (este valor sólo retorna cuando la transacción se realiza con lectura de chip) 21 tct Dato CT = Criptograma (este valor sólo retorna cuando la transacción se realiza con lectura de chip) 22 version Versión utilizada 23 vouchertype Tipo de voucher: a. CREDITO b. DEBITO 24 currencycode Código de moneda 25 tracenumber Número de trace 26 statustype Estado de la transacción (AUTHORIZED, REFUNDED, DENIED) 27 processingcode Código de procesamiento = discountamount Importe de descuento 29 retrievalreferencenumber Numero de referencia de recuperación 30 terminalid Número físico del terminal 31 transactionuuid Identificador único de la transacción mpos 32 prizecode Código de premio 33 prizetype Tipo de premio 34 voucherpaymentsnumber Número de cuotas. 35 voucherpaymentsamount Valor de la cuota aproximada. 36 voucher Correo de tarjetahabiente Respuesta Final al Tarjetahabiente Una vez obtenido el resultado de la transacción, el comercio deberá mostrar la pantalla final de respuesta al cliente. La pantalla final de compra debe mostrar, cómo mínimo y obligatoriamente, la siguiente información: ID de la transacción // En caso sea aprobada la operación Resultado de la Operación (Aprobada o Denegada) Motivo de Denegación // En caso sea denegada la operación Número de Tarjeta Enmascarado (PAN) Importe Autorizado (IMP_AUTORIZADO) Página 11 de 12

12 Cuando la integración utiliza la opción de manejo de voucher manager. setisvoucherrequired(false) (ver punto 6.c del documento). Es obligatorio que el aplicativo del comercio genere, presente y envíe/imprima el voucher (para generar el voucher debe seguir los lineamientos del anexo Generación de Voucher ). Adicionalmente, se debe solicitar de manera obligatoria la firma al tarjetahabiente en el voucher. 8. Ambiente de Desarrollo Durante la etapa de integración (desarrollo) el comercio debe configurar en el código fuente el parámetro EndPointURL con la siguiente URL: 9. Pase a Producción VisaNet Perú realizará las revisiones necesarias para garantizar que el App del comercio cumpla con lo especificado en este documento antes de autorizar el pase a producción del mismo de acuerdo al procedimiento definido. Una vez terminada la etapa de integración, y con la certificación de VisaNet Perú, el comercio debe configurar en el código fuente el parámetro EndPointURL con la siguiente URL: Aplicación de Ejemplo VisaNet Perú proporcionará una aplicación de ejemplo donde se encontrá cada una de las funcionalidades explicada en el presente documento sin que ello implique alguna obligatoriedad o compromiso por parte de VisaNet Perú de entregar programas fuentes o revisar los programas fuentes del propio comercio. Página 12 de 12