OpTransacciones - Doks Framer Template

El servicio recibe información de autenticación, un intervalo de fechas y parámetros adicionales para consultar las operaciones asociadas a un comercio.

La respuesta contiene una colección de transacciones, cada una con información sobre el comercio, importe, resultado del procesamiento, referencias, fechas y otros datos relacionados con la operación.

Este método puede utilizarse como parte de los procesos de consulta, seguimiento de operaciones, elaboración de reportes y conciliación del comercio.

Importante: el WSDL no especifica el límite máximo de resultados, las reglas de paginación, la interpretación exacta del filtro transaccionId ni si los límites del intervalo de fechas son inclusivos. Estas condiciones deben confirmarse con OEL.

Información del servicio

Propiedad	Valor
Método	`OpTransacciones`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpTransacciones`
Request	`cTransaccionesReq`
Response	`ArrayOfTransaccion`
Elemento de colección	`Transaccion`

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, mediante las credenciales asignadas al comercio por OEL.

Parámetro	Descripción
`OpKey1`	Primera clave de autenticación del servicio.
`OpKey2`	Segunda clave de autenticación del servicio.

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

Las credenciales deben protegerse 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 cTransaccionesReq, compuesto por 8 parámetros.

Parámetro	Tipo WSDL	Requerido	Descripción
`comercioId`	int	Sí	Identificador único del comercio asignado por OEL.
`contrasena`	string	Sí	Contraseña de acceso al Gateway de Pagos asignada al comercio.
`transaccionId`	string	No	Identificador de transacción el cual funciona como filtro.
`FechaInicio`	dateTime	Sí	Fecha y hora iniciales del intervalo solicitado.
`FechaFin`	dateTime	Sí	Fecha y hora finales del intervalo solicitado.
`deviceId`	string	No	Identificador del dispositivo asociado a las operaciones, el cual funciona como filtro.
`subcomercio`	string	No	Identificador de un subcomercio asociado al comercio principal, cuando corresponda.
`version`	string	No	Versión del SDK utilizado para realizar la consulta, cuando corresponda.

Consideraciones sobre los parámetros

FechaInicio y FechaFin

Ambos campos utilizan el tipo XML Schema dateTime.

Un ejemplo de representación válida es:

2026-10-01T00:00:00

transaccionId

El campo permite proporcionar un identificador de transacción.

Este campo se utiliza para filtrar los resultados, la búsqueda es exacta y se combina con las fechas de inicio y fin.

deviceId

Identifica un dispositivo asociado a las operaciones, este se utiliza para filtrar los resultados y se combina con las fechas de inicio y fin.

subcomercio

Permite proporcionar un identificador de subcomercio.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra una solicitud de consulta de transacciones para un intervalo de fechas, 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>
    <OpTransacciones>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <FechaInicio>2026-10-01T00:00:00</FechaInicio>
        <FechaFin>2026-10-02T00:00:00</FechaFin>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpTransacciones>

En este ejemplo se omite transaccionId, ya que el esquema permite hacerlo. Las fechas representan un intervalo ilustrativo.

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

Estructura de respuesta (Response)

El servicio devuelve un mensaje SOAP con el elemento OpTransaccionesResponse.

Dentro de este elemento se encuentra OpTransaccionesResult, de tipo ArrayOfTransaccion.

La colección puede contener cero o más elementos Transaccion, cada uno definido por un objeto con 38 campos.

La estructura conceptual es:

El WSDL permite que la colección esté ausente o vacía y que los elementos individuales sean nulos. Los integradores deben contemplar estas posibilidades al procesar la respuesta.

Parámetros de cada transacción

Identificación y clasificación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio asociado a la transacción.
`comercio`	string	Información identificativa del comercio.
`tipoMovimiento`	string	Clasificación del movimiento registrado.
`origenTransaccion`	string	Origen de la transacción.
`CanalTransaccion`	string	Canal asociado al procesamiento de la transacción.
`transaccionId`	string	Identificador de la transacción registrada.
`resultado`	string	Información textual relacionada con el resultado de la operación.
`referencia`	string	Referencia asociada a la transacción.
`referenciaComercio`	string	Referencia perteneciente al comercio.
`codigoAprobacion`	string	Código de aprobación bancaria asociado a la operación.

Información financiera y resultado

Parámetro	Tipo WSDL	Descripción
`monto`	decimal	Importe registrado para la transacción.
`propina`	decimal	Importe registrado en concepto de propina.
`comision`	decimal	Importe identificado como comisión de la operación.
`iva`	decimal	Importe identificado como IVA.
`codigoRespuesta`	int	Código de respuesta asociado a la transacción.

Fechas de la transacción

Parámetro	Tipo WSDL	Descripción
`fechaTransaccion`	string	Fecha asociada al procesamiento de la operación.
`horaTransaccion`	string	Hora asociada al procesamiento de la operación.
`fechaRegistro`	dateTime	Fecha y hora de registro de la transacción.
`fechaTransferencia`	dateTime, nillable	Fecha y hora de transferencia, cuando exista un valor registrado.

fechaTransferencia admite explícitamente valores nulos mediante xsi:nil="true".

Información de tarjeta y afiliación

Parámetro	Tipo WSDL	Descripción
`tarjeta`	string	Dato de tarjeta asociado a la transacción. Este valor se encuentra enmascarado.
`titular`	string	Información del titular de la tarjeta.
`mes`	string	Mes de vencimiento de la tarjeta, cuando corresponda.
`anio`	string	Año de vencimiento de la tarjeta, cuando corresponda.
`emisor`	string	Información del emisor de la tarjeta.
`marca`	string	Marca de la tarjeta.
`tipo`	string	Clasificación de la tarjeta.
`afiliacion`	string	Identificador de afiliación asociado a la operación.

Información EMV

Parámetro	Tipo WSDL	Descripción
`AID`	string	Application Identifier. Identificador de la aplicación de pago.
`TVR`	string	Terminal Verification Results. Resultados de verificación de la terminal.
`TSI`	string	Transaction Status Information. Información del estado del procesamiento EMV.
`APN`	string	Application Preferred Name. Nombre preferido de la aplicación de pago.
`AL`	string	Application Label. Etiqueta de la aplicación de pago.
`ARQC`	string	Application Request Cryptogram. Criptograma de solicitud de autorización, cuando corresponda.

Información adicional

Parámetro	Tipo WSDL	Descripción
`firmado`	int, nillable	Indicador denominado `firmado`. Sus valores y significado operativo deben confirmarse con OEL.
`usuario`	string	Identificador o información del usuario asociado a la operación.
`serieLector`	string	Serie del lector asociado a la transacción, cuando corresponda.
`subComercio`	string	Información del subcomercio asociado a la transacción.
`version`	string	Versión registrada para la operación.

Nota: subComercio utiliza una C mayúscula en el objeto de respuesta, mientras que el parámetro Request se denomina subcomercio.

XML distingue entre mayúsculas y minúsculas, por lo que deben respetarse los nombres exactos.

Ejemplo XML Response — Listado de transacciones

El siguiente ejemplo representa una respuesta ficticia que contiene dos transacciones.

Se incluyen los campos obligatorios y algunos opcionales para ilustrar la estructura. No se muestran datos reales de tarjeta ni criptogramas EMV.

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

  <soap:Body>
    <OpTransaccionesResponse>
      <OpTransaccionesResult>

Los valores utilizados son exclusivamente ilustrativos.

En particular:

tipoMovimiento y resultado contienen marcadores simbólicos.
codigoRespuesta=0 se utiliza como valor de ejemplo, sin confirmar su interpretación específica en este método.
firmado=1 no implica un significado funcional determinado.
Los importes de comisión e IVA no representan una tarifa ni una fórmula de cálculo oficial.
Las fechas de registro y transferencia son ficticias y no establecen un plazo real de liquidación.

Interpretación de la respuesta

Colección de transacciones

La respuesta puede contener múltiples elementos Transaccion.

El integrador debe recorrer la colección y procesar cada elemento individualmente, contemplando que algunos campos opcionales podrían estar ausentes.

Resultado de cada operación

El parámetro codigoRespuesta permite identificar el resultado de cada transacción.

Código	Descripción en `OpVenta`
`0`	Operación aprobada
`1`	Operación rechazada

Fechas y conciliación

El método devuelve tres conceptos temporales diferentes:

Fecha y hora de la transacción.
Fecha de registro.
Fecha de transferencia.

Estas fechas pueden resultar útiles para los procesos de conciliación,fechaTransferencia corresponde a la fecha de liquidación bancaria definitiva.

Consideraciones técnicas

Intervalos de consulta: confirmar el rango máximo de fechas admitido.
Volumen de resultados: verificar si existen límites de registros, paginación o restricciones de tamaño de respuesta.
Filtros opcionales: confirmar cómo se aplican transaccionId, deviceId y subcomercio.
Campos opcionales: implementar el procesamiento de respuestas que omitan elementos no obligatorios.
Valores nulos: manejar correctamente xsi:nil="true" en fechaTransferencia y firmado.
Datos sensibles: proteger la información de tarjeta y los campos EMV que puedan formar parte de la respuesta.
Seguridad: utilizar HTTPS y mantener protegidas las credenciales de autenticación.
Conciliación: no asumir fórmulas de cálculo de comisiones, IVA o montos netos sin la especificación correspondiente.
Control de duplicados: utilizar identificadores adecuados para evitar duplicar registros al importar resultados de consultas sucesivas.
Seguimiento: relacionar los resultados con las operaciones originales almacenadas por el comercio.

Relación con otros métodos

Método	Función
`OpVenta`	Solicita procesar una venta.
`OpObtenerVenta`	Consulta el estado actual de una venta específica.
`OpTransacciones`	Obtiene un listado de transacciones.
`OpCortesDiarios`	Permite consultar información de cortes diarios, conforme a su contrato.
`OpEstadoCuenta`	Permite consultar información de estado de cuenta, conforme a su contrato.

El método OpTransacciones permite obtener un listado de transacciones registradas en el Gateway de Pagos de OEL.

El servicio recibe información de autenticación, un intervalo de fechas y parámetros adicionales para consultar las operaciones asociadas a un comercio.

Este método puede utilizarse como parte de los procesos de consulta, seguimiento de operaciones, elaboración de reportes y conciliación del comercio.

Información del servicio

Propiedad	Valor
Método	`OpTransacciones`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpTransacciones`
Request	`cTransaccionesReq`
Response	`ArrayOfTransaccion`
Elemento de colección	`Transaccion`

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, mediante las credenciales asignadas al comercio por OEL.

