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.

...

Objetivo

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 tarjeta de crédito a través de datáfonos de Redeban.

Un datáfono, pasatarjetas, posnet o terminal de punto de venta es un dispositivo compacto que, instalado en un establecimiento comercial o tienda, permite cobrar a sus clientes mediante tarjeta de crédito o débito​.

Funcionamiento

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.

...

...

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.

...

Cod. Internacional → Código de establecimiento internacional

...

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.

...

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). 

...

...

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.

...

Si el usuario selecciona "Cancelar", se cierra el pop SIN eliminar el código de establecimiento.

...

Configuración de Códigos de Establecimiento

 Cuando el usuario selecciona el botón "Nuevo" se despliega una nueva pantalla de configuración.

...

• 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.

Calculos-Redeban.xlsx

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

  1. NII

  2. 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

...

• .

...