OpVenta - Doks Framer Template

El método OpVenta permite procesar una operación de venta o autorización de cargo mediante una tarjeta de crédito o débito presente, utilizando el Gateway de Pagos de Operaciones en Línea (OEL).

La solicitud se realiza mediante un mensaje SOAP que contiene la identificación del comercio, los datos de la transacción y la información obtenida del dispositivo de lectura de tarjetas.

La respuesta informa el resultado de la operación y, cuando corresponda, los datos de autorización devueltos por el procesador de pagos.

Información del servicio

Propiedad	Valor
Método	`OpVenta`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS, TLS 1.2 o superior
Endpoint de producción	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction (SOAP 1.1)	`https://servidorseguro.operacionesenlinea.com/OpVenta`
Objeto de solicitud	`request` (`cVentaReq`)
Objeto de respuesta	`OpVentaResult` (`cVentaResp`)

Autenticación

Todas las operaciones requieren autenticación mediante la cabecera SOAP OpHeader, que contiene dos valores proporcionados 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 debe incluir comercioId y contrasena, asignados al comercio durante su proceso de habilitació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)

Los nombres de los parámetros corresponden exactamente a los definidos en el WSDL. La columna «Requerido» refleja la obligatoriedad indicada para el procesamiento de Tarjeta Presente, no únicamente la validación estructural del XSD.

Identificación y datos de la operación

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.
`modo`	string	No indicado	Modo de operación. El PDF identifica `P` como producción.
`monto`	decimal	Sí	Importe total de la operación. Se expresa con punto decimal, sin símbolos monetarios ni separadores de miles.
`propina`	decimal	Sí	Importe correspondiente a la propina. Puede enviarse `0.00`.
`transaccionId`	string	Sí	Identificador de la operación generado por el sistema del comercio. El PDF establece un máximo de 20 caracteres.
`referencia`	string	Sí	Referencia adicional de libre uso para identificar la operación. Máximo de 20 caracteres según el PDF.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN). La especificación Tap-to-Phone exige proteger este dato mediante cifrado AES-256 antes de transmitirlo.
`tipo`	string	No indicado	Tipo de tarjeta: `1` = crédito; `2` = débito.
`mes`	string	Sí	Mes de vencimiento de la tarjeta, en formato `MM`.
`anio`	string	Sí	Año de vencimiento de la tarjeta, en formato `AAAA`.
`digitos`	string	No	Código de verificación de la tarjeta, cuando sea aplicable y esté permitido por el flujo de procesamiento.
`titular`	string	No	Nombre del titular, tal como aparece en la tarjeta.
`dirIp`	string	No	Dirección IP del cliente o dispositivo desde el cual se origina la operación.