Parámetro	Descripción
`OpKey1`	Primera clave de autenticación del servicio.
`OpKey2`	Segunda clave de autenticación del servicio.

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

Las credenciales deben protegerse 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 cTransaccionesReq, compuesto por 8 parámetros.

Parámetro	Tipo WSDL	Requerido	Descripción
`comercioId`	int	Sí	Identificador único del comercio asignado por OEL.
`contrasena`	string	Sí	Contraseña de acceso al Gateway de Pagos asignada al comercio.
`transaccionId`	string	No	Identificador de transacción el cual funciona como filtro.
`FechaInicio`	dateTime	Sí	Fecha y hora iniciales del intervalo solicitado.
`FechaFin`	dateTime	Sí	Fecha y hora finales del intervalo solicitado.
`deviceId`	string	No	Identificador del dispositivo asociado a las operaciones, el cual funciona como filtro.
`subcomercio`	string	No	Identificador de un subcomercio asociado al comercio principal, cuando corresponda.
`version`	string	No	Versión del SDK utilizado para realizar la consulta, cuando corresponda.

Consideraciones sobre los parámetros

FechaInicio y FechaFin

Ambos campos utilizan el tipo XML Schema dateTime.

Un ejemplo de representación válida es:

2026-10-01T00:00:00

transaccionId

