validaAutorizacion

El método validaAutorizacion permite consultar y validar un código de aprobación bancaria asociado a una operación procesada mediante el Gateway de Pagos de OEL.

«Valida Codigo de Autorización de las Ultimas 24 Horas»

La operación recibe el identificador del comercio, su contraseña y un código de aprobación bancaria. Como resultado, devuelve información detallada de la transacción asociada, incluyendo identificadores, importe, fecha, hora, códigos de respuesta y datos adicionales del procesamiento.

El método está orientado a la verificación de autorizaciones recientes.

Información del servicio

El nombre de la operación distingue mayúsculas y minúsculas: debe utilizarse exactamente validaAutorizacion.

Autenticación

La operación utiliza la cabecera SOAP OpHeader, mediante las credenciales asignadas al comercio por OEL.

Adicionalmente, el cuerpo de la solicitud incluye comercioId y contrasena.

Las credenciales deben mantenerse protegidas y transmitirse mediante conexiones HTTPS seguras.

Parámetros de solicitud (Request)

El método recibe un objeto request de tipo cValidaAutorizacionReq, compuesto por 3 parámetros.

Consideraciones sobre los parámetros

comercioId

Identifica al comercio bajo el cual se realizará la validación.

Debe utilizarse el identificador asignado por OEL.

contrasena

Corresponde a la contraseña de autenticación del comercio.

Debe protegerse durante su almacenamiento y transmisión.

codigoAprobacion

Es el dato principal de la consulta.

Corresponde al código de aprobación bancaria obtenido como resultado de una operación previamente procesada.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra una solicitud de validación de autorización utilizando valores ficticios y simbólicos.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns="https://servidorseguro.operacionesenlinea.com/">

  <soap:Header>
    <OpHeader>
      <OpKey1>CLAVE_1_ASIGNADA</OpKey1>
      <OpKey2>CLAVE_2_ASIGNADA</OpKey2>
    </OpHeader>
  </soap:Header>

  <soap:Body>
    <validaAutorizacion>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <codigoAprobacion>CODIGO_APROBACION_EJEMPLO</codigoAprobacion>
      </request>
    </validaAutorizacion>

Todos los valores son ilustrativos.

El código de aprobación utilizado no representa una autorización bancaria real.

Cabeceras HTTP

Para enviar la solicitud mediante SOAP 1.1:

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento validaAutorizacionResponse.

Dentro de este elemento se encuentra validaAutorizacionResult, de tipo cValidaAutorizacionResp.

La respuesta contiene 29 parámetros.

Identificación de la transacción

Los campos fechaTransaccion y horaTransaccion están definidos como string.

Nota: el WSDL no incluye un catálogo específico de códigos de respuesta para validaAutorizacion.

Información de afiliación

Información de tarjeta y procesamiento

Información EMV adicional

Los campos EMV pueden estar ausentes dependiendo del tipo de operación y de la información disponible en el Gateway.

Ejemplo XML Response — Resultado ilustrativo

El siguiente ejemplo representa una respuesta ficticia con los 29 campos definidos en cValidaAutorizacionResp.