Información del dispositivo y lectura EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método utilizado para leer la tarjeta. Valores documentados: `Chip`, `Magstripe`, `Contactless`, `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta. Debe protegerse mediante cifrado AES-256.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido de la lectura de chip o contactless. Debe protegerse mediante cifrado AES-256.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago de la tarjeta.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones efectuadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Información del estado de procesamiento EMV.
`apn`	string	Sí	Application Preferred Name. Nombre preferido de la aplicación de pago.
`al`	string	Sí	Application Label. Etiqueta de la aplicación de pago.
`arqc`	string	Sí	Authorization Request Cryptogram. Criptograma de solicitud de autorización generado durante el procesamiento EMV.

Promociones y parámetros adicionales

Parámetro	Tipo WSDL	Requerido	Descripción
`diferimiento`	string	No	Número de meses que se difiere el inicio de los pagos. El PDF establece dos dígitos, por ejemplo `03`.
`numeroPagos`	string	No	Número de mensualidades de una promoción. Ejemplo: `06`.
`plan`	string	No	Tipo de promoción: `03` = sin intereses; `05` = con intereses; `07` = únicamente diferimiento inicial.
`qps`	string	No	Identificador de transacción QPS: `0` = operación normal; `1` = operación QPS.
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la venta.
`subcomercio`	string	No	Identificador de un comercio perteneciente a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado, cuando corresponda.

Ejemplo de solicitud SOAP 1.1

El siguiente ejemplo utiliza valores simbólicos y ficticios. Su objetivo es ilustrar la estructura XML; no constituye una transacción ejecutable.

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

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

  <soap:Body>
    <tns:OpVenta>
      <tns:request>
        <tns:comercioId>12345</tns:comercioId>
        <tns:contrasena>CLAVE_COMERCIO</tns:contrasena>
        <tns:modo>P</tns:modo>
        <tns:monto>125.50</tns:monto>
        <tns:propina>0.00</tns:propina>
        <tns:transaccionId>ORDEN000001</tns:transaccionId>
        <tns:referencia>

El prefijo tns identifica los elementos del namespace del servicio. Los valores de tarjeta, Track 2 y EMV son marcadores simbólicos, no datos cifrados válidos.

Los campos opcionales que no correspondan a una operación pueden omitirse, siempre que las reglas operativas de OEL lo permitan.

Parámetros de respuesta (Response)

La respuesta SOAP contiene el elemento OpVentaResponse y, dentro de él, OpVentaResult.

Identificación y resultado de la operación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que procesó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la transacción proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. El PDF indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento de la operación, en formato `HH:MM:SS`.
`monto`	decimal	Importe total de la operación.
`referencia`	string	Referencia asociada a la transacción.
`numeroControl`	string	Código de control o identificador retornado para la transacción.
`codigoRespuesta`	int	Resultado principal de la operación: `0` = aprobada; `1` = rechazada, según el PDF.
`procReturnMsg`	string	Código devuelto por el procesador de la tarjeta.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador de pagos.
`codigoAprobacion`	string	Código de aprobación bancaria, típicamente de seis dígitos.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para ejecutar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada a la operación.
`emvData`	string	Información EMV retornada por el banco cuando corresponda, especialmente en operaciones con chip.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta. El PDF menciona Visa, Mastercard, Amex y Carnet.
`cardBrand`	string	Campo definido en el WSDL. Su significado específico no está documentado en el PDF.
`issuerData`	string	Información adicional que puede devolver el banco emisor.
`issuingBank`	string	Nombre de la institución financiera emisora de la tarjeta.
`auth_result`	string	Resultado de la operación informado por el procesamiento de autorización.
`referred_card`	string	Identificador de la tarjeta a la que hace referencia la venta, según el PDF. Debe verificarse su representación y tratamiento seguro.

Información EMV y parámetros adicionales

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago retornado tras la operación.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de procesamiento EMV.
`apn`	string	Nombre preferido de la aplicación de pago.
`al`	string	Etiqueta de la aplicación de pago.
`arqc`	string	Criptograma de solicitud de autorización asociado a la operación.
`cmd_trans`	string	Campo definido en el WSDL, sin descripción funcional en el PDF.

Interpretación del resultado

La especificación identifica los siguientes valores para codigoRespuesta:

Valor	Resultado
`0`	Operación aprobada
`1`	Operación rechazada

Además de codigoRespuesta, el servicio puede devolver códigos y mensajes del procesador o institución financiera mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Los catálogos completos de estos códigos y el comportamiento ante errores de comunicación requieren documentación adicional.

Consideraciones de seguridad

La especificación para el procesamiento de Tarjeta Presente establece que los datos sensibles de la tarjeta —PAN, Track 2 y etiquetas EMV— se protegen mediante cifrado AES-256 antes de su transmisión.

La comunicación entre el dispositivo y el Gateway se realiza mediante HTTPS con TLS 1.2 o superior.

Los datos sensibles utilizados durante el procesamiento deben mantenerse únicamente durante el tiempo necesario para completar la transacción. No deben almacenarse de forma persistente ni registrarse en logs.

Los códigos de verificación de tarjeta no deben almacenarse después de la autorización, incluso cuando se encuentren cifrados.

La especificación sobre el mecanismo de cifrado AES-256 (modo, IV, padding, codificación y formato de salida) debe consultarse diectamente con OEL al momento de implementar una integración independiente del SDK.

La solicitud se realiza mediante un mensaje SOAP que contiene la identificación del comercio, los datos de la transacción y la información obtenida del dispositivo de lectura de tarjetas.

La respuesta informa el resultado de la operación y, cuando corresponda, los datos de autorización devueltos por el procesador de pagos.

Información del servicio

Propiedad	Valor
Método	`OpVenta`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS, TLS 1.2 o superior
Endpoint de producción	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction (SOAP 1.1)	`https://servidorseguro.operacionesenlinea.com/OpVenta`
Objeto de solicitud	`request` (`cVentaReq`)
Objeto de respuesta	`OpVentaResult` (`cVentaResp`)

Autenticación

Todas las operaciones requieren autenticación mediante la cabecera SOAP OpHeader, que contiene dos valores proporcionados 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 debe incluir comercioId y contrasena, asignados al comercio durante su proceso de habilitació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)