El campo permite proporcionar un identificador de transacción.

Este campo se utiliza para filtrar los resultados, la búsqueda es exacta y se combina con las fechas de inicio y fin.

deviceId

Identifica un dispositivo asociado a las operaciones, este se utiliza para filtrar los resultados y se combina con las fechas de inicio y fin.

subcomercio

Permite proporcionar un identificador de subcomercio.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra una solicitud de consulta de transacciones para un intervalo de fechas, 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>
    <OpTransacciones>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <FechaInicio>2026-10-01T00:00:00</FechaInicio>
        <FechaFin>2026-10-02T00:00:00</FechaFin>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpTransacciones>

En este ejemplo se omite transaccionId, ya que el esquema permite hacerlo. Las fechas representan un intervalo ilustrativo.

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

Estructura de respuesta (Response)

El servicio devuelve un mensaje SOAP con el elemento OpTransaccionesResponse.

Dentro de este elemento se encuentra OpTransaccionesResult, de tipo ArrayOfTransaccion.

La colección puede contener cero o más elementos Transaccion, cada uno definido por un objeto con 38 campos.

La estructura conceptual es:

El WSDL permite que la colección esté ausente o vacía y que los elementos individuales sean nulos. Los integradores deben contemplar estas posibilidades al procesar la respuesta.

