API Reference

Token PreAutorizacion

Procesa la Preautorizacion de un Cargo a partir del Token de una Tarjeta

Para efectuar una PREAUTORIZACION con CARGO AL TARJETAHABIENTE, deberá enviar las siguientes variables mediante
un mensaje SOAP al webservice previamente indicado el cual le permitirá procesar una transacción.

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

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.

referencia

Alfanumérico

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

Referencia libre de uso para su aplicación

token

Alfanumérico

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

TOKEN mediante el cual se identifica de forma única a la TARJETA, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de Tarjeta.

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.

diferimiento

Numérico

Admite solo números con 2 dígitos

Para compras de promoción, el número de meses que se concederá al cliente para empezar a pagar (compre hoy pague después). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 03 (pague dentro de 3 meses)

numeroPagos

Numérico

Admite solo números con 2 dígitos

Para compras de promoción, el plazo en que se diluye el pago del cliente (compras a meses con o sin intereses). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 06 (pague en seis mensualidades)

plan

Numérico

Admite solo números con 2 dígitos

Para compras de promoción, indica si ésta se hace con intereses o no al cliente. Valores posibles: 03 = Sin intereses 05 = Con intereses 07 = Sólo diferimiento inicial

subcomercio

Numérico

Admite números sin espacios.

Se envía el Identificador en caso de que este Comercio pertenezca a algún Aliado previamente registrado en OpenLinea

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.

token

Alfanumérico

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

TOKEN mediante el cual se identifica de forma única a la VENTA, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de la transaccion

tarjeta

Numérico

Admite solo 16 números sin espacios para Visa, Mastercard y American Express

Número de la Tarjeta de Crédito o Débito

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.

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

referenciaTransaccionBancaria

Alfanumérico

Alfanumérico de longitud variable.

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

Formato de envío

📘

tokenPreAutorizacion Desarrollo

https://servertest.operacionesenlinea.com/gateway/opGateway.asmx?op=tokenPreAutorizacion

📘

tokenPreAutorizacion Produccion

https://servidorseguro.operacionesenlinea.com/gateway/OpGateway.asmx?op=tokenPreAutorizacion