Objetivo
Realizar cobros con tarjeta de crédito a través de datáfonos de Redeban.
Alcance
Incluye únicamente autorizaciones de tarjeta de crédito.
Las anulaciones se deben realizar directamente en NetOffice, al igual que la recarga de las tarjetas regalo y la redención de Puntos Colombia.
Configuraciones
1. Forma de Pago
Se debe activar la forma de pago “Tarjeta de Crédito con Datáfono” tanto en el config.XML de Netfullfilment como en el módulo de Configuración General de NetAdmin.
2. Configuración de Texto
De forma opcional, se puede configurar el nombre de la forma de pago con datáfono a través de la Configuración de Textos de NetAdmin, más precisamente en la sección “Tabs Formas de Pago (checkout)”, que se llama “Tab Tarjeta de Crédito con Datáfono”.
Adicionalmente, se pueden configurar los mensajes a mostrar en el checkout antes y después de pagar cuando la transacción resulta exitosa o fallida:
3. Permisos
Se agregaron 2 nuevos permisos dentro de la configuración de Roles en el módulo de Personas y Compañías, para determinar qué usuarios podrán registrar cobros con datáfono y cuales podrán configurar los códigos de establecimiento que va a utilizar la agencia para hacer cobros con y sin dispersión a través de datáfonos.
El primer permiso se ubica dentro de la sección “Reservas” y se llama “Registrar pagos con Datafono”:
El segundo permiso se ubica dentro de la sección “Permisos de Configuración” y se llama “Códigos de Establecimiento”:
4. Terminal por Operador
Es necesario indicar con qué equipo va a trabajar el usuario para realizar los cobrós con datáfono. Para ello se debe ingresar el código de la terminal a través del link “Indicar Datáfono Habitual” dentro de la sección “Información Adicional” del perfil de Operador en el módulo de Personas y Compañías.
Cuando el link se selecciona, se despliega un campo alfanumérico para ingresar el código del datáfono con el que trabaja el operador habitualmente:
5. Códigos de Establecimiento
Se creó una nueva pantalla de configuración para administrar los códigos de comercio de las aerolíneas a utilizar en los cobros con datáfono.
Para eso se agregó una nueva opción dentro del menú de Configuración que se llama “Códigos de Establecimiento”, la cual se encuentra visible si el usuario tiene el permiso “Códigos de Establecimiento” antes mencionado.
5.1 Consulta de Códigos de Establecimiento
Una vez el usuario selecciona “Códigos de Establecimiento” se despliega una pantalla con el resumen de todos los códigos de establecimiento registrados en el sistema.
Dicha pantalla cuenta con:
Título → Resumen de Códigos de Establecimiento
Botón “Nuevo” → Para abrir la pantalla de configuración
Filtro “Buscar” → Para localizar fácilmente códigos creados
Grilla con:
Icono de edición → Para modificar un código de establecimiento
Icono de eliminación → Para eliminar un código de establecimiento
Franquicia → Descripción de la franquicia (se configuran las franquicias a mostrar en el config de NetAdmin)
Aerolínea → Nombre de la aerolínea
Sucursal → Nombre de la sucursal
Cod. Nacional → Código de establecimiento nacional
Cod. Internacional → Código de establecimiento internacional
5.2 Edición de Códigos de Establecimiento
Cuando se presiona el ícono del lápiz en un registro de la grilla, se despliega la misma pantalla de configuración de códigos de establecimiento, con la información pre-cargada del código seleccionado.
Al consultar un código de establecimiento, se visualiza el botón “Historial“ en el menú superior.
Al seleccionarlo se despliega un popup con el historial de cambios del código.
Cada modificación cuenta con la siguiente información:
Usuario
Fecha y hora de modificación
Link “ver“ con la cantidad de cambios
Cuando se hace click en el link “ver“ se muestran los cambios realizados en el código de establecimiento de forma detallada, indicando el valor anterior y el nuevo (actualizado).
5.3 Eliminación de Códigos de Establecimiento
Cuando se presiona el ícono del cesto de residuos en un registro de la grilla, se despliega un pop up de confirmación para eliminar o no el código.
Dicho pop up tiene el siguiente texto:
“¿Desea eliminar el código de establecimiento?” y debajo un botón para confirmar la eliminación o no.
Si el usuario selecciona "Borrar", se elimina el código de establecimiento.
Si el usuario selecciona "Cancelar", se cierra el pop SIN eliminar el código de establecimiento.
5.4 Configuración de Códigos de Establecimiento
Cuando el usuario selecciona el botón "Nuevo" se despliega una nueva pantalla de configuración.
La misma cuenta con:
Botón “Volver” → Regresa al resumen donde se listan los códigos cargados
Botón “Guardar” → Graba el código de establecimiento
Botón “Borrar” → Elimina el código de establecimiento
Dropbox “Franquicia” → Listado de las marcas de tarjetas de crédito configuradas en el config de NetAdmin.
Dropbox “Aerolínea” → Listado de las aerolíneas registradas en el sistema. Si el check “Es Código de Establecimiento Propio” está en TRUE, este campo queda deshabilitado.
Dropbox “Sucursal” → Listado de las sucursales registradas en el sistema para el user service.
Campo “Código de Establecimiento Nacional” → Campo de texto para ingresar el código de establecimiento que se debe utilizar para cobrar productos nacionales.
Campo “Código de Establecimiento Internacional” → Campo de texto para ingresar el código de establecimiento que se debe utilizar para cobrar productos internacionales.
6. Credencial
Se agregó una nueva sección <CreditCardDataphone> en el config.XML de Netfulfillment para activar la forma de pago Tarjeta de Crédito con datáfono y para definir las tarjetas de crédito que aceptará:
Adicionalmente se agregó un configuración adicional, también en el config.XML de Netfulfillment, para establecer la URL de conexión con el webservice de Redeban:
Y por último, una configuración en el config.XML de NetAdmin para establecer qué franquicias se quieren mostrar en la configuración de los códigos de establecimiento:
Proceso de Pago Total con Datáfono
Una vez el usuario llega a la página de pago (checkout), y este tiene el permiso “Registrar pagos con Datafono” asignado, se despliega una nueva forma de pago en la lista de formas de pago habilitadas para la agencia que se muestra en el checkout dentro de la sección “Elija la forma de pago de su reserva”.
El nombre de este nuevo método se llama tal como lo haya definido la agencia en la configuración de textos.
En caso de no haber texto, se muestra por defecto “Pago tarjeta de crédito con datáfono”.
Cuando dicha opción se selecciona solo se muestra el campo para ingresar el tipo de tarjeta (franquicia) ya que en función de eso se buscan los códigos de establecimiento.
Adicionalmente, cuando el usuario presiona el botón de pago se muestra la página de UPaymentInformation solicitando que ingrese la tarjeta al datáfono.
En ese mismo momento se envia la trama al datáfono configurado para el usuario (en el perfil del operador).
Una vez enviada la trama, se consulta la respuesta para saber si la misma fue aprobada o rechazada.
Si la autorización fue aprobada → Se actualiza la página de pago notificando que el pago fue exitoso dándole la posibilidad al operador de consultar el display de la reserva, tal como funciona actualmente con otros medios de pago.
En este caso se graba un pago en estado “Aprobado” vinculado a la reserva, para que luego se registre el recibo en el BackOffice integrado.
Si la autorización fue rechazada → Se actualiza la página de pago notificando que su pago fue fallido dándole la posibilidad al operador de registrar un nuevo pago, tal como funciona actualmente con otros medios de pago.
En este caso se graba un pago en estado “Rechazado” vinculado a la reserva.
Consideraciones Adicionales
Como la trama del datáfono no retorna el número de la tarjeta de crédito, la emisión de los aéreos debe realizarse de forma MANUAL.
Si por algún motivo se cierra el navegador mientras se procesa el pago con datáfono, se puede recuperar la respuesta desde el display de la reserva en la sección de pagos con el link "Consultar Estado":
Cobros CON Dispersión
Para validar los montos de las transacciones MULTIPOS, se adjunta el siguiente excel con los cálculos establecidos para la integración.
Información Técnica sobre la Integración
NetSuite consume un webservice de SIP Colombia.
Ese webservice envía la trama al applicativo de SIPPOS y luego SIPPOS es quien se comunica con el datáfono para autorizar la transacción.
Solicitud de Compra
La trama de "compra" tiene la siguiente información:
Operación: Siempre 0 (0=Compra)
Monto: importe de la transacción
IVA: IVA de la transacción
Número de factura: Id de itinerario
Base de devolución:
Código de cajero: Código del Datafono (terminal)
Impuesto al Consumo: Monto del ImpoConsumo
Operación Multipos: 1=Si | 0=No
Código Único Aerolínea: Código de establecimiento de la aerolína para dispersión
Tasa Aeroportuaria:
Factura Administrativa:
Tarifa Administrativa: Monto del Fee
IVA Administrativa: IVA del Fee
Ejemplo:
La información que tiene el mensaje de solicitud es:
0,15630,2500,1234567,10630,987653,0,1,10203040,13000,7654321,5000,700
Respuesta de Compra
En esta cadena de mensaje, el programa interno del POS recibe la información del tipo de operación y los datos de la operación en la forma:
Respuesta
Código de aprobación
Bin+ asteriscos + 4 últimos dígitos de la tarjeta
Tipo de cuenta (AH, CC, CR)
Franquicia
Monto de la transacción
IVA de la transacción
Base de Devolución
Número de Recibo en el datáfono
Número de cuotas
Consecutivo de transacción (RRN)
digo Único Aerolínea
Número de Terminal
Valor habilitación de Bono
Número de Punto redimidos
Campo de libre propósito
Identificador de Lealtad
Fecha
Hora
RespuestaAdmin
Código de aprobaciónAdmin
Bin+ asteriscos + 4 últimos dígitos de la tarjeta Admin
Tipo de cuenta Admin(AH, CC, CR)
Franquicia Admin
Tarifa Administrativa
Número de cuotas Admin
Consecutivo de transacción admin(RRN)
Fecha oper Admin
Hora operacion admin
Donde "Respuesta" tiene los valores:
00 – Aprobada
01 – Declinada
02 – Pin Incorrecto
03 – Clave Supervisor Inválida
04 – Entidad no responde
99 – Error
Ejemplo:
Esta es una cadena de respuesta de una transaccióm "Aprobada"
00,001234,5400836407,AH,MASTERCARD,000000150630,00000020500,0000 0010630,12345,12,000001,10203040,1G508001,,,,,20150801075428,00,001236 ,5400836407,AH,MASTERCARD,000000005000,1,000002,20150801075748
Esta es una cadena de respuesta si la primera transacción es "Rechazada"
01,000000,540083**6407,AH,MASTERCARD,000000150630,00000020500,0000 0010630,,,10203040,1G508001,,,,,20150801075428,,,,,,,,,
Esta es una cadena de respuesta si la segunda transacción es "Rechazada"
00,001234,5400836407,AH,MASTERCARD,000000150630,00000020500,0000 0010630,12345,12,000001,10203040,1G508001,,,,,20150801075428,01,000000 , 5400836407,AH,MASTERCARD,000000005000,,, TEC010 SecureCode: 0012T3F-S1P05
Este es un mensaje que se presenta para fallas o tiempo excedidos. Todo código de respuesta que tenga 99, es una falla que se explica en el texto después de la “,” (coma)
99, Time Out
Nota: Cuando los campos no aplican en la respuesta, estos mantienen su posición en vacío, es decir el valor se separa con comas tenga o no tenga datos.
Procesos manuales en el Datafono
Clave Supervisor: 0000 y 1526
Clave admin: 028510
Para cambiar los NII F3 > Administrar > 028510 > Terminal
NII
Nii Multipos
Para activar el módulo de caja: Oprimes la pantalla > Seleccionas F3 > La opción 2.Ver > Clave del equipo = 0000 > Seleccionas la opción 6.Caja > Pregunta ¿Desea habilitar caja registradora? > Confirma con tecla verde > Pregunta ¿Desea habilitar código de cajero? > Confirma con tecla verde > Pregunta ¿Desea habilitar recarga en efectivo? > Rechaza con tecla roja > En la siguiente pantalla seleccionas 1. Caja Serial
Para salir del módulo de caja: Oprimes la pantalla > Seleccionas F3 > La opción 2.Ver > Clave del equipo = 0000 o 1526 > Seleccionas la opción 6.Caja > Pregunta ¿Desea deshabilitar caja registradora? > Confirma con tecla verde
Para testear la comunicacion F3 > Test 1. Comunicacion
Para hacer ventas desde el datafono sin integracion F2 > Venta > 1. Venta > 5. Multipos
Para anular un pago en el datafono F2 > Opcion 6:Anulación
Para borrar un reverso F3 > Administrar > clave admin= 028510 > opcion 19: Borrar Rev
Payloads
Las transacciones generan un log en Provider Payloads.
Allí se escriben los siguientes archivos:
Escribir Solicitud: Envío de la trama
Leer Respuesta: Respuesta de la transacción
Ejemplo de EscribirSolicitud:
Donde:
Ejemplo de Respuesta:
00,HOME01,540625** 2307,CR,MASTERCARD,133800,4800,0,000261,1,651168,00010002038,EMV00099,0,0,0,,,,00,HOME01,540625**2307,CR,MASTERCARD,14800,2,856704,,,000262
Donde los campos son:
Respuesta
Código de aprobación
Bin+ asteriscos + 4 últimos dígitos de la tarjeta
Tipo de cuenta (AH, CC, CR)
Franquicia
Monto de la transacción
IVA de la transacción
Base de Devolución
Número de Recibo en el datáfono
Número de cuotas
Consecutivo de transacción (RRN)
Código Único Aerolínea
Número de Terminal
Valor habilitación de Bono
Número de Punto redimidos
Campo de libre propósito
Identificador de Lealtad
Fecha
Hora
RespuestaAdmin
Código de aprobaciónAdmin
Bin+ asteriscos + 4 últimos dígitos de la tarjeta Admin
Tipo de cuenta Admin(AH, CC, CR)
Franquicia Admin
Tarifa Administrativa
Número de cuotas Admin
Consecutivo de transacción admin(RRN)
Fecha oper Admin
Hora operacion admin
La respuesta puede tener los siguientes valores:
00 – Aprobada
01 – Declinada
02 – Pin Incorrecto
03 – Clave Supervisor Inválida
04 – Entidad no responde
99 – Error
Contacto del Proveedor
Rendon Giraldo Wilson Eduardo