Los códigos, mensajes y datos utilizados son exclusivamente ilustrativos. No representan una respuesta capturada del servicio ni establecen reglas oficiales de interpretación.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns="https://servidorseguro.operacionesenlinea.com/">

  <soap:Body>
    <validaAutorizacionResponse>
      <validaAutorizacionResult>
        <comercioId>12345</comercioId>
        <terminalId>TERMINAL_EJEMPLO</terminalId>
        <transaccionId>ID_TRANSACCION_ORIGINAL</transaccionId>
        <fechaTransaccion>FECHA_EJEMPLO</fechaTransaccion>
        <horaTransaccion>HORA_EJEMPLO</horaTransaccion>
        <monto>500.00</monto>
        <referencia>VENTA000001</referencia>
        <numeroControl>CONTROL_EJEMPLO</numeroControl>
        <codigoRespuesta>0</codigoRespuesta>
        <procReturnMsg>CODIGO_PROCESADOR</procReturnMsg>
        <ccErrorCode>0</ccErrorCode>
        <ccReturnMsg>MENSAJE_SIMBOLICO</ccReturnMsg>
        <codigoAprobacion>CODIGO_APROBACION_EJEMPLO</codigoAprobacion>
        <afiliacion>AFILIACION_EJEMPLO</afiliacion>
        <afiliacionEmpresa>EMPRESA_EJEMPLO</afiliacionEmpresa>
        <emvData>DATOS_EMV_SIMBOLICOS</emvData>
        <operType>TIPO_OPERACION</operType>
        <cardType>TIPO_TARJETA</cardType>
        <cardBrand>MARCA_TARJETA</cardBrand>
        <issuerData>DATOS_EMISOR_SIMBOLICOS</issuerData>
        <issuingBank>BANCO_EMISOR_EJEMPLO</issuingBank>
        <auth_result>RESULTADO_SIMBOLICO</auth_result>
        <referred_card>DATO_SIMBOLICO</referred_card>
        <aid>AID_SIMBOLICO</aid>
        <tvr>TVR_SIMBOLICO</tvr>
        <tsi>TSI_SIMBOLICO</tsi>
        <apn>APN_SIMBOLICO</apn>
        <al>AL_SIMBOLICO</al>
        <arqc>ARQC_SIMBOLICO</arqc>
      </validaAutorizacionResult>
    </validaAutorizacionResponse>

Los valores codigoRespuesta=0 y ccErrorCode=0 son ejemplos de representación de campos enteros.

Los valores de los campos EMV son marcadores simbólicos y no deben utilizarse para pruebas funcionales de procesamiento EMV.

Interpretación de la respuesta

Validación del código de aprobación

El propósito declarado del método es validar un código de aprobación de las últimas 24 horas.

La respuesta utiliza campos generales de procesamiento, principalmente codigoRespuesta, ccErrorCode, procReturnMsg y ccReturnMsg.

Por lo tanto, debe confirmarse qué combinación de valores indica que el código fue localizado y validado satisfactoriamente.

Información de la transacción

Cuando la respuesta incluye transaccionId, monto, referencia, fechaTransaccion y horaTransaccion, el integrador dispone de información para relacionar el resultado con una operación registrada en su sistema.

Ventana de 24 horas

El método valida unica y exclusivamente códigos de autorización de las últimas 24 horas.

Códigos de respuesta y errores

El método incluye los siguientes campos para comunicar el resultado del procesamiento:

Se identifica codigoRespuesta=0 como una coincidencia encontrada y codigoRespuesta=1 como rechazo y/o una busqueda sin coincidencia.

También deben contemplarse errores HTTP y fallas de protocolo SOAP.

Consideraciones técnicas

Consulta no transaccional

Por su descripción y contrato, validaAutorizacion se presenta como una operación de validación y consulta.

No requiere transmitir datos de tarjeta ni información de pago para solicitar una nueva autorización.

Identificación de la operación

La solicitud utiliza únicamente el código de aprobación y las credenciales del comercio.

Integridad de los resultados

Se recomienda comparar los datos devueltos por el Gateway con los registros internos del comercio cuando se utilice el método para verificar una operación.

En particular, pueden contrastarse transaccionId, monto, referencia y codigoAprobacion, siempre que estén presentes en la respuesta.

Manejo de errores de comunicación

Ante una falla de comunicación, el integrador no debe concluir que el código es inválido.

Debe distinguirse entre una respuesta funcional de validación y una falla de transporte o procesamiento.

Protección de información

Aunque el Request no incluye PAN ni Track 2, la respuesta puede contener información EMV y datos relacionados con la tarjeta.

Se recomienda aplicar controles de acceso y evitar registrar indiscriminadamente el contenido completo de la respuesta.

Precisión de importes

El parámetro monto está definido como decimal.

La integración debe utilizar un tipo de datos decimal adecuado para representar importes monetarios sin introducir errores de precisión.

Conservación de evidencia

Cuando se utilice para seguimiento operativo, se recomienda conservar la referencia de la consulta, los identificadores devueltos y el resultado funcional, conforme a las políticas de seguridad y retención aplicables.

Relación con otros métodos

La diferencia principal entre validaAutorizacion y OpObtenerVenta está en el criterio de búsqueda.

validaAutorizacion utiliza un código de aprobación bancaria y se limita a las últimas 24 horas.

OpObtenerVenta permite consultar una venta mediante los identificadores contemplados en su propio contrato.