OpReversa

El método OpReversa permite solicitar la reversa de una operación de cargo mediante el Gateway de Pagos de OEL.

Esta operación se utiliza para solicitar que el procesador revierta un cargo previamente procesado, conforme a las reglas transaccionales establecidas por OEL y las instituciones financieras participantes.

Para realizar la solicitud, el comercio debe proporcionar sus credenciales de autenticación, el importe y la información necesaria para identificar la operación correspondiente.

Este método no requiere transmitir nuevamente los datos sensibles de la tarjeta ni la información EMV obtenida durante la operación original.

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 utiliza la cabecera SOAP OpHeader, con las credenciales asignadas al comercio por OEL.

Adicionalmente, el cuerpo de la solicitud contempla los campos comercioId y contrasena 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 cReversaReq, compuesto por 11 parámetros.

Los tipos y la obligatoriedad estructural se obtienen del WSDL.

Consideraciones sobre los parámetros

transaccionId

Permite identificar una transacción dentro del sistema del comercio. La solicitud de reversa requiere el mismo identificador de la operación original.

codigoAprobacion

Representa un código de aprobación bancaria asociado a una operación. Este parámetro no es aplicable cuando la transacción original presenta un resultado desconocido.

monto

Representa el importe asociado a la reversa. El servicio exige el monto exacto de la operación original, no se permite una reversa por un importe diferente.

referencia

Debe conservarse la referencia de la operación original.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra la estructura de una solicitud de reversa 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>
    <OpReversa>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <modo>P</modo>
        <monto>500.00</monto>
        <transaccionId>ID_TRANSACCION</transaccionId>
        <codigoAprobacion>123456</codigoAprobacion>
        <referencia>VENTA000001</referencia>
        <dirIp>192.0.2.10</dirIp>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpReversa>

Todos los valores son ilustrativos. El código de aprobación incluido en el ejemplo no implica que sea obligatorio ni que siempre esté disponible en una operación susceptible de reversa.

Para una solicitud SOAP 1.1, utiliza las siguientes cabeceras HTTP:

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpReversaResponse y, dentro de él, el objeto OpReversaResult, de tipo cReversaResp.

La respuesta contiene 15 parámetros.

Identificación y resultado de la operación

Información de afiliación

Ejemplo XML Response — Reversa aprobada

El siguiente ejemplo representa una respuesta ficticia de una solicitud de reversa 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>
    <OpReversaResponse>
      <OpReversaResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>ID_TRANSACCION</transaccionId>
        <fechaTransaccion>10/16/26</fechaTransaccion>
        <horaTransaccion>10:30:00</horaTransaccion>
        <monto>500.00</monto>
        <referencia>VENTA000001</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>
      </OpReversaResult>
    </OpReversaResponse>

Códigos de respuesta

La documentación de tarjeta presente de OEL establece los siguientes valores para codigoRespuesta en OpReversa:

El servicio también devuelve información del procesador mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Consideraciones técnicas

• Identificación de la operación: conservar los identificadores necesarios para relacionar la reversa con la transacción original.

• Estado de la transacción: verificar las condiciones en las que OEL permite solicitar una reversa.

• Importe: el monto debe coincidir exactamente con el de la operación original.

• Seguridad: proteger las credenciales de autenticación y utilizar 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 o un tiempo de espera agotado, no asumir automáticamente que la operación fue rechazada o revertida.

• Reintentos: evitar repetir una reversa sin conocer previamente el estado de la operación y las reglas de idempotencia del servicio.

• Conciliación: registrar los identificadores, importes, fechas y resultados necesarios para el seguimiento y la conciliación de la transacción.

Relación con otros métodos