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
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| contraseña | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 12 caracteres. | Clave de Acceso a la Terminal Virtual, configurado para su aplicación. |
| modo | Carácter | Admite una solo letra | Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada |
| monto | Numérico | Admite 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 |
| transaccionId | Alfanumérico | Admite 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. |
| referencia | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. (Opcional) | Referencia libre de uso para su aplicación |
| tarjeta | Numérico | Admite solo 16 números sin espacios para Visa y Mastercard | Número de la Tarjeta de Crédito o Débito |
| tipo | Numérico | Admite solo números hasta con 2 dígitos | El Tipo de Tarjeta que se está enviando. Posibles valores: 01= Tarjeta de Crédito 02= Tarjeta de Débito |
| mes | Numérico | Admite solo números con 2 dígitos | Mes de Vencimiento de la Tarjeta de Crédito o Débito |
| anio | Numérico | Admite solo números con 4 dígitos | Año de Vencimiento de la Tarjeta de Crédito o Débito |
| digitos | Numérico | Admite solo números con 3 dígitos | Dígitos Verificadores de la Tarjeta de Crédito |
| titular | Alfanumérico | Admite solo Letras, Espacios y Puntos | Nombre completo del Titular tal cual aparece en la Tarjeta de Crédito |
| diferimiento | Numérico | Admite solo números con 2 dígitos (Opcional) | 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) |
| numeroPagos | Numérico | Admite solo números con 2 dígitos (Opcional) | 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) |
| plan | Numérico | Admite solo números con 2 dígitos (Opcional) | 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 |
| xid | Alfanumérico | VISA 40 Caracteres MC 28 Caracteres (Solo para 3D secure) | Criptograma retornado por Visa o MasterCard según sea el caso. No enviar si es Nulo o Blanco |
| cavv | Alfanumérico | VISA 40 Caracteres MC 28 Caracteres (Solo para 3D secure) | Criptograma retornado por Visa o MasterCard según sea el caso. No enviar si es Nulo o Blanco |
| eci | Alfanumérico | Código de Seguridad (Solo para 3D secure) | Valores Posibles: 05, 06, 07, 01, 02 |
| status_3d | Numérico | Admite solo números con 3 dígitos (Solo para 3D secure) | variable que sirve para identificar si una Transacción fue autenticada exitosamente Status = 200 Autenticación Exitosa Status <> 200 Autenticación No Exitosa |
| subcomercio | Numérico | Admite números sin espacios. (Opcional) | Se envía el Identificador en caso de que este Comercio pertenezca a algún Aliado previamente registrado en OpenLinea |
Variables de Retorno
La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Números sin espacios | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| transaccionID | Alfanumérico | 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. |
| fechaTransaccion | Alfanumérico | Representación de fecha con formato MM/DD/AA | Fecha procesamiento de la Operación |
| horaTransaccion | Alfanumérico | Representación de hora con formato HH:MM:SS | Hora de procesamiento de la Operación. |
| monto | Numérico | Admite 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. |
| codigoRespuesta | Numérico | Números sin espacios. | Se regresa los siguientes valores: 0 = Aprobada, 1 = Rechazada |
| procReturnMsg | Alfanumérico | Alfanumérico de 1 a 10 caracteres | Código retornado por el procesador de la tarjeta. |
| ccErrCode | Numérico | Numérico de longitud variable. No mayor a 4 caracteres. | Código devuelto por la Institución Financiera |
| ccReturnMsg | Alfanumérico | Alfanumérico de longitud variable | Texto específico retornado por el procesador de pagos |
| codigoAprobacion | Alfanumérico | Alfanumérico de longitud variable | Código de Aprobación Bancaria, típicamente con 6 Dígitos |
| referenciaTransaccionBancaria | Alfanumérico | Alfanumérico de longitud variable. | Numero de afiliación con la que es ejecutada la Operación. |
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