OpPreAutorizacion - Doks Framer Template

El método OpPreAutorizacion permite solicitar una autorización previa de un importe sobre una tarjeta de crédito o débito mediante el Gateway de Pagos de OEL.

A diferencia de una venta convencional, la preautorización permite verificar la autorización de un importe sin ejecutar necesariamente su cargo definitivo en ese momento. Dependiendo de las reglas del banco emisor y del adquirente, el importe autorizado puede quedar temporalmente retenido.

Este método es útil en escenarios donde el importe debe autorizarse antes de completar una operación comercial, como servicios sujetos a confirmación o consumos cuyo cargo se realizará posteriormente.

Una preautorización aprobada no debe interpretarse automáticamente como una venta liquidada. El proceso posterior deberá realizarse mediante la operación correspondiente, como OpPostAutorizacion, de acuerdo con las reglas de OEL.

Información del servicio

Propiedad	Valor
Método	`OpPreAutorizacion`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS (TLS 1.2+)
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpPreAutorizacion`
Request	`cPreAutorizacionReq`
Response	`cPreAutorizacionResp`

Autenticación

La solicitud requiere autenticación mediante la cabecera SOAP OpHeader, que contiene las credenciales OpKey1 y OpKey2 asignadas por OEL.

Adicionalmente, deben enviarse los parámetros comercioId y contrasena para identificar al comercio que solicita la operación.

Parámetros de solicitud (Request)

Las siguientes tablas describen los 26 parámetros definidos para OpPreAutorizacion.

La obligatoriedad funcional se basa en las reglas de OpVenta proporcionadas para esta integración. Algunos campos pueden depender del método de lectura de tarjeta o de la configuración del comercio.

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	Por confirmar	Modo de operación. La documentación de tarjeta presente identifica `P` para producción.
`monto`	decimal	Sí	Importe que se solicita preautorizar, expresado con punto decimal y dos decimales.
`propina`	decimal	Sí en XSD; admite nulo	Importe de propina, cuando corresponda. Puede representarse como `0.00` en el ejemplo.
`transaccionId`	string	Sí	Identificador único de la operación generado por el sistema del comercio. Máximo de 20 caracteres según la documentación de referencia.
`referencia`	string	Sí	Referencia adicional de la operación. Máximo de 20 caracteres según la documentación de referencia.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN), protegido mediante el mecanismo de cifrado definido por OEL.
`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, únicamente cuando corresponda al flujo autorizado.
`titular`	string	No	Nombre completo del titular de la tarjeta.
`dirIp`	string	No	Dirección IP desde la que se origina la operación.

