API Reference

PreAutorizacion

Para efectuar la PRETAUTORIZACION de un CARGO 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 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

Propina

Numérico

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

Cantidad de propina que dio el 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

tarjeta

Numérico

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

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

tipo

Alfanumérico

Admite letras. Solo debe contener 2 caracteres

El Tipo de Tarjeta que se está enviando. Posibles valores:
CR = Tarjeta de Crédito
DB = Tarjeta de Débito

mes

Numérico

Admite solo números con 2 dígitos

Mes de Vencimiento de la Tarjeta de Crédito o Débito

anio

Numérico

Admite solo números con 4 dígitos

Año de Vencimiento de la Tarjeta de Crédito o Débito

digitos

Numérico

Admite solo números con 3 dígitos

Dígitos Verificadores de la Tarjeta de Crédito

titular

Alfanumérico

Admite solo Letras, Espacios y Puntos

Nombre completo del Titular tal cual aparece en la Tarjeta de Crédito

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.

AID

Alfanumérico

Alfanumérico de longitud variable

Identificador de la aplicacion para detectar que tipo de tarjeta esta siendo usada

TVR

Alfanumérico

Alfanumérico de longitud variable

Verificacion de la terminal para determinar si debe de aceptar, declinar o posponer una transaccion (Terminal Verification Results)

TSI

Alfanumérico

Alfanumérico de longitud variable

Status de la transaccion.
Puede ser "Aceptada", "En Espera" o "Cancelada"

(Transaction Status Indicator)

APN

Alfanumérico

Alfanumérico de longitud variable

Conexion a la red de datos de tu operador

AL

Alfanumérico

Alfanumérico de longitud variable

Variable que registra que la tarjeta sea valida

ARQC

Alfanumérico

Alfanumérico de longitud variable

La peticion de autorizacion en 8-Bytes recibida de la tarjeta

(Authorization Request Cryptogram)

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

deviceId

Numérico

Admite números sin espacios.

Identificador del dispositivo usado para la VENTA

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

Numérico

Números sin espacios

Identificador de la terminal usada en la transaccion.

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.

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

Numérico

Alfanumérico de longitud variable

Referencia libre de uso para su aplicación

numeroControl

Numé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.

ccErrCode

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.

tipoOperacion

Alfanumérico

Alfanumérico de longitud variable

Descripcion del tipo de operacion realizada.

tarjetaTipo

Alfanumérico

Alfanumérico de longitud variable

Tipo de tarjeta con la cual se realizo el cargo

tarjetaMarca

Alfanumérico

Alfanumérico de longitud variable

marca de la tarjeta con la cual se realizo el cargo

bancoEmisor

Alfanumérico

Alfanumérico de longitud variable

Nombre del banco encargado de realizar el cargo

auth_result

Alfanumérico

Alfanumérico de longitud variable

Resultado de la operacion

referred_card

Numérico

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

Tarjeta a la que hace referencia la venta

AID

Alfanumérico

Alfanumérico de longitud variable

Identificador de la aplicacion para detectar que tipo de tarjeta esta siendo usada

TVR

Alfanumérico

Alfanumérico de longitud variable

Es la verificacion de la terminal para determinar si debe de aceptar, declinar o posponer una transaccion (Terminal Verification Results)

TSI

Alfanumérico

Alfanumérico de longitud variable

Status de la transaccion.
Puede ser "Aceptada", "En Espera" o "Cancelada"

(Transaction Status Indicator)

APN

Alfanumérico

Alfanumérico de longitud variable

Conexion a la red de datos de tu operador

AL

Alfanumérico

Alfanumérico de longitud variable

Variable que registra que la tarjeta sea valida

ARQC

Alfanumérico

Alfanumérico de longitud variable

La peticion de autorizacion en 8-Bytes recibida de la tarjeta

(Authorization Request Cryptogram)