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
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. (Header) |
| 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. (Header) |
| codigoAprobacion | Alfanumérico | Alfanumérico de longitud variable. | Código de Aprobación Bancaria, típicamente con 6 dígitos. |
Variables de Retorno
| 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. |
| emvData | Alfanumérico | Alfanumérico de longitud variable | Retornado únicamente en transacciones realizadas con Chip, en donde el banco retorne criptogramas de autenticación |
| operType | Alfanumérico | Alfanumérico de longitud variable | Tipo de Operación ejecutada |
| cardType | Alfanumérico | Alfanumérico de longitud variable | Tipo de tarjeta con la cual se realizo el cargoIndica si la tarjeta utilizada en la transacción es de crédito o débito |
| cardBrand | Alfanumérico | Alfanumérico de longitud variable | Indica la marca de la tarjeta utilizada en la transacción |
| issuerData | Alfanumérico | Alfanumérico de longitud variable | Especifica la información que opcionalmente el banco emisor de la tarjeta con chip pudo haber retornado en la autorización. |
| issuingBank | Alfanumérico | Alfanumérico de longitud variable | Indica el nombre de la institución emisora de la tarjeta utilizada en la transacción. |
| 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) |
Valida Autorización desarrollo
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/ValidaAutorizacion/
Valida Autorización Produccion
https://servidorseguro.operacionesenlinea.com/OpenLineaRestAPI/api/ValidaAutorizacion/