Datos de lectura y procesamiento EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método de lectura de tarjeta: `Chip`, `Magstripe`, `Contactless` o `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta, protegida mediante cifrado.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido del dispositivo de lectura.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones realizadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Estado del 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 generado para solicitar la autorización.

Identificación adicional

Parámetro	Tipo WSDL	Requerido	Descripción
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la operación.
`subcomercio`	string	No	Identificador del comercio asociado a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado para realizar la operación, cuando corresponda.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo ilustra una solicitud de preautorización utilizando valores simbólicos. No contiene credenciales ni datos reales de tarjeta.

<?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>
    <OpPreAutorizacion>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <modo>P</modo>
        <monto>500.00</monto>
        <propina>0.00</propina>
        <transaccionId>PREAUT000001</transaccionId>
        <referencia>RESERVA000001</referencia>
        <tarjeta>PAN_CIFRADO_AES256</tarjeta>
        <tipo>1</tipo>
        <mes>12</mes>
        <anio>2030</anio>
        <posEntryMode>Chip</posEntryMode>
        <track2>TRACK2_CIFRADO_AES256</track2>
        <emvTags>EMV_CIFRADO_AES256</emvTags>
        <aid>AID_OBTENIDO</aid>
        <tvr>TVR_OBTENIDO</tvr>
        <tsi>TSI_OBTENIDO</tsi>
        <apn>NOMBRE_APLICACION</apn>
        <al>ETIQUETA_APLICACION</al>
        <arqc>CRIPTOGRAMA_EMV</arqc>
        <deviceId>12345678</deviceId>
      </request>
    </OpPreAutorizacion>

Los valores simbólicos deben sustituirse por información válida obtenida del dispositivo de lectura y por las credenciales proporcionadas por OEL. Los marcadores de cifrado no representan valores AES-256 ejecutables.

En SOAP 1.1, la solicitud HTTP utiliza Content-Type: text/xml; charset=utf-8 y la cabecera SOAPAction correspondiente al método.

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpPreAutorizacionResponse y, dentro de él, el objeto OpPreAutorizacionResult.

Identificación y resultado

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que realizó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la operación proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. La documentación de referencia indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento, en formato `HH:MM:SS`.
`monto`	decimal	Importe procesado en la solicitud de preautorización.
`referencia`	string	Referencia asociada a la operación.
`numeroControl`	string	Código de control o identificador retornado para la operación.
`codigoRespuesta`	int	Código que informa el resultado de la operación.
`procReturnMsg`	string	Código retornado por el procesador de pagos.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador.
`codigoAprobacion`	string	Código de aprobación bancaria, cuando la operación es autorizada.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para procesar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada.
`emvData`	string	Información EMV devuelta por el banco, cuando corresponda.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta, como Visa, Mastercard, Amex o Carnet.
`issuerData`	string	Información adicional proporcionada por el banco emisor.
`issuingBank`	string	Nombre de la institución emisora de la tarjeta.
`auth_result`	string	Resultado de la operación de autorización.
`referred_card`	string	Referencia a la tarjeta asociada a la operación. Su formato y tratamiento deben confirmarse con OEL.

Información EMV retornada

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de la transacción 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.

Ejemplo XML Response

El siguiente ejemplo es una representación ilustrativa de una respuesta aprobada. Los valores y la interpretación de los códigos deberán validarse contra una respuesta real 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>
    <OpPreAutorizacionResponse>
      <OpPreAutorizacionResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>PREAUT000001</transaccionId>
        <fechaTransaccion>10/15/26</fechaTransaccion>
        <horaTransaccion>14:30:00</horaTransaccion>
        <monto>500.00</monto>
        <referencia>RESERVA000001</referencia>
        <numeroControl>CTRL000001</numeroControl>
        <codigoRespuesta>0</codigoRespuesta>
        <procReturnMsg>00</procReturnMsg>
        <ccErrorCode>0</ccErrorCode>
        <ccReturnMsg>APROBADA</ccReturnMsg>
        <codigoAprobacion>123456</codigoAprobacion>
      </OpPreAutorizacionResult>
    </OpPreAutorizacionResponse>

Códigos de respuesta

Se consideran los siguientes valores para codigoRespuestadel metodo OpPreAutorizacion:

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

El resultado también puede contener información adicional del procesador mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Consideraciones técnicas

Autorización y cargo: una preautorización aprobada no implica necesariamente que el importe haya sido capturado o liquidado. El procedimiento para completar la operación deberá realizarse mediante el método OpPostAutorizacion.
Identificación: conservar transaccionId, numeroControl y codigoAprobacion cuando sean devueltos, para permitir la trazabilidad y operaciones posteriores.
Seguridad: los datos sensibles de tarjeta deben protegerse mediante los mecanismos de cifrado establecidos por OEL y transmitirse sobre una conexión HTTPS segura.
Datos EMV: deben obtenerse del dispositivo de lectura. No deben generarse arbitrariamente ni reutilizarse entre transacciones.
Persistencia: no almacenar PAN completo, Track 2, códigos de verificación ni datos sensibles de autenticación. Los registros de operación deben excluir información confidencial.
Reintentos: ante un error de comunicación o una respuesta indeterminada, no reenviar automáticamente la operación sin verificar previamente su estado y las reglas de duplicidad del servicio.

Relación con otros métodos

Una preautorización forma parte de un flujo transaccional que puede requerir operaciones posteriores.

Método	Función
`OpPreAutorizacion`	Solicitar una autorización previa de un importe.
`OpPostAutorizacion`	Completar una operación previamente autorizada, conforme a las reglas del servicio.
`OpPreCancelacion`	Solicitar la cancelación de una preautorización, según las condiciones del procesador.

Los identificadores, plazos y reglas de vinculación entre estas operaciones deben confirmarse con OEL antes de liberar un flujo ejecutable completo.

El método OpPreAutorizacion permite solicitar una autorización previa de un importe sobre una tarjeta de crédito o débito mediante el Gateway de Pagos de OEL.

Información del servicio

Propiedad	Valor
Método	`OpPreAutorizacion`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS (TLS 1.2+)
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpPreAutorizacion`
Request	`cPreAutorizacionReq`
Response	`cPreAutorizacionResp`

