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

VARIABLEFORMATORESTRICCIONESDESCRIPCION
comercioIdNuméricoAdmite números sin espacios.Identificador del Comercio en OPENLINEA. Es un valor asignado.
contraseñaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
modoCarácterAdmite una solo letraIdentificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada
montoNuméricoAdmite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos.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
transaccionIdAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 20 caracteres.Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
referenciaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 20 caracteres. (Opcional)Referencia libre de uso para su aplicación
tarjetaNuméricoAdmite solo 16 números sin espacios para Visa y MastercardNúmero de la Tarjeta de Crédito o Débito
tipoAlfanuméricoAdmite letras. Solo debe contener 2 caracteresEl Tipo de Tarjeta que se está enviando. Posibles valores:
CR = Tarjeta de Crédito
DB = Tarjeta de Débito
mesNuméricoAdmite solo números con 2 dígitosMes de Vencimiento de la Tarjeta de Crédito o Débito
anioNuméricoAdmite solo números con 4 dígitosAño de Vencimiento de la Tarjeta de Crédito o Débito
digitosNuméricoAdmite solo números con 3 dígitosDígitos Verificadores de la Tarjeta de Crédito
dirIPAlfanuméricoAdmite Números y PuntosDirección IP de quién realiza la Operación, es decir del acceso a Internet del Cliente Final o Navegante.
versionNuméricoAdmite letras y/o números sin espacios. No mayor a 20 caracteres. (Opcional)Version de SDK (En caso de uso)

Variables de Retorno

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

VARIABLEFORMATORESTRICCIONESDESCRIPCION
comercioIdNuméricoNúmeros sin espaciosIdentificador del Comercio en OPENLINEA. Es un valor asignado.
terminalIdAlfanuméricoLetras y/o números sin espacios. No mayor a 20 caracteres.Identificador unico en donde se realizo la transaccion
transaccionIDAlfanuméricoLetras y/o números sin espacios. No mayor a 20 caracteres.Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
fechaTransaccionAlfanuméricoRepresentación de fecha con formato MM/DD/AAFecha procesamiento de la Operación
horaTransaccionAlfanuméricoRepresentación de hora con formato HH:MM:SSHora de procesamiento de la Operación.
montoNuméricoAdmite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos.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.
referenciaAlfanuméricoAlfanumérico de longitud variableReferencia libre de uso para su aplicación
numeroControlAlfanuméricoAlfanumérico de longitud variableCodigo retornado de identificador de transaccion
afiliacionAlfanuméricoAlfanumérico de longitud variable.Numero de afiliación con la que es ejecutada la Operación
tarjetaTipoAlfanuméricoAlfanumérico de longitud variable.Tipo de tarjeta con la cual se realizo el cargo
tarjetaMarcaAlfanuméricoAlfanumérico de longitud variable.marca de la tarjeta con la cual se realizo el cargo
bancoEmisorAlfanuméricoAlfanumérico de longitud variable.Nombre del banco encargado de realizar el cargo
codigoRespuestaNuméricoNúmeros sin espacios.Se regresa los siguientes valores:
0 = Aprobada,
1 = Rechazada
procReturnMsgAlfanuméricoAlfanumérico de 1 a 10 caracteresCódigo retornado por el procesador de la tarjeta.
ccErrorCodeNuméricoNumérico de longitud variable. No mayor a 4 caracteres.Código devuelto por la Institución Financiera
ccReturnMsgAlfanuméricoAlfanumérico de longitud variableTexto específico retornado por el procesador de pagos
codigoAprobacionAlfanuméricoAlfanumérico de longitud variableCódigo de Aprobación Bancaria, típicamente con 6 Dígitos
auth_resultAlfanuméricoAlfanumérico de longitud variableResultado de la operacion

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