Identificación y datos de la operación

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.
`modo`	string	No indicado	Modo de operación. El PDF identifica `P` como producción.
`monto`	decimal	Sí	Importe total de la operación. Se expresa con punto decimal, sin símbolos monetarios ni separadores de miles.
`propina`	decimal	Sí	Importe correspondiente a la propina. Puede enviarse `0.00`.
`transaccionId`	string	Sí	Identificador de la operación generado por el sistema del comercio. El PDF establece un máximo de 20 caracteres.
`referencia`	string	Sí	Referencia adicional de libre uso para identificar la operación. Máximo de 20 caracteres según el PDF.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN). La especificación Tap-to-Phone exige proteger este dato mediante cifrado AES-256 antes de transmitirlo.
`tipo`	string	No indicado	Tipo de tarjeta: `1` = crédito; `2` = débito.
`mes`	string	Sí	Mes de vencimiento de la tarjeta, en formato `MM`.
`anio`	string	Sí	Año de vencimiento de la tarjeta, en formato `AAAA`.
`digitos`	string	No	Código de verificación de la tarjeta, cuando sea aplicable y esté permitido por el flujo de procesamiento.
`titular`	string	No	Nombre del titular, tal como aparece en la tarjeta.
`dirIp`	string	No	Dirección IP del cliente o dispositivo desde el cual se origina la operación.

Información del dispositivo y lectura EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método utilizado para leer la tarjeta. Valores documentados: `Chip`, `Magstripe`, `Contactless`, `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta. Debe protegerse mediante cifrado AES-256.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido de la lectura de chip o contactless. Debe protegerse mediante cifrado AES-256.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago de la tarjeta.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones efectuadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Información del estado de procesamiento EMV.
`apn`	string	Sí	Application Preferred Name. Nombre preferido de la aplicación de pago.
`al`	string	Sí	Application Label. Etiqueta de la aplicación de pago.
`arqc`	string	Sí	Authorization Request Cryptogram. Criptograma de solicitud de autorización generado durante el procesamiento EMV.

Promociones y parámetros adicionales

Parámetro	Tipo WSDL	Requerido	Descripción
`diferimiento`	string	No	Número de meses que se difiere el inicio de los pagos. El PDF establece dos dígitos, por ejemplo `03`.
`numeroPagos`	string	No	Número de mensualidades de una promoción. Ejemplo: `06`.
`plan`	string	No	Tipo de promoción: `03` = sin intereses; `05` = con intereses; `07` = únicamente diferimiento inicial.
`qps`	string	No	Identificador de transacción QPS: `0` = operación normal; `1` = operación QPS.
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la venta.
`subcomercio`	string	No	Identificador de un comercio perteneciente a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado, cuando corresponda.

Ejemplo de solicitud SOAP 1.1

El siguiente ejemplo utiliza valores simbólicos y ficticios. Su objetivo es ilustrar la estructura XML; no constituye una transacción ejecutable.

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

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

  <soap:Body>
    <tns:OpVenta>
      <tns:request>
        <tns:comercioId>12345</tns:comercioId>
        <tns:contrasena>CLAVE_COMERCIO</tns:contrasena>
        <tns:modo>P</tns:modo>
        <tns:monto>125.50</tns:monto>
        <tns:propina>0.00</tns:propina>
        <tns:transaccionId>ORDEN000001</tns:transaccionId>
        <tns:referencia>

El prefijo tns identifica los elementos del namespace del servicio. Los valores de tarjeta, Track 2 y EMV son marcadores simbólicos, no datos cifrados válidos.

Los campos opcionales que no correspondan a una operación pueden omitirse, siempre que las reglas operativas de OEL lo permitan.

Parámetros de respuesta (Response)

La respuesta SOAP contiene el elemento OpVentaResponse y, dentro de él, OpVentaResult.

Identificación y resultado de la operación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que procesó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la transacción proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. El PDF indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento de la operación, en formato `HH:MM:SS`.
`monto`	decimal	Importe total de la operación.
`referencia`	string	Referencia asociada a la transacción.
`numeroControl`	string	Código de control o identificador retornado para la transacción.
`codigoRespuesta`	int	Resultado principal de la operación: `0` = aprobada; `1` = rechazada, según el PDF.
`procReturnMsg`	string	Código devuelto por el procesador de la tarjeta.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador de pagos.
`codigoAprobacion`	string	Código de aprobación bancaria, típicamente de seis dígitos.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para ejecutar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada a la operación.
`emvData`	string	Información EMV retornada por el banco cuando corresponda, especialmente en operaciones con chip.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta. El PDF menciona Visa, Mastercard, Amex y Carnet.
`cardBrand`	string	Campo definido en el WSDL. Su significado específico no está documentado en el PDF.
`issuerData`	string	Información adicional que puede devolver el banco emisor.
`issuingBank`	string	Nombre de la institución financiera emisora de la tarjeta.
`auth_result`	string	Resultado de la operación informado por el procesamiento de autorización.
`referred_card`	string	Identificador de la tarjeta a la que hace referencia la venta, según el PDF. Debe verificarse su representación y tratamiento seguro.

Información EMV y parámetros adicionales

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago retornado tras la operación.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de procesamiento EMV.
`apn`	string	Nombre preferido de la aplicación de pago.
`al`	string	Etiqueta de la aplicación de pago.
`arqc`	string	Criptograma de solicitud de autorización asociado a la operación.
`cmd_trans`	string	Campo definido en el WSDL, sin descripción funcional en el PDF.

Interpretación del resultado

La especificación identifica los siguientes valores para codigoRespuesta:

Valor	Resultado
`0`	Operación aprobada
`1`	Operación rechazada

Además de codigoRespuesta, el servicio puede devolver códigos y mensajes del procesador o institución financiera mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Los catálogos completos de estos códigos y el comportamiento ante errores de comunicación requieren documentación adicional.

Consideraciones de seguridad

La comunicación entre el dispositivo y el Gateway se realiza mediante HTTPS con TLS 1.2 o superior.

Los códigos de verificación de tarjeta no deben almacenarse después de la autorización, incluso cuando se encuentren cifrados.

La solicitud se realiza mediante un mensaje SOAP que contiene la identificación del comercio, los datos de la transacción y la información obtenida del dispositivo de lectura de tarjetas.

La respuesta informa el resultado de la operación y, cuando corresponda, los datos de autorización devueltos por el procesador de pagos.

Información del servicio

Propiedad	Valor
Método	`OpVenta`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS, TLS 1.2 o superior
Endpoint de producción	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction (SOAP 1.1)	`https://servidorseguro.operacionesenlinea.com/OpVenta`
Objeto de solicitud	`request` (`cVentaReq`)
Objeto de respuesta	`OpVentaResult` (`cVentaResp`)

