OpReAutorizacion

El método OpReAutorizacion permite solicitar la reautorización de un cargo mediante el Gateway de Pagos de OEL.

La operación recibe las credenciales del comercio, un importe y los datos necesarios para identificar la transacción relacionada.

Este método forma parte de las operaciones de autorización del Gateway y puede utilizarse conforme a las reglas establecidas por OEL y el procesador de pagos correspondiente.

A diferencia de OpPreAutorizacion, no requiere transmitir nuevamente los datos de la tarjeta ni la información EMV de la operación original.

Importante: Esta operación renueva una autorización anterior en los casos de que el monto original debe cambiar e incrementarse o decrementarse hasta en un 20% de diferencia respecto al monto previamente confirmado mediante OpPostAutorizacion.

Información del servicio

Se recomienda utilizar TLS 1.2 o superior, conforme a los requisitos de seguridad aplicables a la integración.

Autenticación

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

Adicionalmente, el cuerpo de la solicitud contempla los parámetros comercioId y contrasena, utilizados para identificar al comercio.

Las credenciales deben mantenerse protegidas y no incorporarse en repositorios públicos, registros de diagnóstico ni ejemplos de documentación.

Parámetros de solicitud (Request)

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

Consideraciones sobre los parámetros

transaccionId

Identifica la transacción relacionada con la solicitud de reautorización. Debe utilizar el mismo identificador de la autorización original.

codigoAprobacion

Representa un código de aprobación bancaria asociado a una operación.

El WSDL lo define como string sin establecer longitud máxima ni restricciones de formato.

Debe confirmarse si el método requiere el código de aprobación original y cómo proceder cuando no se dispone de él.

monto

Representa el importe de la solicitud de reautorización.

El WSDL no establece si debe coincidir con el monto original ni si permite solicitar importes superiores o inferiores.

referencia

Permite relacionar la operación con una referencia del sistema del comercio.

Debe confirmarse si debe mantenerse la referencia original o si puede utilizarse una nueva.

Ejemplo XML Request — SOAP 1.1

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

No representa una transacción ejecutable sin credenciales válidas y los identificadores correspondientes a una operación real.

<?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>
    <OpReAutorizacion>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <modo>P</modo>
        <monto>500.00</monto>
        <transaccionId>ID_TRANSACCION</transaccionId>
        <codigoAprobacion>123456</codigoAprobacion>
        <referencia>PREAUT000001</referencia>
        <dirIp>192.0.2.10</dirIp>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpReAutorizacion>

Todos los valores son ilustrativos.

Importante: Los campos transaccionId, codigoAprobacion y referencia deben conservar los valores de la autorización original.

Para enviar la solicitud mediante SOAP 1.1, utiliza las siguientes cabeceras HTTP:

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpReAutorizacionResponse y, dentro de él, el objeto OpReAutorizacionResult, de tipo cReAutorizacionResp.

La respuesta contiene 15 parámetros.

Identificación y resultado de la operación

Información de afiliación

Ejemplo XML Response — Reautorización aprobada

El siguiente ejemplo representa una respuesta ficticia de una solicitud de reautorización aprobada.

La estructura corresponde al contrato SOAP. Los códigos y mensajes utilizados son ilustrativos y requieren validación mediante respuestas reales del servicio.

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

  <soap:Body>
    <OpReAutorizacionResponse>
      <OpReAutorizacionResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>ID_TRANSACCION</transaccionId>
        <fechaTransaccion>10/17/26</fechaTransaccion>
        <horaTransaccion>10:30:00</horaTransaccion>
        <monto>500.00</monto>
        <referencia>PREAUT000001</referencia>
        <numeroControl>CTRL000001</numeroControl>
        <codigoRespuesta>0</codigoRespuesta>
        <procReturnMsg>00</procReturnMsg>
        <ccErrorCode>0</ccErrorCode>
        <ccReturnMsg>APROBADA</ccReturnMsg>
        <codigoAprobacion>123456</codigoAprobacion>
        <afiliacion>AFILIACION_ID</afiliacion>
        <afiliacionEmpresa>EMPRESA_ID</afiliacionEmpresa>
      </OpReAutorizacionResult>
    </OpReAutorizacionResponse>

Los valores utilizados son exclusivamente ilustrativos.

En particular, el ejemplo no implica que una reautorización conserve necesariamente el mismo código de aprobación, identificador de transacción o importe de la autorización anterior.

Códigos de respuesta

Se establecen los siguientes valores para codigoRespuesta en OpReAutorizacion:

El servicio también devuelve información adicional mediante:

Consideraciones técnicas

• Operación original: conservar los identificadores y códigos de autorización necesarios para relacionar la solicitud con la transacción correspondiente.

• Elegibilidad: confirmar qué tipos de operaciones pueden reautorizarse y bajo qué condiciones.

• Importe: el monto puede modificarse hasta en un 20% con respecto a la autorización original.

• Código de aprobación: debe enviarse el código original.

• Estado de la autorización: mientras no se confirme la Aprobación de la ReAutorización, la operación original permanece vigente y sin cambio de estado.

• Seguridad: proteger las credenciales y transmitir las solicitudes mediante conexiones HTTPS seguras.

• Datos sensibles: el contrato no requiere reenviar PAN, Track 2 ni información EMV.

• Respuestas indeterminadas: ante una falla de comunicación, no asumir que la reautorización fue rechazada ni que la autorización original permanece sin cambios.

• Reintentos: evitar repetir una solicitud sin conocer su resultado y las reglas de idempotencia aplicables.

• Trazabilidad: registrar los identificadores, fechas, importes y resultados necesarios para relacionar las autorizaciones y sus operaciones posteriores.

Relación con otros métodos