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