Parámetros de cada transacción

Identificación y clasificación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio asociado a la transacción.
`comercio`	string	Información identificativa del comercio.
`tipoMovimiento`	string	Clasificación del movimiento registrado.
`origenTransaccion`	string	Origen de la transacción.
`CanalTransaccion`	string	Canal asociado al procesamiento de la transacción.
`transaccionId`	string	Identificador de la transacción registrada.
`resultado`	string	Información textual relacionada con el resultado de la operación.
`referencia`	string	Referencia asociada a la transacción.
`referenciaComercio`	string	Referencia perteneciente al comercio.
`codigoAprobacion`	string	Código de aprobación bancaria asociado a la operación.

Información financiera y resultado

Parámetro	Tipo WSDL	Descripción
`monto`	decimal	Importe registrado para la transacción.
`propina`	decimal	Importe registrado en concepto de propina.
`comision`	decimal	Importe identificado como comisión de la operación.
`iva`	decimal	Importe identificado como IVA.
`codigoRespuesta`	int	Código de respuesta asociado a la transacción.

Fechas de la transacción

Parámetro	Tipo WSDL	Descripción
`fechaTransaccion`	string	Fecha asociada al procesamiento de la operación.
`horaTransaccion`	string	Hora asociada al procesamiento de la operación.
`fechaRegistro`	dateTime	Fecha y hora de registro de la transacción.
`fechaTransferencia`	dateTime, nillable	Fecha y hora de transferencia, cuando exista un valor registrado.

fechaTransferencia admite explícitamente valores nulos mediante xsi:nil="true".

Información de tarjeta y afiliación

Parámetro	Tipo WSDL	Descripción
`tarjeta`	string	Dato de tarjeta asociado a la transacción. Este valor se encuentra enmascarado.
`titular`	string	Información del titular de la tarjeta.
`mes`	string	Mes de vencimiento de la tarjeta, cuando corresponda.
`anio`	string	Año de vencimiento de la tarjeta, cuando corresponda.
`emisor`	string	Información del emisor de la tarjeta.
`marca`	string	Marca de la tarjeta.
`tipo`	string	Clasificación de la tarjeta.
`afiliacion`	string	Identificador de afiliación asociado a la operación.

Información EMV

Parámetro	Tipo WSDL	Descripción
`AID`	string	Application Identifier. Identificador de la aplicación de pago.
`TVR`	string	Terminal Verification Results. Resultados de verificación de la terminal.
`TSI`	string	Transaction Status Information. Información del estado del procesamiento EMV.
`APN`	string	Application Preferred Name. Nombre preferido de la aplicación de pago.
`AL`	string	Application Label. Etiqueta de la aplicación de pago.
`ARQC`	string	Application Request Cryptogram. Criptograma de solicitud de autorización, cuando corresponda.

Información adicional

Parámetro	Tipo WSDL	Descripción
`firmado`	int, nillable	Indicador denominado `firmado`. Sus valores y significado operativo deben confirmarse con OEL.
`usuario`	string	Identificador o información del usuario asociado a la operación.
`serieLector`	string	Serie del lector asociado a la transacción, cuando corresponda.
`subComercio`	string	Información del subcomercio asociado a la transacción.
`version`	string	Versión registrada para la operación.

Nota: subComercio utiliza una C mayúscula en el objeto de respuesta, mientras que el parámetro Request se denomina subcomercio.

XML distingue entre mayúsculas y minúsculas, por lo que deben respetarse los nombres exactos.

Ejemplo XML Response — Listado de transacciones

El siguiente ejemplo representa una respuesta ficticia que contiene dos transacciones.

Se incluyen los campos obligatorios y algunos opcionales para ilustrar la estructura. No se muestran datos reales de tarjeta ni criptogramas EMV.

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

  <soap:Body>
    <OpTransaccionesResponse>
      <OpTransaccionesResult>

Los valores utilizados son exclusivamente ilustrativos.