Autenticación

La solicitud requiere autenticación mediante la cabecera SOAP OpHeader, que contiene las credenciales OpKey1 y OpKey2 asignadas por OEL.

Adicionalmente, deben enviarse los parámetros comercioId y contrasena para identificar al comercio que solicita la operación.

Parámetros de solicitud (Request)

Las siguientes tablas describen los 26 parámetros definidos para OpPreAutorizacion.

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	Por confirmar	Modo de operación. La documentación de tarjeta presente identifica `P` para producción.
`monto`	decimal	Sí	Importe que se solicita preautorizar, expresado con punto decimal y dos decimales.
`propina`	decimal	Sí en XSD; admite nulo	Importe de propina, cuando corresponda. Puede representarse como `0.00` en el ejemplo.
`transaccionId`	string	Sí	Identificador único de la operación generado por el sistema del comercio. Máximo de 20 caracteres según la documentación de referencia.
`referencia`	string	Sí	Referencia adicional de la operación. Máximo de 20 caracteres según la documentación de referencia.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN), protegido mediante el mecanismo de cifrado definido por OEL.
`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, únicamente cuando corresponda al flujo autorizado.
`titular`	string	No	Nombre completo del titular de la tarjeta.
`dirIp`	string	No	Dirección IP desde la que se origina la operación.

Datos de lectura y procesamiento EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método de lectura de tarjeta: `Chip`, `Magstripe`, `Contactless` o `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta, protegida mediante cifrado.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido del dispositivo de lectura.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones realizadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Estado del 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 generado para solicitar la autorización.

Identificación adicional

Parámetro	Tipo WSDL	Requerido	Descripción
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la operación.
`subcomercio`	string	No	Identificador del comercio asociado a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado para realizar la operación, cuando corresponda.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo ilustra una solicitud de preautorización utilizando valores simbólicos. No contiene credenciales ni datos reales de tarjeta.

<?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>
    <OpPreAutorizacion>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <modo>P</modo>
        <monto>500.00</monto>
        <propina>0.00</propina>
        <transaccionId>PREAUT000001</transaccionId>
        <referencia>RESERVA000001</referencia>
        <tarjeta>PAN_CIFRADO_AES256</tarjeta>
        <tipo>1</tipo>
        <mes>12</mes>
        <anio>2030</anio>
        <posEntryMode>Chip</posEntryMode>
        <track2>TRACK2_CIFRADO_AES256</track2>
        <emvTags>EMV_CIFRADO_AES256</emvTags>
        <aid>AID_OBTENIDO</aid>
        <tvr>TVR_OBTENIDO</tvr>
        <tsi>TSI_OBTENIDO</tsi>
        <apn>NOMBRE_APLICACION</apn>
        <al>ETIQUETA_APLICACION</al>
        <arqc>CRIPTOGRAMA_EMV</arqc>
        <deviceId>12345678</deviceId>
      </request>
    </OpPreAutorizacion>

En SOAP 1.1, la solicitud HTTP utiliza Content-Type: text/xml; charset=utf-8 y la cabecera SOAPAction correspondiente al método.

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpPreAutorizacionResponse y, dentro de él, el objeto OpPreAutorizacionResult.

Identificación y resultado

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que realizó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la operación proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. La documentación de referencia indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento, en formato `HH:MM:SS`.
`monto`	decimal	Importe procesado en la solicitud de preautorización.
`referencia`	string	Referencia asociada a la operación.
`numeroControl`	string	Código de control o identificador retornado para la operación.
`codigoRespuesta`	int	Código que informa el resultado de la operación.
`procReturnMsg`	string	Código retornado por el procesador de pagos.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador.
`codigoAprobacion`	string	Código de aprobación bancaria, cuando la operación es autorizada.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para procesar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada.
`emvData`	string	Información EMV devuelta por el banco, cuando corresponda.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta, como Visa, Mastercard, Amex o Carnet.
`issuerData`	string	Información adicional proporcionada por el banco emisor.
`issuingBank`	string	Nombre de la institución emisora de la tarjeta.
`auth_result`	string	Resultado de la operación de autorización.
`referred_card`	string	Referencia a la tarjeta asociada a la operación. Su formato y tratamiento deben confirmarse con OEL.

