OpCancelacion

El método OpCancelacion permite solicitar la cancelación de una operación de cargo previamente procesada mediante el Gateway de Pagos de OEL.

Este método está orientado a operaciones en las que el comercio necesita cancelar un cargo anterior, sujeto a las condiciones y reglas de procesamiento 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 transacción que desea cancelar.

A diferencia de OpVenta, este método no requiere transmitir nuevamente los datos sensibles de la tarjeta ni la información EMV obtenida durante la operación original.

Importante: la cancelación está sujeta a las reglas del procesador de pagos.

Información del servicio

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 debe incluir los parámetros comercioId y contrasena, utilizados para identificar al comercio que solicita la cancelación.

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 cCancelacionReq, compuesto por 12 parámetros.

Consideraciones sobre los parámetros

transaccionId

Permite identificar la transacción dentro del sistema del comercio.

Para procesar una cancelación es necesario relacionar la solicitud con el cargo correspondiente. Se debe utilizar el mismo identificador de la venta original.

codigoAprobacion

Representa el código de aprobación bancaria asociado a la operación. Este parámetro es obligatorio para cancelar una venta.

monto

Representa el importe asociado a la solicitud de cancelación. Debe enviar exactamente el importe del cargo original.

firma

Debe recabarse la firma manuscrita del tarjetahabiente y enviarse mediante este campo.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo ilustra una solicitud de cancelació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>
    <OpCancelacion>
      <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>
        <firma>FIRMA_SEGUN_ESPECIFICACION_OEL</firma>
        <dirIp>192.0.2.10</dirIp>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpCancelacion>

Los valores son exclusivamente ilustrativos. El campo firma contiene un marcador simbólico y no representa una firma válida.

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 OpCancelacionResponse y, dentro de él, el objeto OpCancelacionResult, de tipo cCancelacionResp.

La respuesta está compuesta por 15 parámetros.

Identificación y resultado de la operación

Información de afiliación

Ejemplo XML Response — Cancelación aprobada

El siguiente ejemplo representa una respuesta ficticia de una solicitud de cancelació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>
    <OpCancelacionResponse>
      <OpCancelacionResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>ID_TRANSACCION</transaccionId>
        <fechaTransaccion>10/15/26</fechaTransaccion>
        <horaTransaccion>14: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>
      </OpCancelacionResult>
    </OpCancelacionResponse>

Códigos de respuesta

Se establecen los siguientes posibles valores paracodigoRespuesta del método:

Estos valores se presentan como referencia y deben confirmarse específicamente para OpCancelacion.

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

Consideraciones técnicas

• Operación original: la solicitud de cancelación debe identificar correctamente el cargo que se desea cancelar.

• Importe: verificar que el monto enviado cumpla con las condiciones establecidas por el procesador.

• Elegibilidad: confirmar las condiciones bajo las cuales una operación puede cancelarse, especialmente si ya fue incluida en un proceso de cierre o liquidación.

• Código de aprobación: conservar el código devuelto durante la autorización original cuando corresponda.

• Firma: validar en que condiciones debe recabarse la firma autografa del Tarjetahabiente.

• Seguridad: proteger las credenciales de autenticación y transmitir las solicitudes exclusivamente mediante HTTPS.

• Datos sensibles: este método no requiere reenviar el PAN, Track 2 ni los datos EMV de la tarjeta.

• Control de duplicados: ante una respuesta indeterminada, verificar el estado de la operación antes de intentar nuevamente la cancelación.

• Conciliación: conservar los identificadores, fechas, importes y resultados necesarios para la trazabilidad y conciliación de las operaciones.

Relación con otros métodos