En particular:

tipoMovimiento y resultado contienen marcadores simbólicos.
codigoRespuesta=0 se utiliza como valor de ejemplo, sin confirmar su interpretación específica en este método.
firmado=1 no implica un significado funcional determinado.
Los importes de comisión e IVA no representan una tarifa ni una fórmula de cálculo oficial.
Las fechas de registro y transferencia son ficticias y no establecen un plazo real de liquidación.

Interpretación de la respuesta

Colección de transacciones

La respuesta puede contener múltiples elementos Transaccion.

El integrador debe recorrer la colección y procesar cada elemento individualmente, contemplando que algunos campos opcionales podrían estar ausentes.

Resultado de cada operación

El parámetro codigoRespuesta permite identificar el resultado de cada transacción.

Código	Descripción en `OpVenta`
`0`	Operación aprobada
`1`	Operación rechazada

Fechas y conciliación

El método devuelve tres conceptos temporales diferentes:

Fecha y hora de la transacción.
Fecha de registro.
Fecha de transferencia.

Estas fechas pueden resultar útiles para los procesos de conciliación,fechaTransferencia corresponde a la fecha de liquidación bancaria definitiva.

Consideraciones técnicas

Intervalos de consulta: confirmar el rango máximo de fechas admitido.
Volumen de resultados: verificar si existen límites de registros, paginación o restricciones de tamaño de respuesta.
Filtros opcionales: confirmar cómo se aplican transaccionId, deviceId y subcomercio.
Campos opcionales: implementar el procesamiento de respuestas que omitan elementos no obligatorios.
Valores nulos: manejar correctamente xsi:nil="true" en fechaTransferencia y firmado.
Datos sensibles: proteger la información de tarjeta y los campos EMV que puedan formar parte de la respuesta.
Seguridad: utilizar HTTPS y mantener protegidas las credenciales de autenticación.
Conciliación: no asumir fórmulas de cálculo de comisiones, IVA o montos netos sin la especificación correspondiente.
Control de duplicados: utilizar identificadores adecuados para evitar duplicar registros al importar resultados de consultas sucesivas.
Seguimiento: relacionar los resultados con las operaciones originales almacenadas por el comercio.

Relación con otros métodos

Método	Función
`OpVenta`	Solicita procesar una venta.
`OpObtenerVenta`	Consulta el estado actual de una venta específica.
`OpTransacciones`	Obtiene un listado de transacciones.
`OpCortesDiarios`	Permite consultar información de cortes diarios, conforme a su contrato.
`OpEstadoCuenta`	Permite consultar información de estado de cuenta, conforme a su contrato.

El método OpTransacciones permite obtener un listado de transacciones registradas en el Gateway de Pagos de OEL.

El servicio recibe información de autenticación, un intervalo de fechas y parámetros adicionales para consultar las operaciones asociadas a un comercio.

Este método puede utilizarse como parte de los procesos de consulta, seguimiento de operaciones, elaboración de reportes y conciliación del comercio.

Información del servicio