Información EMV retornada

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de la transacción 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.

Ejemplo XML Response

El siguiente ejemplo es una representación ilustrativa de una respuesta aprobada. Los valores y la interpretación de los códigos deberán validarse contra una respuesta real 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>
    <OpPreAutorizacionResponse>
      <OpPreAutorizacionResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>PREAUT000001</transaccionId>
        <fechaTransaccion>10/15/26</fechaTransaccion>
        <horaTransaccion>14:30:00</horaTransaccion>
        <monto>500.00</monto>
        <referencia>RESERVA000001</referencia>
        <numeroControl>CTRL000001</numeroControl>
        <codigoRespuesta>0</codigoRespuesta>
        <procReturnMsg>00</procReturnMsg>
        <ccErrorCode>0</ccErrorCode>
        <ccReturnMsg>APROBADA</ccReturnMsg>
        <codigoAprobacion>123456</codigoAprobacion>
      </OpPreAutorizacionResult>
    </OpPreAutorizacionResponse>

Códigos de respuesta

Se consideran los siguientes valores para codigoRespuestadel metodo OpPreAutorizacion:

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

El resultado también puede contener información adicional del procesador mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Consideraciones técnicas

Autorización y cargo: una preautorización aprobada no implica necesariamente que el importe haya sido capturado o liquidado. El procedimiento para completar la operación deberá realizarse mediante el método OpPostAutorizacion.
Identificación: conservar transaccionId, numeroControl y codigoAprobacion cuando sean devueltos, para permitir la trazabilidad y operaciones posteriores.
Seguridad: los datos sensibles de tarjeta deben protegerse mediante los mecanismos de cifrado establecidos por OEL y transmitirse sobre una conexión HTTPS segura.
Datos EMV: deben obtenerse del dispositivo de lectura. No deben generarse arbitrariamente ni reutilizarse entre transacciones.
Persistencia: no almacenar PAN completo, Track 2, códigos de verificación ni datos sensibles de autenticación. Los registros de operación deben excluir información confidencial.
Reintentos: ante un error de comunicación o una respuesta indeterminada, no reenviar automáticamente la operación sin verificar previamente su estado y las reglas de duplicidad del servicio.

Relación con otros métodos

Una preautorización forma parte de un flujo transaccional que puede requerir operaciones posteriores.

Método	Función
`OpPreAutorizacion`	Solicitar una autorización previa de un importe.
`OpPostAutorizacion`	Completar una operación previamente autorizada, conforme a las reglas del servicio.
`OpPreCancelacion`	Solicitar la cancelación de una preautorización, según las condiciones del procesador.

Los identificadores, plazos y reglas de vinculación entre estas operaciones deben confirmarse con OEL antes de liberar un flujo ejecutable completo.

El método OpPreAutorizacion permite solicitar una autorización previa de un importe sobre una tarjeta de crédito o débito mediante el Gateway de Pagos de OEL.

Información del servicio

Propiedad	Valor
Método	`OpPreAutorizacion`
Servicio	`OpGateway`
Protocolo	SOAP 1.1 / SOAP 1.2
Transporte	HTTPS (TLS 1.2+)
Endpoint	`https://servidorseguro.operacionesenlinea.com/Gateway/OpGateway.asmx`
Namespace	`https://servidorseguro.operacionesenlinea.com/`
SOAPAction	`https://servidorseguro.operacionesenlinea.com/OpPreAutorizacion`
Request	`cPreAutorizacionReq`
Response	`cPreAutorizacionResp`

Autenticación

La solicitud requiere autenticación mediante la cabecera SOAP OpHeader, que contiene las credenciales OpKey1 y OpKey2 asignadas por OEL.

Adicionalmente, deben enviarse los parámetros comercioId y contrasena para identificar al comercio que solicita la operación.

Parámetros de solicitud (Request)

