API Reference
Start typing to search…

PreAutorizacion

Procesa la validacion de un Cargo a partir de una Tarjeta

Para efectuar la PRETAUTORIZACION de un CARGO AL TARJETAHABIENTE, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado.

Variables de Envío

  <th style={{ textAlign: "left" }}>
    FORMATO
  </th>

  <th style={{ textAlign: "left" }}>
    RESTRICCIONES
  </th>

  <th style={{ textAlign: "left" }}>
    DESCRIPCION
  </th>
</tr>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite números sin espacios.
  </td>

  <td style={{ textAlign: "left" }}>
    Identificador del Comercio en OPENLINEA. Es un valor asignado.
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    contraseña
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 12 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    modo
  </td>

  <td style={{ textAlign: "left" }}>
    Carácter
  </td>

  <td style={{ textAlign: "left" }}>
    Admite una solo letra
  </td>

  <td style={{ textAlign: "left" }}>
    Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    monto
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos.
  </td>

  <td style={{ textAlign: "left" }}>
    Monto a procesar total de la orden o\
    pedido calculado en su aplicación en base\
    a la selección de los servicios y/o productos del cliente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    transaccionId
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    referencia
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 20 caracteres.\ <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Referencia libre de uso para su aplicación
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    tarjeta
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo 16 números sin espacios para Visa y Mastercard
  </td>

  <td style={{ textAlign: "left" }}>
    Número de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    tipo
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números hasta con 2 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    El Tipo de Tarjeta que se está enviando. Posibles valores:\
    01= Tarjeta de Crédito\
    02= Tarjeta de Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    mes
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 2 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Mes de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    anio
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 4 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Año de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    digitos
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 3 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Dígitos Verificadores de la Tarjeta de Crédito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    titular
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo Letras, Espacios y Puntos
  </td>

  <td style={{ textAlign: "left" }}>
    Nombre completo del Titular tal cual aparece en la Tarjeta de Crédito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    diferimiento
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 2 dígitos\ <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Para compras de promoción, el número de meses que se concederá al cliente para empezar a pagar (compre hoy pague después). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 03 (pague dentro de 3 meses)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    numeroPagos
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 2 dígitos\ <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Para compras de promoción, el plazo en que se diluye el pago del cliente (compras a meses con o sin intereses). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 06 (pague en seis mensualidades)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    plan
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 2 dígitos\ <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Para compras de promoción, indica si ésta se hace con intereses o no al cliente. Valores posibles: 03 = Sin intereses 05 = Con intereses 07 = Sólo diferimiento inicial
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    xid
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    VISA 40 Caracteres\
    MC 28 Caracteres\ <span style="color:red">(Solo para 3D secure)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Criptograma retornado por Visa o MasterCard según sea el caso.\
    No enviar si es Nulo o Blanco
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    cavv
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    VISA 40 Caracteres\
    MC 28 Caracteres\ <span style="color:red">(Solo para 3D secure)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Criptograma retornado por Visa o MasterCard según sea el caso.\
    No enviar si es Nulo o Blanco
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    eci
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Código de Seguridad\ <span style="color:red">(Solo para 3D secure)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Valores Posibles: 05, 06, 07, 01, 02
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    status\_3d
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 3 dígitos\ <span style="color:red">(Solo para 3D secure)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    variable que sirve para\
    identificar si una Transacción\
    fue autenticada exitosamente\
    Status = 200 Autenticación\
    Exitosa\
    Status \<> 200 Autenticación No Exitosa
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    subcomercio
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite números sin espacios.\ <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    Se envía el Identificador en caso de que este Comercio pertenezca a algún Aliado previamente registrado en OpenLinea
  </td>
</tr>
VARIABLE
comercioId

Variables de Retorno

La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:

  <th>
    FORMATO
  </th>

  <th>
    RESTRICCIONES
  </th>

  <th>
    DESCRIPCION
  </th>
</tr>

  <td>
    Numérico
  </td>

  <td>
    Números sin espacios
  </td>

  <td>
    Identificador del Comercio en OPENLINEA. Es un valor asignado.
  </td>
</tr>

<tr>
  <td>
    transaccionID
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Letras y/o números sin espacios. No mayor a 20 caracteres.
  </td>

  <td>
    Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
  </td>
</tr>

<tr>
  <td>
    fechaTransaccion
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Representación de fecha con formato MM/DD/AA
  </td>

  <td>
    Fecha procesamiento de la Operación
  </td>
</tr>

<tr>
  <td>
    horaTransaccion
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Representación de hora con formato HH:MM:SS
  </td>

  <td>
    Hora de procesamiento de la Operación.
  </td>
</tr>

<tr>
  <td>
    monto
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos.
  </td>

  <td>
    Monto a procesar total de la orden o pedido calculado en su aplicación en base a la selección de los servicios y/o productos del cliente.
  </td>
</tr>

<tr>
  <td>
    codigoRespuesta
  </td>

  <td>
    Numérico
  </td>

  <td>
    Números sin espacios.
  </td>

  <td>
    Se regresa los siguientes valores:\
    0 = Aprobada,\
    1 = Rechazada
  </td>
</tr>

<tr>
  <td>
    procReturnMsg
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Alfanumérico de 1 a 10 caracteres
  </td>

  <td>
    Código retornado por el procesador de la tarjeta.
  </td>
</tr>

<tr>
  <td>
    ccErrCode
  </td>

  <td>
    Numérico
  </td>

  <td>
    Numérico de longitud variable. No mayor a 4 caracteres.
  </td>

  <td>
    Código devuelto por la Institución Financiera
  </td>
</tr>

<tr>
  <td>
    ccReturnMsg
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Alfanumérico de longitud variable
  </td>

  <td>
    Texto específico retornado por el procesador de pagos
  </td>
</tr>

<tr>
  <td>
    codigoAprobacion
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Alfanumérico de longitud variable
  </td>

  <td>
    Código de Aprobación Bancaria, típicamente con 6 Dígitos
  </td>
</tr>

<tr>
  <td>
    referenciaTransaccionBancaria
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Alfanumérico de longitud variable.
  </td>

  <td>
    Numero de afiliación con la que es ejecutada la Operación.
  </td>
</tr>
VARIABLE
comercioId

Formato de envío

📘

ecommercePreAutorizacion Desarrollo

https://servertest.operacionesenlinea.com/gateway/opGateway.asmx?op=ecommercePreAutorizacion

📘

ecommercePreAutorizacion Produccion

https://servidorseguro.operacionesenlinea.com/gateway/OpGateway.asmx?op=ecommercePreAutorizacion