API Reference

Cargos Recurrentes

Procesa un Cargo a partir del Token de una Tarjeta

Para efectuar un CARGO RECURRENTE con CARGO AL TARJETAHABIENTE, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado el cual le permitirá procesar una transacción.

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" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras. Solo debe contener 2 caracteres
  </td>

  <td style={{ textAlign: "left" }}>
    El Tipo de Tarjeta que se está enviando. Posibles valores:\
    CR = Tarjeta de Crédito\
    DB = 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" }}>
    dirIP
  </td>

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

  <td style={{ textAlign: "left" }}>
    Admite Números y Puntos
  </td>

  <td style={{ textAlign: "left" }}>
    Dirección IP de quién realiza la Operación, es decir del acceso a Internet del Cliente Final o Navegante.
  </td>
</tr>

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

  <td style={{ textAlign: "left" }}>
    Numé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" }}>
    Version de SDK (En caso de uso)
  </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>
    terminalId
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Identificador unico en donde se realizo la transaccion
  </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>
    referencia
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Referencia libre de uso para su aplicación
  </td>
</tr>

<tr>
  <td>
    numeroControl
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Codigo retornado de identificador de transaccion
  </td>
</tr>

<tr>
  <td>
    afiliacion
  </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>

<tr>
  <td>
    tarjetaTipo
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Tipo de tarjeta con la cual se realizo el cargo
  </td>
</tr>

<tr>
  <td>
    tarjetaMarca
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    marca de la tarjeta con la cual se realizo el cargo
  </td>
</tr>

<tr>
  <td>
    bancoEmisor
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Nombre del banco encargado de realizar el cargo
  </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>
    ccErrorCode
  </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>
    auth\_result
  </td>

  <td>
    Alfanumérico
  </td>

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

  <td>
    Resultado de la operacion
  </td>
</tr>
VARIABLE
comercioId

Formato de envío

📘

recurrentesCargo Desarrollo

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

📘

recurrentesCargo Produccion

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