Propiedad	Valor
Método	`OpTransacciones`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpTransacciones`
Request	`cTransaccionesReq`
Response	`ArrayOfTransaccion`
Elemento de colección	`Transaccion`

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, mediante las credenciales asignadas al comercio por OEL.

Parámetro	Descripción
`OpKey1`	Primera clave de autenticación del servicio.
`OpKey2`	Segunda clave de autenticación del servicio.

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

Las credenciales deben protegerse 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 cTransaccionesReq, compuesto por 8 parámetros.

Parámetro	Tipo WSDL	Requerido	Descripción
`comercioId`	int	Sí	Identificador único del comercio asignado por OEL.
`contrasena`	string	Sí	Contraseña de acceso al Gateway de Pagos asignada al comercio.
`transaccionId`	string	No	Identificador de transacción el cual funciona como filtro.
`FechaInicio`	dateTime	Sí	Fecha y hora iniciales del intervalo solicitado.
`FechaFin`	dateTime	Sí	Fecha y hora finales del intervalo solicitado.
`deviceId`	string	No	Identificador del dispositivo asociado a las operaciones, el cual funciona como filtro.
`subcomercio`	string	No	Identificador de un subcomercio asociado al comercio principal, cuando corresponda.
`version`	string	No	Versión del SDK utilizado para realizar la consulta, cuando corresponda.

Consideraciones sobre los parámetros

FechaInicio y FechaFin

Ambos campos utilizan el tipo XML Schema dateTime.

Un ejemplo de representación válida es:

2026-10-01T00:00:00

transaccionId

El campo permite proporcionar un identificador de transacción.

Este campo se utiliza para filtrar los resultados, la búsqueda es exacta y se combina con las fechas de inicio y fin.

deviceId

Identifica un dispositivo asociado a las operaciones, este se utiliza para filtrar los resultados y se combina con las fechas de inicio y fin.

subcomercio

Permite proporcionar un identificador de subcomercio.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra una solicitud de consulta de transacciones para un intervalo de fechas, 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>
    <OpTransacciones>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <FechaInicio>2026-10-01T00:00:00</FechaInicio>
        <FechaFin>2026-10-02T00:00:00</FechaFin>
        <deviceId>12345678</deviceId>
        <subcomercio>SUBCOMERCIO_ID</subcomercio>
        <version>VERSION_SDK</version>
      </request>
    </OpTransacciones>

En este ejemplo se omite transaccionId, ya que el esquema permite hacerlo. Las fechas representan un intervalo ilustrativo.

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

Estructura de respuesta (Response)

El servicio devuelve un mensaje SOAP con el elemento OpTransaccionesResponse.

Dentro de este elemento se encuentra OpTransaccionesResult, de tipo ArrayOfTransaccion.

La colección puede contener cero o más elementos Transaccion, cada uno definido por un objeto con 38 campos.

La estructura conceptual es:

El WSDL permite que la colección esté ausente o vacía y que los elementos individuales sean nulos. Los integradores deben contemplar estas posibilidades al procesar la respuesta.

Parámetros de cada transacción

Identificación y clasificación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio asociado a la transacción.
`comercio`	string	Información identificativa del comercio.
`tipoMovimiento`	string	Clasificación del movimiento registrado.
`origenTransaccion`	string	Origen de la transacción.
`CanalTransaccion`	string	Canal asociado al procesamiento de la transacción.
`transaccionId`	string	Identificador de la transacción registrada.
`resultado`	string	Información textual relacionada con el resultado de la operación.
`referencia`	string	Referencia asociada a la transacción.
`referenciaComercio`	string	Referencia perteneciente al comercio.
`codigoAprobacion`	string	Código de aprobación bancaria asociado a la operación.

Información financiera y resultado

Parámetro	Tipo WSDL	Descripción
`monto`	decimal	Importe registrado para la transacción.
`propina`	decimal	Importe registrado en concepto de propina.
`comision`	decimal	Importe identificado como comisión de la operación.
`iva`	decimal	Importe identificado como IVA.
`codigoRespuesta`	int	Código de respuesta asociado a la transacción.

Fechas de la transacción

Parámetro	Tipo WSDL	Descripción
`fechaTransaccion`	string	Fecha asociada al procesamiento de la operación.
`horaTransaccion`	string	Hora asociada al procesamiento de la operación.
`fechaRegistro`	dateTime	Fecha y hora de registro de la transacción.
`fechaTransferencia`	dateTime, nillable	Fecha y hora de transferencia, cuando exista un valor registrado.

fechaTransferencia admite explícitamente valores nulos mediante xsi:nil="true".

Información de tarjeta y afiliación

Parámetro	Tipo WSDL	Descripción
`tarjeta`	string	Dato de tarjeta asociado a la transacción. Este valor se encuentra enmascarado.
`titular`	string	Información del titular de la tarjeta.
`mes`	string	Mes de vencimiento de la tarjeta, cuando corresponda.
`anio`	string	Año de vencimiento de la tarjeta, cuando corresponda.
`emisor`	string	Información del emisor de la tarjeta.
`marca`	string	Marca de la tarjeta.
`tipo`	string	Clasificación de la tarjeta.
`afiliacion`	string	Identificador de afiliación asociado a la operación.

Información EMV

Parámetro	Tipo WSDL	Descripción
`AID`	string	Application Identifier. Identificador de la aplicación de pago.
`TVR`	string	Terminal Verification Results. Resultados de verificación de la terminal.
`TSI`	string	Transaction Status Information. Información del estado del procesamiento EMV.
`APN`	string	Application Preferred Name. Nombre preferido de la aplicación de pago.
`AL`	string	Application Label. Etiqueta de la aplicación de pago.
`ARQC`	string	Application Request Cryptogram. Criptograma de solicitud de autorización, cuando corresponda.

Información adicional

Parámetro	Tipo WSDL	Descripción
`firmado`	int, nillable	Indicador denominado `firmado`. Sus valores y significado operativo deben confirmarse con OEL.
`usuario`	string	Identificador o información del usuario asociado a la operación.
`serieLector`	string	Serie del lector asociado a la transacción, cuando corresponda.
`subComercio`	string	Información del subcomercio asociado a la transacción.
`version`	string	Versión registrada para la operación.

Nota: subComercio utiliza una C mayúscula en el objeto de respuesta, mientras que el parámetro Request se denomina subcomercio.

XML distingue entre mayúsculas y minúsculas, por lo que deben respetarse los nombres exactos.

Ejemplo XML Response — Listado de transacciones

El siguiente ejemplo representa una respuesta ficticia que contiene dos transacciones.

Se incluyen los campos obligatorios y algunos opcionales para ilustrar la estructura. No se muestran datos reales de tarjeta ni criptogramas EMV.

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

  <soap:Body>
    <OpTransaccionesResponse>
      <OpTransaccionesResult>

Los valores utilizados son exclusivamente ilustrativos.

En particular:

tipoMovimiento y resultado contienen marcadores simbólicos.
codigoRespuesta=0 se utiliza como valor de ejemplo, sin confirmar su interpretación específica en este método.
firmado=1 no implica un significado funcional determinado.
Los importes de comisión e IVA no representan una tarifa ni una fórmula de cálculo oficial.
Las fechas de registro y transferencia son ficticias y no establecen un plazo real de liquidación.

Interpretación de la respuesta

Colección de transacciones

La respuesta puede contener múltiples elementos Transaccion.

El integrador debe recorrer la colección y procesar cada elemento individualmente, contemplando que algunos campos opcionales podrían estar ausentes.

Resultado de cada operación

El parámetro codigoRespuesta permite identificar el resultado de cada transacción.

Código	Descripción en `OpVenta`
`0`	Operación aprobada
`1`	Operación rechazada

Fechas y conciliación

El método devuelve tres conceptos temporales diferentes:

Fecha y hora de la transacción.
Fecha de registro.
Fecha de transferencia.

Estas fechas pueden resultar útiles para los procesos de conciliación,fechaTransferencia corresponde a la fecha de liquidación bancaria definitiva.

Consideraciones técnicas

Intervalos de consulta: confirmar el rango máximo de fechas admitido.
Volumen de resultados: verificar si existen límites de registros, paginación o restricciones de tamaño de respuesta.
Filtros opcionales: confirmar cómo se aplican transaccionId, deviceId y subcomercio.
Campos opcionales: implementar el procesamiento de respuestas que omitan elementos no obligatorios.
Valores nulos: manejar correctamente xsi:nil="true" en fechaTransferencia y firmado.
Datos sensibles: proteger la información de tarjeta y los campos EMV que puedan formar parte de la respuesta.
Seguridad: utilizar HTTPS y mantener protegidas las credenciales de autenticación.
Conciliación: no asumir fórmulas de cálculo de comisiones, IVA o montos netos sin la especificación correspondiente.
Control de duplicados: utilizar identificadores adecuados para evitar duplicar registros al importar resultados de consultas sucesivas.
Seguimiento: relacionar los resultados con las operaciones originales almacenadas por el comercio.

Relación con otros métodos

Método	Función
`OpVenta`	Solicita procesar una venta.
`OpObtenerVenta`	Consulta el estado actual de una venta específica.
`OpTransacciones`	Obtiene un listado de transacciones.
`OpCortesDiarios`	Permite consultar información de cortes diarios, conforme a su contrato.
`OpEstadoCuenta`	Permite consultar información de estado de cuenta, conforme a su contrato.

Primeros Pasos

Codigos de Respuesta

¿Listo para integrar?

Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.

Ver Ambiente de Desarrollio

Consultar Referencia API

¿Listo para integrar?

Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.

Ver Ambiente de Desarrollio

Consultar Referencia API

OEL

Politica de Privacidad

Terminos y Condiciones

OEL

Politica de Privacidad

Terminos y Condiciones