Procesa un Cargo a partir del Token de una Tarjeta
Para efectuar una VENTA 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
| 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 |
| token | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | TOKEN mediante el cual se identifica de forma única a la TARJETA, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de Tarjeta. |
| 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. |
| token | Alfanumérico | Letras y/o números sin espacios. No mayor a 20 caracteres. | TOKEN mediante el cual se identifica de forma única a la VENTA, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de la transaccion |
| tarjeta | Numérico | Admite solo 16 números sin espacios para Visa, Mastercard y American Express | Número de la Tarjeta de Crédito o Débito |
| 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. |
| ccErrorCode | 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
tokenVenta Desarrollo
https://servertest.operacionesenlinea.com/gateway/opGateway.asmx?op=tokenVenta
tokenVenta Produccion
https://servidorseguro.operacionesenlinea.com/gateway/OpGateway.asmx?op=tokenVenta