Autenticación

Todas las operaciones requieren autenticación mediante la cabecera SOAP OpHeader, que contiene dos valores proporcionados 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 debe incluir comercioId y contrasena, asignados al comercio durante su proceso de habilitació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)

Identificación y datos de la operación

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.
`modo`	string	No indicado	Modo de operación. El PDF identifica `P` como producción.
`monto`	decimal	Sí	Importe total de la operación. Se expresa con punto decimal, sin símbolos monetarios ni separadores de miles.
`propina`	decimal	Sí	Importe correspondiente a la propina. Puede enviarse `0.00`.
`transaccionId`	string	Sí	Identificador de la operación generado por el sistema del comercio. El PDF establece un máximo de 20 caracteres.
`referencia`	string	Sí	Referencia adicional de libre uso para identificar la operación. Máximo de 20 caracteres según el PDF.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN). La especificación Tap-to-Phone exige proteger este dato mediante cifrado AES-256 antes de transmitirlo.
`tipo`	string	No indicado	Tipo de tarjeta: `1` = crédito; `2` = débito.
`mes`	string	Sí	Mes de vencimiento de la tarjeta, en formato `MM`.
`anio`	string	Sí	Año de vencimiento de la tarjeta, en formato `AAAA`.
`digitos`	string	No	Código de verificación de la tarjeta, cuando sea aplicable y esté permitido por el flujo de procesamiento.
`titular`	string	No	Nombre del titular, tal como aparece en la tarjeta.
`dirIp`	string	No	Dirección IP del cliente o dispositivo desde el cual se origina la operación.

