API Reference

Devolución

Para efectuar la DEVOLUCIÓN de un CARGO TOTAL O PARCIAL AL TARJETAHABIENTE, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado.

Variables de Envío

VARIABLE

FORMATO

RESTRICCIONES

DESCRIPCION

comercioId

Numérico

Admite números sin espacios.

Identificador del Comercio en OPENLINEA. Es un valor asignado.

contraseña

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Clave de Acceso a la Terminal Virtual, configurado para su aplicación.

modo

Carácter

Admite una solo letra

Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada

monto

Numérico

Admite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos.

MONTO TOTAL DE LA VENTA que será el monto a DEVOLVER, este monto será calculado por su aplicación en base a la Venta previamente realizada.

transaccionId

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.

codigoAprobacion

Numérico

Admite números sin espacios

Código de Aprobación Bancaria, típicamente con 6 Dígitos

referencia

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Referencia libre de uso para su aplicación

firma

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Codigo generado que guarda la firma del tarjetahabiente

dirIP

Alfanumérico

Admite Números y Puntos

Dirección IP de quién realiza la Operación, es decir del acceso a Internet del Cliente Final o Navegante.

deviceid

Numérico

Admite números sin espacios.

Identificador del dispositivo usado para la DEVOLUCION

subcomercio

Numérico

Admite números sin espacios.

Identificador de Comercio perteneciente a algún Aliado previamente registrado en OpenLinea

version

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Version de SDK (En caso de uso)

Variables de Retorno

La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:

VARIABLE

FORMATO

RESTRICCIONES

DESCRIPCION

comercioId

Numérico

Números sin espacios

Identificador del Comercio en OPENLINEA. Es un valor asignado.

terminalid

Alfanumérico

Letras y/o números sin espacios. No mayor a 20 caracteres.

Identificador de la terminal en donde se realizo la operacion

transaccionID

Alfanumérico

Letras y/o números sin espacios. No mayor a 20 caracteres.

Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.

fechaTransaccion

Alfanumérico

Representación de fecha con formato MM/DD/AA

Fecha procesamiento de la Operación

horaTransaccion

Alfanumérico

Representación de hora con formato HH:MM:SS

Hora de procesamiento de la Operación.

monto

Numérico

Admite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos.

Monto a procesar total de la orden o pedido calculado en su aplicación en base a la selección de los servicios y/o productos del cliente.

referencia

Alfanumérico

Alfanumérico de longitud variable

Referencia libre de uso para su aplicación

numeroControl

Alfanumérico

Alfanumérico de longitud variable

Codigo retornado de identificador de transaccion

codigoRespuesta

Numérico

Números sin espacios.

Se regresa los siguientes valores:
0 = Aprobada,
1 = Rechazada

procReturnMsg

Alfanumérico

Alfanumérico de 1 a 10 caracteres

Código retornado por el procesador de la tarjeta.

ccErrorCode

Numérico

Numérico de longitud variable. No mayor a 4 caracteres.

Código devuelto por la Institución Financiera

ccReturnMsg

Alfanumérico

Alfanumérico de longitud variable

Texto específico retornado por el procesador de pagos

codigoAprobacion

Alfanumérico

Alfanumérico de longitud variable

Código de Aprobación Bancaria, típicamente con 6 Dígitos

afiliacion

Alfanumérico

Alfanumérico de longitud variable.

Numero de afiliación con la que es ejecutada la Operación.

afiliacionEmpresa

Alfanumérico

Alfanumérico de longitud variable

Numero de afiliación de la empresa con la que es ejecutada la Operación.