El método de CANCELACION le permite CANCELAR de forma TOTAL un cargo a Tarjeta previamente APROBADO.
Para efectuar la CANCELACIÓN de un CARGO previamente APROBADO, se requiere enviar una petición de tipo POST, adicionar en el HEADER de la petición las Credenciales necesarias para acceder al servicio, estas son comercioId y contrasena. Los cuales deberán contener los valores asignados por Operaciones en Línea al momento de generada su Afiliación. Como parte del POST se deberán incluir los siguientes parámetros:
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| 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 TOTAL DE LA VENTA que será el monto a CANCELAR, este monto será calculado por su aplicación en base a la Venta previamente realizada. |
| 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. |
| codigoAprobacion | Numérico | Admite números sin espacios | Código de Aprobación Bancaria, típicamente con 6 Dígitos |
| referencia | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Referencia libre de uso para su aplicación |
| dirIP | Numérico | Admite Números y Puntos | Dirección IP de quién realiza la Operación, es decir del acceso a Internet del Cliente Final o Navegante. |
El servicio responderá enviando 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. | os. 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 por 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, 2 = Pendiente |
| 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 |
| afiliacion | Alfanumérico | Alfanumérico de longitud variable. | Numero de afiliación con la que es ejecutada la Operación. |
Crear Tarjeta Desarrollo
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/cancelaciones/
Crear Tarjeta Produccion
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/cancelaciones