ANEXO III. Diccionario de Datos

 

A continuación se describen todos los campos que se pueden encontrar en los XML de respuesta de los distintos métodos de la librería.

 

  • tarjeta: número de tarjeta. Constará de 15 a 19 posiciones. Este campo solamente podrá ser informado si el comercio que realiza la transacción tiene permiso para realizar entrada manual de datos. Consulte con su Entidad si su comercio dispone de esta posibilidad.
  • caducidad: caducidad de la tarjeta en formato AAMM. Este campo solamente podrá ser informado si el comercio que realiza la transacción tiene permiso para realizar entrada manual de datos. Consulte con su Entidad si su comercio dispone de esta posibilidad.
  • cvc2: código de tres dígitos de seguridad que viene impreso generalmente en el reverso de la tarjeta, y que será necesario dependiendo de la actividad del comercio. Consulte con su Entidad si su comercio debe enviar obligatoriamente este campo.
  • importe: Importe de la operación en formato N.NN. Ej: 1.00
  • moneda: código de la moneda de la operación. Valores -> 978 (Euros), 840 (Dólares). Este dato depende de la moneda que tenga asociada el terminal por el que se realice la operación.
  • comercio: FUC o código del comercio. Consta de 9 dígitos.
  • terminal: terminal en el que se realiza la operación. Numérico del 1 al 99. Es imprescindible que el terminal se encuentre dado de alta en REDSYS antes de realizar alguna operación sobre él.
  • csb: Merchant al que pertenece el terminal. Consta de 4 dígitos.
  • factura: cadena alfanumérica que el comercio podrá utilizar como identificador para asociar una venta con su transacción TPVPC correspondiente. REDSYS no validará el formato ni la duplicidad de esta cadena, siendo responsabilidad del comercio. El tamaño máximo de esta cadena puede ser de 20 caracteres.
  • pedido: número de pedido u operación asociado a la transacción. Este número es devuelto por el TPVPC y servirá para identificar una determinada operación en un comercio / terminal definido.
  • identificadorRTS: identificador de la operación Esta cadena de 24 posiciones es devuelta por el TPVPC y servirá para identificar una determinada operación en un comercio / terminal definido.
  • tipoPago: tipo de operación que desea realizarse. Valores: PAGO -> autorización normal, PREAUTORIZACION -> preautorización, RECARGA -> recarga de móviles, PREAUT_REEMPLAZO -> reemplazo de preautorizaciones, ANULACION -> anulación de preautorizaciones.
  • firma: contiene la firma del mensaje en formato Hexadecimal (40 caracteres)
  • fechaOperacion: fecha y hora de la operación en formato YYYY-MM-DD hh:mm:ss.miliseg
  • estado: estado de la operación. Valores -> F (finalizada), P(en proceso), T(fallo técnico), G(Denegada)
  • resultado: resultado de la operación. Valores -> Autorizada, Denegada.
  • codigoRespuesta: contiene el código de autorización de la operación, en el caso de operación Aceptada, o el código de denegación en caso de que la operación hay sido Denegada (ver Anexo VII). Este campo no se informa en el caso de las Devoluciones/Confirmaciones Autorizadas.
  • pedidoBase: número de pedido de la operación sobre la que se quiere realizar una operación de devolución, confirmación, anulación o reemplazo.
  • idRTSOriginal: identificadorRTS de la operación original sobre la que se realizará una operación de devolución, confirmación, anulación o reemplazo.
  • timestamp: fecha y hora en la que se monta el mensaje de petición, en formato yyyyMMdd HHmmss. Este dato permitirá conocer si un mensaje está caducado, con el fin de impedir que una persona no autorizada reutilice el mensaje para realizar operaciones.
  • descripcion: detalle del error producido. En caso de un error de formato, se incluye el campo que provoca el error. La inclusión de este campo en el mensaje de salida es opcional.
  • mensaje: mensaje de información del error.
  • codigo: código de error devuelto por el TPVPC
  • codigoDivisa: código numérico asociado a la moneda en la que se desea realizar la transacción DCC (Dynamic Currency Conversion).
  • importeDivisa: Importe resultante de la operación DCC en la divisa especificada en el codigoDivisa.
  • importeOriginal: Importe del que se desea obtener el cambio en la correspondiente divisa para operaciones DCC. El código de la moneda asociada a dicho importe se especifica en el atributo ‘codMoneda’. Si no se informa dicho atributo, toma el valor por defecto ‘978’ (EURO).
  • tasaCambio: cambio aplicado para realizar la conversión de moneda para la operativa DCC.
  • nombreDivisa: nombre de la moneda en la que se desea realizar la transacción DCC (Dynamic Currency Conversion).
  • simboloDivisa: codigo reducido que identifica a la moneda en la que se desea realizar la transacción DCC.
  • formatoDivisa: número de decimales de la moneda en la que se desea realizar la transacción DCC.
  • porcentajeComision: comisión (en %) que se aplica para calcular el importe de la divisa.
  • tasaDivisaConComision: cambio aplicado para realizar la conversión de moneda para la operativa DCC (igual que tasaCambio).
  • tasaDivisaSinComision: cambio aplicado para realizar la conversión de moneda para la operativa DCC sin aplicarle el porcentaje de la comisión.
  • literal: literales que devuelve el TPVPC y que deben aparecer en la boleta que imprime el comercio, en el orden en que se envían en el mensaje de respuesta.
  • numTeléfono (datosRecarga): número de teléfono a recargar.
  • idOperador: identificador del operador al que está asociada la tarjeta telefónica. Sus valores son 0 -> AMENA, 1 -> MOVISTAR, 2 -> VODAFONE, 3 -> EUSKALTEL, 4 -> XFERA.
  • idTransOperador: número de referencia asignado a la transacción por el operador correspondiente. Este valor debe aparecer en el recibo de la operación.
  • plazoPago: código de fraccionamiento que indica el tipo de aplazamiento que se realizará.
  • tarjetaComercioRecibo: número de la tarjeta que se imprimirá en el recibo del comercio. Esta se imprimirá en la boleta asteriscada o no dependiendo de la configuración del comercio para su propia boleta.
  • tarjetaClienteRecibo: número de la tarjeta que se imprimirá en el recibo del cliente. Esta se imprimirá en la boleta asteriscada o no dependiendo de la configuración del comercio para la boleta del cliente.
  • titularTarjeta: nombre del titular de la tarjeta.
  • tipoOperacion: tipo de la operación realizada (Autorizacion, Preaurorizacion, Devolucion, Confirmacion).
  • fechaOper: fecha de la operación en formato YYYY-MM-DD para las consulta de una operación.
  • operacionemv: Indica que se trata de una operación EMV.
  • conttrans: Contador de transacciones recibido de tarjeta EMV.
  • sectarjeta: Campo recibido de tarjeta EMV.
  • idapp: Campo recibido de tarjeta EMV.
  • etiquetaApp: Campo recibido de tarjeta EMV
  • resverificacion: Campo recibido de tarjeta EMV.
  • marcaTarjeta: Indicala marca de la tarjeta utilizada en la operación. Sus posibles valores son:

VISA = 1

MASTERCARD = 2

DINERS = 6

AMEX = 8

JCB = 9

CUP = 22

  • paisTarjeta: Indica el código ISO-3166 numérico de 3 cifras de la tarjeta. Sólo disponible en determinadas operativas. 
  • tipoTasaAplicada: Indica la tasa aplicada (Crédito / Débito) en la respuesta de las autorizaciones OK de tarjetas nacionales en terminales nacionales. Sus valores son Crédito -> CRED, Débito -> DEB.
  • ReciboSoloCliente: Indicador para imprimir sólo el recibo para el cliente.
  • reciboOpcional: Indicador que permite no imprimir recibos, siempre que se reciba en la respuesta con valor TRUE.
  • autenticadoPorPin: Indicador de autenticación por pin, afecta a la impresión de recibo. No se debe imprimir el recuadro de firma, en el Recibo para el comercio, ya que el usuario se autentico introduciendo el PIN de su tarjeta.