Información del dispositivo y lectura EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método utilizado para leer la tarjeta. Valores documentados: `Chip`, `Magstripe`, `Contactless`, `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta. Debe protegerse mediante cifrado AES-256.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido de la lectura de chip o contactless. Debe protegerse mediante cifrado AES-256.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago de la tarjeta.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones efectuadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Información del estado de procesamiento EMV.
`apn`	string	Sí	Application Preferred Name. Nombre preferido de la aplicación de pago.
`al`	string	Sí	Application Label. Etiqueta de la aplicación de pago.
`arqc`	string	Sí	Authorization Request Cryptogram. Criptograma de solicitud de autorización generado durante el procesamiento EMV.

Promociones y parámetros adicionales

Parámetro	Tipo WSDL	Requerido	Descripción
`diferimiento`	string	No	Número de meses que se difiere el inicio de los pagos. El PDF establece dos dígitos, por ejemplo `03`.
`numeroPagos`	string	No	Número de mensualidades de una promoción. Ejemplo: `06`.
`plan`	string	No	Tipo de promoción: `03` = sin intereses; `05` = con intereses; `07` = únicamente diferimiento inicial.
`qps`	string	No	Identificador de transacción QPS: `0` = operación normal; `1` = operación QPS.
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la venta.
`subcomercio`	string	No	Identificador de un comercio perteneciente a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado, cuando corresponda.

Ejemplo de solicitud SOAP 1.1

El siguiente ejemplo utiliza valores simbólicos y ficticios. Su objetivo es ilustrar la estructura XML; no constituye una transacción ejecutable.

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

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

  <soap:Body>
    <tns:OpVenta>
      <tns:request>
        <tns:comercioId>12345</tns:comercioId>
        <tns:contrasena>CLAVE_COMERCIO</tns:contrasena>
        <tns:modo>P</tns:modo>
        <tns:monto>125.50</tns:monto>
        <tns:propina>0.00</tns:propina>
        <tns:transaccionId>ORDEN000001</tns:transaccionId>
        <tns:referencia>

El prefijo tns identifica los elementos del namespace del servicio. Los valores de tarjeta, Track 2 y EMV son marcadores simbólicos, no datos cifrados válidos.

Los campos opcionales que no correspondan a una operación pueden omitirse, siempre que las reglas operativas de OEL lo permitan.

Parámetros de respuesta (Response)

La respuesta SOAP contiene el elemento OpVentaResponse y, dentro de él, OpVentaResult.

Identificación y resultado de la operación

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que procesó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la transacción proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. El PDF indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento de la operación, en formato `HH:MM:SS`.
`monto`	decimal	Importe total de la operación.
`referencia`	string	Referencia asociada a la transacción.
`numeroControl`	string	Código de control o identificador retornado para la transacción.
`codigoRespuesta`	int	Resultado principal de la operación: `0` = aprobada; `1` = rechazada, según el PDF.
`procReturnMsg`	string	Código devuelto por el procesador de la tarjeta.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador de pagos.
`codigoAprobacion`	string	Código de aprobación bancaria, típicamente de seis dígitos.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para ejecutar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada a la operación.
`emvData`	string	Información EMV retornada por el banco cuando corresponda, especialmente en operaciones con chip.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta. El PDF menciona Visa, Mastercard, Amex y Carnet.
`cardBrand`	string	Campo definido en el WSDL. Su significado específico no está documentado en el PDF.
`issuerData`	string	Información adicional que puede devolver el banco emisor.
`issuingBank`	string	Nombre de la institución financiera emisora de la tarjeta.
`auth_result`	string	Resultado de la operación informado por el procesamiento de autorización.
`referred_card`	string	Identificador de la tarjeta a la que hace referencia la venta, según el PDF. Debe verificarse su representación y tratamiento seguro.

Información EMV y parámetros adicionales

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago retornado tras la operación.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de procesamiento EMV.
`apn`	string	Nombre preferido de la aplicación de pago.
`al`	string	Etiqueta de la aplicación de pago.
`arqc`	string	Criptograma de solicitud de autorización asociado a la operación.
`cmd_trans`	string	Campo definido en el WSDL, sin descripción funcional en el PDF.

Interpretación del resultado

La especificación identifica los siguientes valores para codigoRespuesta:

Valor	Resultado
`0`	Operación aprobada
`1`	Operación rechazada

Además de codigoRespuesta, el servicio puede devolver códigos y mensajes del procesador o institución financiera mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Los catálogos completos de estos códigos y el comportamiento ante errores de comunicación requieren documentación adicional.

Consideraciones de seguridad

La comunicación entre el dispositivo y el Gateway se realiza mediante HTTPS con TLS 1.2 o superior.

Los códigos de verificación de tarjeta no deben almacenarse después de la autorización, incluso cuando se encuentren cifrados.

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