Las siguientes tablas describen los 26 parámetros definidos para OpPreAutorizacion.

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	Por confirmar	Modo de operación. La documentación de tarjeta presente identifica `P` para producción.
`monto`	decimal	Sí	Importe que se solicita preautorizar, expresado con punto decimal y dos decimales.
`propina`	decimal	Sí en XSD; admite nulo	Importe de propina, cuando corresponda. Puede representarse como `0.00` en el ejemplo.
`transaccionId`	string	Sí	Identificador único de la operación generado por el sistema del comercio. Máximo de 20 caracteres según la documentación de referencia.
`referencia`	string	Sí	Referencia adicional de la operación. Máximo de 20 caracteres según la documentación de referencia.

Información de la tarjeta

Parámetro	Tipo WSDL	Requerido	Descripción
`tarjeta`	string	Sí	Número de tarjeta (PAN), protegido mediante el mecanismo de cifrado definido por OEL.
`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, únicamente cuando corresponda al flujo autorizado.
`titular`	string	No	Nombre completo del titular de la tarjeta.
`dirIp`	string	No	Dirección IP desde la que se origina la operación.

Datos de lectura y procesamiento EMV

Parámetro	Tipo WSDL	Requerido	Descripción
`posEntryMode`	string	Sí	Método de lectura de tarjeta: `Chip`, `Magstripe`, `Contactless` o `Fallback`.
`track2`	string	Sí	Información Track 2 obtenida durante la lectura de la tarjeta, protegida mediante cifrado.
`emvTags`	string	Sí	Conjunto de etiquetas EMV obtenido del dispositivo de lectura.
`aid`	string	Sí	Application Identifier. Identificador de la aplicación de pago.
`tvr`	string	Sí	Terminal Verification Results. Resultado de las verificaciones realizadas por la terminal.
`tsi`	string	Sí	Transaction Status Information. Estado del 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 generado para solicitar la autorización.

Identificación adicional

Parámetro	Tipo WSDL	Requerido	Descripción
`deviceId`	string	No	Identificador del dispositivo utilizado para procesar la operación.
`subcomercio`	string	No	Identificador del comercio asociado a un aliado registrado en OEL.
`version`	string	No	Versión del SDK utilizado para realizar la operación, cuando corresponda.

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo ilustra una solicitud de preautorización utilizando valores simbólicos. No contiene credenciales ni datos reales de tarjeta.

<?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>
    <OpPreAutorizacion>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <modo>P</modo>
        <monto>500.00</monto>
        <propina>0.00</propina>
        <transaccionId>PREAUT000001</transaccionId>
        <referencia>RESERVA000001</referencia>
        <tarjeta>PAN_CIFRADO_AES256</tarjeta>
        <tipo>1</tipo>
        <mes>12</mes>
        <anio>2030</anio>
        <posEntryMode>Chip</posEntryMode>
        <track2>TRACK2_CIFRADO_AES256</track2>
        <emvTags>EMV_CIFRADO_AES256</emvTags>
        <aid>AID_OBTENIDO</aid>
        <tvr>TVR_OBTENIDO</tvr>
        <tsi>TSI_OBTENIDO</tsi>
        <apn>NOMBRE_APLICACION</apn>
        <al>ETIQUETA_APLICACION</al>
        <arqc>CRIPTOGRAMA_EMV</arqc>
        <deviceId>12345678</deviceId>
      </request>
    </OpPreAutorizacion>

En SOAP 1.1, la solicitud HTTP utiliza Content-Type: text/xml; charset=utf-8 y la cabecera SOAPAction correspondiente al método.

Parámetros de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpPreAutorizacionResponse y, dentro de él, el objeto OpPreAutorizacionResult.

Identificación y resultado

Parámetro	Tipo WSDL	Descripción
`comercioId`	int	Identificador del comercio que realizó la operación.
`terminalId`	string	Identificador de la terminal utilizada.
`transaccionId`	string	Identificador de la operación proporcionado por el comercio.
`fechaTransaccion`	string	Fecha de procesamiento de la operación. La documentación de referencia indica formato `MM/DD/AA`.
`horaTransaccion`	string	Hora de procesamiento, en formato `HH:MM:SS`.
`monto`	decimal	Importe procesado en la solicitud de preautorización.
`referencia`	string	Referencia asociada a la operación.
`numeroControl`	string	Código de control o identificador retornado para la operación.
`codigoRespuesta`	int	Código que informa el resultado de la operación.
`procReturnMsg`	string	Código retornado por el procesador de pagos.
`ccErrorCode`	int	Código devuelto por la institución financiera.
`ccReturnMsg`	string	Mensaje específico retornado por el procesador.
`codigoAprobacion`	string	Código de aprobación bancaria, cuando la operación es autorizada.

Información bancaria y de la tarjeta

Parámetro	Tipo WSDL	Descripción
`afiliacion`	string	Número de afiliación utilizado para procesar la operación.
`afiliacionEmpresa`	string	Número de afiliación de la empresa asociada.
`emvData`	string	Información EMV devuelta por el banco, cuando corresponda.
`operType`	string	Indica si la tarjeta utilizada es de crédito o débito.
`cardType`	string	Marca de la tarjeta, como Visa, Mastercard, Amex o Carnet.
`issuerData`	string	Información adicional proporcionada por el banco emisor.
`issuingBank`	string	Nombre de la institución emisora de la tarjeta.
`auth_result`	string	Resultado de la operación de autorización.
`referred_card`	string	Referencia a la tarjeta asociada a la operación. Su formato y tratamiento deben confirmarse con OEL.

Información EMV retornada

Parámetro	Tipo WSDL	Descripción
`aid`	string	Identificador de la aplicación de pago.
`tvr`	string	Resultado de verificación de la terminal.
`tsi`	string	Información del estado de la transacción 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.

Ejemplo XML Response

El siguiente ejemplo es una representación ilustrativa de una respuesta aprobada. Los valores y la interpretación de los códigos deberán validarse contra una respuesta real 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>
    <OpPreAutorizacionResponse>
      <OpPreAutorizacionResult>
        <comercioId>12345</comercioId>
        <terminalId>12345678</terminalId>
        <transaccionId>PREAUT000001</transaccionId>
        <fechaTransaccion>10/15/26</fechaTransaccion>
        <horaTransaccion>14:30:00</horaTransaccion>
        <monto>500.00</monto>
        <referencia>RESERVA000001</referencia>
        <numeroControl>CTRL000001</numeroControl>
        <codigoRespuesta>0</codigoRespuesta>
        <procReturnMsg>00</procReturnMsg>
        <ccErrorCode>0</ccErrorCode>
        <ccReturnMsg>APROBADA</ccReturnMsg>
        <codigoAprobacion>123456</codigoAprobacion>
      </OpPreAutorizacionResult>
    </OpPreAutorizacionResponse>

Códigos de respuesta

Se consideran los siguientes valores para codigoRespuestadel metodo OpPreAutorizacion:

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

El resultado también puede contener información adicional del procesador mediante procReturnMsg, ccErrorCode y ccReturnMsg.

Consideraciones técnicas

Autorización y cargo: una preautorización aprobada no implica necesariamente que el importe haya sido capturado o liquidado. El procedimiento para completar la operación deberá realizarse mediante el método OpPostAutorizacion.
Identificación: conservar transaccionId, numeroControl y codigoAprobacion cuando sean devueltos, para permitir la trazabilidad y operaciones posteriores.
Seguridad: los datos sensibles de tarjeta deben protegerse mediante los mecanismos de cifrado establecidos por OEL y transmitirse sobre una conexión HTTPS segura.
Datos EMV: deben obtenerse del dispositivo de lectura. No deben generarse arbitrariamente ni reutilizarse entre transacciones.
Persistencia: no almacenar PAN completo, Track 2, códigos de verificación ni datos sensibles de autenticación. Los registros de operación deben excluir información confidencial.
Reintentos: ante un error de comunicación o una respuesta indeterminada, no reenviar automáticamente la operación sin verificar previamente su estado y las reglas de duplicidad del servicio.

Relación con otros métodos

Una preautorización forma parte de un flujo transaccional que puede requerir operaciones posteriores.

Método	Función
`OpPreAutorizacion`	Solicitar una autorización previa de un importe.
`OpPostAutorizacion`	Completar una operación previamente autorizada, conforme a las reglas del servicio.
`OpPreCancelacion`	Solicitar la cancelación de una preautorización, según las condiciones del procesador.

Los identificadores, plazos y reglas de vinculación entre estas operaciones deben confirmarse con OEL antes de liberar un flujo ejecutable completo.

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