API Reference

Valida Autorización

Este método permite al Comercio verificar si existe un Numero de Autorización especifico, dentro del listado de Transacciones de las últimas 48 horas.

Para efectuar una validación de un Numero de Autorización, se deberá agregar en el HEADER de la petición las credenciales necesarias para acceder al servicio, estas son comercioId y contrasena. Los cuales deberán contener los valores asignados por Operaciones en Línea al momento de generada su Afiliación.

Como parte del cuerpo del POST se deberán incluir los siguientes parámetros:

variables de envio

VARIABLEFORMATORESTRICCIONESDESCRIPCION
comercioIdNuméricoAdmite números sin espacios.Identificador del Comercio en OPENLINEA. Es un valor asignado. (Header)
contraseñaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Clave de Acceso a la Terminal Virtual, configurado para su aplicación. (Header)
codigoAprobacionAlfanuméricoAlfanumérico de longitud variable.Código de Aprobación Bancaria, típicamente con 6 dígitos.

Variables de Retorno

VARIABLEFORMATORESTRICCIONESDESCRIPCION
comercioIdNuméricoNúmeros sin espaciosIdentificador del Comercio en OPENLINEA. Es un valor asignado.
terminalIDNuméricoNúmeros sin espaciosIdentificador de la terminal usada en la transaccion.
transaccionIdAlfanuméricoLetras y/o números sin espacios. No mayor a 20 caracteresNúmero de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
transaccionIDAlfanuméricoLetras 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.
fechaTransaccionAlfanuméricoRepresentación de fecha con formato MM/DD/AAFecha procesamiento de la Operación
horaTransaccionAlfanuméricoRepresentación de hora con formato HH:MM:SSHora de procesamiento de la Operación.
montoNuméricoAdmite 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.
referenciaNuméricoAlfanumérico de longitud variableReferencia libre de uso para su aplicación
numeroControlNuméricoAlfanumérico de longitud variableCodigo retornado de identificador de transaccion
codigoRespuestaNuméricoNúmeros sin espacios.Se regresa los siguientes valores:
0 = Aprobada,
1 = Rechazada
procReturnMsgAlfanuméricoAlfanumérico de 1 a 10 caracteresCódigo retornado por el procesador de la tarjeta.
ccErrCodeNuméricoNumérico de longitud variable. No mayor a 4 caracteres.Código devuelto por la Institución Financiera
ccReturnMsgAlfanuméricoAlfanumérico de longitud variableTexto específico retornado por el procesador de pagos
codigoAprobacionAlfanuméricoAlfanumérico de longitud variableCódigo de Aprobación Bancaria, típicamente con 6 Dígitos
afiliacionAlfanuméricoAlfanumérico de longitud variableNumero de afiliación con la que es ejecutada la Operación.
afiliacionEmpresaAlfanuméricoAlfanumérico de longitud variableNumero de afiliación de la empresa con la que es ejecutada la Operación.
emvDataAlfanuméricoAlfanumérico de longitud variableRetornado únicamente en transacciones realizadas con Chip, en donde el banco retorne criptogramas de autenticación
operTypeAlfanuméricoAlfanumérico de longitud variableTipo de Operación ejecutada
cardTypeAlfanuméricoAlfanumérico de longitud variableTipo de tarjeta con la cual se realizo el cargoIndica si la tarjeta utilizada en la
transacción es de crédito o débito
cardBrandAlfanuméricoAlfanumérico de longitud variableIndica la marca de la tarjeta utilizada en la transacción
issuerDataAlfanuméricoAlfanumérico de longitud variableEspecifica la información que opcionalmente el banco emisor de la tarjeta con chip pudo haber retornado en la autorización.
issuingBankAlfanuméricoAlfanumérico de longitud variableIndica el nombre de la institución emisora de la tarjeta utilizada en la transacción.
auth_resultAlfanuméricoAlfanumérico de longitud variableResultado de la operacion
referred_cardNuméricoAdmite solo 16 números sin espacios para Visa y MastercardTarjeta a la que hace referencia la venta
AIDAlfanuméricoAlfanumérico de longitud variableIdentificador de la aplicacion para detectar que tipo de tarjeta esta siendo usada
TVRAlfanuméricoAlfanumérico de longitud variableEs la verificacion de la terminal para determinar si debe de aceptar, declinar o posponer una transaccion (Terminal Verification Results)
TSIAlfanuméricoAlfanumérico de longitud variableStatus de la transaccion.
Puede ser "Aceptada", "En Espera" o "Cancelada"

(Transaction Status Indicator)
APNAlfanuméricoAlfanumérico de longitud variableConexion a la red de datos de tu operador
ALAlfanuméricoAlfanumérico de longitud variableVariable que registra que la tarjeta sea valida
ARQCAlfanuméricoAlfanumérico de longitud variableLa peticion de autorizacion en 8-Bytes recibida de la tarjeta

(Authorization Request Cryptogram)

📘

Valida Autorización desarrollo

https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/ValidaAutorizacion/

📘

Valida Autorización Produccion

https://servidorseguro.operacionesenlinea.com/OpenLineaRestAPI/api/ValidaAutorizacion/