Conexion A Través de Webservices PDF

CONEXIÓN CON TPV PC A TRAVÉS DE WEB SERVICE
Versión: 2.16
03/08/2015
Referencia SM.DE.DNC.MAN.0010
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 i
Autorizaciones y control de versión

La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros
Versión Fecha Afecta Breve descripción del cambio
Nueva versión que recoge las versiones

disponibles hasta ahora e incluye nuevas
funcionalidades:
Personalización de la tarjeta en el recibo,
Mensajes de según sea para el comercio o el cliente.
1.0 26/07/05 petición/respuesta. Literales para DCC
Firma del mensaje Literales por tipo de tarjeta.
Inclusión de un nuevo campo para
optimizar accesos.
Consulta de una operación.
Operativa EMV.
Actualización de los ejemplos de xml

recibidos en operaciones EMV y
Mensajes de descripción de nuevos campos.
1.3 04/01/07
petición/respuesta
Modificación de los ejemplos de recibo y
campo marcaTarjeta.
Mensajes de Resultado devuelto G cuando la operación

1.4 19/01/07
petición/respuesta está denegada.
Mensajes de
Respuesta de las
Se incluye el dato tipoTasaAplicacion:
1.5 30/01/07 autorizaciones y
Crédito/Débito en las autorizaciones.
consultas de
operaciones
Se agregan nuevos campos en resultado

de operación EMV, cuando deniega la
1.6 15/03/07 Nuevos campos
transacción la tarjeta. Se agregan
ejemplos de recibo en este caso.
Sustituye los textos de los esquemas por
las rutas de los distintos entornos donde
Anexo III esquema está publicado.
1.7 17/03/09
y ejemplos de XML Revisa los ejemplos XML enviados y
devueltos por el servicio web, añade
nuevos ejemplos.
Retira CRED/DEB de los recibos con DCC

1.8 19/02/07 Recibos con DCC y modifica literal que decía “versión web
service 6.3”.
1.9 10/02/07 Anexo III esquema Ruta del esquema en desarrollo de 3006
Mensajes de error
Alta de un mensaje de error y
2.0 04/06/07 y configuración
configuración para dispositivos USB.
dispositivo
Se actualizan los recibos de la operativa

2.2 04/07/07 Recibos DCC DCC tanto para operativa normal como
para operativa EMV
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 ii
Se agregan nuevos campos resultado de

la operativa EMV, Pin y firma digitalizada.
Se agrega nueva operativa para devolver

Operativa tarjeta tarjeta en claro antes de realizar la
2.4 17/01/08
en claro operación. Se describe nuevo método del
activeX ContPeticionOperacion.
Se añade el campo puntosCaixa para

2.5 20/06/08 Nuevos Campos devolver las etiquetas a usar para la
operativa de Puntos Caixa.
Se agregan nuevos campos en resultado

de operación EMV, cuando deniega la
transacción la tarjeta. Se agregan
ejemplos de recibo en este caso.
Devolución sin Se incluye la operación de devolución sin
2.8 17/03/09
original original.
Literales para Se agrega la información a incluir en las

2.9 04/05/09 operaciones boletas cuando se reciben los códigos de
denegadas denegación 202 o 209
Anexo III: Códigos

2.10 01/12/10 Actualización de códigos de denegación
de denegación
Mensajes de Nueva operativa de pagos con tarjeta en

2.11 24/05/11
petición/respuesta archivo
Se actualizan los textos y las direcciones

2.12 07/07/11 URL de conexión
de las URL’s de conexión.
4- Descripción de Actualización de la lista de operadores

2.13 12/07/11
los campos posibles para la recarga de móviles.
Actualización Devolución sin Original

2.14 12/09/11
(tarjeta en la respuesta)
2.15 16/09/14
2.16 03/08/15 Documentación WSDL actualizadas
2.17 25/04/2016 Firma Actualización Firma SHA-256
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 iii

ÍNDICE DE CONTENIDO
1. Introducción ........................................................................................... 1
2. Cliente de acceso al servicio SOAP............................................................. 2
3. Seguridad de la información ..................................................................... 3
4. Descripción de los datos ........................................................................... 4
5. Funcionalidad del Web Service TPV PC ....................................................... 9

5.1 Opciones de Pago ............................................................................... 9
5.2 Consultas .........................................................................................11
5.2.1 Consulta de datos específicos ........................................................11
5.2.2 Consulta de una operación. ...........................................................12
5.3 Recargas Telefónicas ..........................................................................15
5.4 Anulación y Reemplazo de Preautorizaciones.........................................16
5.5 Repetición de pagos con tarjeta en archivo ...........................................17
5.6 Ejemplos de mensajes .......................................................................18
6. Integración con TPV PC ...........................................................................27

6.1 Integración con TPV PC operativa Normal .............................................27
6.2 Integración con TPV PC operativa EMV .................................................28
7. Control de Duplicidad de operaciones .......................................................31

7.1 Sistema de Consulta de operaciones por Web Service. ...........................31
7.2 Sistema de control de duplicidad. ........................................................31
8. Anexo I. Generación de firmas .................................................................33

8.1 Mensajes de PAGO / PREAUTORIZACION / RECARGA /
PAGO_TJT_ARCHIVO inicial .................................................................34
8.1.1 Mensaje de Petición......................................................................34
8.1.1.1 Mensajes de Operaciones Recurrentes. .....................................39
A. Primera Operación. Generación de Token. .................................39
B. Operación Recurrente con Token. .............................................40
8.1.2 Mensaje de Respuesta de Operación ...............................................41
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 iv
8.1.3 Mensaje de Respuesta de Opciones de Pago ....................................48

8.2 Mensajes de DEVOLUCION/CONFIRMACION ..........................................50
8.2.2 Mensaje de Respuesta ..................................................................51
8.3 Mensajes de Devolucion Sin Original ....................................................52

8.3.2 Mensaje de Respuesta ..................................................................53
8.4 Mensajes de CONSULTA .....................................................................54
8.4.1 Mensaje de Petición de consulta DCC ..............................................54
8.4.2 Mensaje de Respuesta de consulta DCC ..........................................55
8.4.3 Mensaje de Petición de consulta de una operación............................56
8.4.4 Mensaje de Respuesta de consulta de una operación ........................57
8.5 Mensajes de ANULACIÓN de Preautorizaciones ......................................59
8.6 Mensajes de REEMPLAZO de Preautorizaciones ......................................61
8.7 Mensajes de repetición de PAGO CON TARJETA EN ARCHIVO ..................65
9. Anexo II. Formato del recibo ...................................................................68
10. Anexo III. Códigos de Denegación ............................................................82
11. Anexo IV. Códigos de Actividad ................................................................87
12. Anexo V. Códigos de Error TPV PC ............................................................89
13. Anexo VI. Problemas más comunes ..........................................................96
14. Anexo VII: Ejemplo de un cliente en JAVA .................................................97
15. Anexo VIII: Esquema del Servicio Web ................................................... 100
16. Anexo IX. Flujo de Llamadas para operativa DCC ..................................... 101
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 v
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 vi
1. Introducción
El presente documento describe los pasos a seguir para poder

interactuar con el TPV PC a modo de Servicio Web, con el fin de que un
cliente (cualquier software ya existente en el Punto de Venta) pueda
realizar transacciones (pagos, devoluciones, etc.), recibiendo en el
instante el resultado de las mismas.
El fin de dicho acceso es permitir la realización de transacciones tanto

por parte de un operador humano (vía web tradicional), como por parte
de una aplicación externa (vía web service), la cual proporcionará al TPV
PC los datos necesarios para realizar el pago y recibirá la respuesta
correspondiente por medio de un servicio de mensajería XML.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 1
2. Cliente de acceso al servicio SOAP
El Servicio de Acceso al Web Service del TPV PC esta implementado con

la tecnología SOAP-XML. Simple Object Access Protocol (SOAP). SOAP es
un protocolo estándar, basado en XML, que permite la comunicación de
los servicios Web. SOAP facilita un mecanismo simple y consistente para
que una aplicación pueda enviar mensajes XML a otra aplicación. Para
la utilización dicho servicio será necesario usar esta tecnología.
Este servicio permite que de manera simple y fiable se pueda realizar

una petición de transacción al TPV PC.
El solicitante del servicio hará una petición al proveedor del servicio
(REDSYS) que devolverá el resultado de la misma.
Es necesario implementar un cliente SOAP que hará la llamada al

método encargado de iniciar la transacción.
1. Petición de transacción
2. Respuesta a la petición por Servicio
parte de REDSYS. Web
1
Servicio
Web
Solicitante S
O
AServicio
2 P Web
Comercio
(Proveedor Servicio)
El cliente SOAP tiene que enviar un XML al Servicio de Acceso al Servicio

Web que contendrá los datos del pago a realizar. Éste retornará otro
XML de respuesta.
Estos XML deben cumplir un determinado XML-SCHEMA (anexo VIII).
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 2
3. Seguridad de la información
Con el fin de que la información intercambiada entre los componentes

de la comunicación (generalmente, REDSYS y el comercio) sea fiable, se
establecerá un protocolo en el que se incluyen los siguientes aspectos:
 La comunicación entre los componentes del servicio se

establecerá mediante protocolo seguro SSL, el cual garantiza la
confidencialidad de la información.
 Todos los mensajes intercambiados (excepto los mensajes de
error) llevarán incluida una firma que permitirá verificar la
identidad del emisor del mensaje y garantizar la integridad de
los datos.
La firma se generará utilizando un algoritmo SHA-256, y consistirá en

aplicar dicho algoritmo a una cadena, que será el resultado de
concatenar una serie de campos que van en el mensaje junto con una
clave de cifrado (que será comunicada por REDSYS al comercio).
cadenaFirmada = SHA-256(cadenaFirma+claveComercio);
Dependiendo del tipo de mensaje, los campos utilizados para generar la

firma variarán. En el Anexo I se detallan dichos campos para cada tipo
de mensaje.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 3
4. Descripción de los datos
A continuación se detalla cada uno de los campos definidos en el

servicio, indicando su significado y en algunos casos su formato.
Remítase al Anexo VIII donde se especifican los XML-Schema que

siguen los mensajes para obtener una visión general de la estructura de
los mismos, donde van incluidos todos los campos, definidos a
continuación así como las restricciones de aparición, formato, etc.
 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. Ver Anexo IV para más información.
 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. Ver Anexo IV para más información.
 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 (Ver Anexo IV).
 lecturaBanda: lectura de la banda de la tarjeta, cifrada tal y
como es devuelta por el lector cifrador.
 codBarras: código de barras Mobipay asociado al teléfono del
titular. Consta de 13 dígitos. Este código permite la realización del
pago por medio del móvil
 numTeléfono (datosPagoMobipay): número de teléfono del

titular, utilizado en la compra. Este campo permitirá la realización
del pago por medio del móvil.
 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 TPV PC
correspondiente. REDSYS no validará el formato ni la duplicidad
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 4
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 TPV PC 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 TPV PC 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, PAGO_TJT_ARCHIVO -> pago con tarjeta en
archivo.
 datosAdicionales: cualquier información que el comercio
considere de interés y que será devuelta en el mensaje de
respuesta. El número de caracteres máximo permitido es de
1024. Se recomienda no incluir en este campo información
privada del titular, con el fin de respetar la Ley de Protección de
Datos. REDSYS no se hace responsable del contenido ni
utilización de dicho campo.
 firma: contiene la firma del mensaje en formato Hexadecimal (64
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. 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
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 5
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 TPV PC.
 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 TPV PC 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 -> ORANGE.
 1 -> MOVISTAR.
 2 -> VODAFONE.
 3 -> EUSKALTEL.
 4 -> YOIGO.
 5 -> MASmovil.
 6 -> ONO.
 7 -> HAPPYMOVIL.
 8 -> PEPEPHONE.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 6
 9 -> ORANGE F.
 10 -> METRORED.
 11 -> LEBARA.
 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 (Autorización,
Preaurorización, Devolución, Confirmación).
 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: Indica la marca de la tarjeta utilizada en la

operación. Sus valores son:
Marca Indicador
VISA 1
MASTERCARD 2
DINERS 6
AMEX 8
JCB 9
CUP 22
 tipoTasaAplicada: Indica la tasa aplicada (Crédito / Débito) en

la respuesta de las autorizaciones OK de tarjetas nacionales en
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 7
terminales nacionales. Sus valores son Crédito -> CRED, Débito -

> DEB.
 ReciboSoloCliente: Indicador para imprimir solo recibo cliente.
(Ver Anexo II).
 autenticadoPorPin: Indicador de autenticación por pin, afecta a
la impresión de recibo. (Ver Anexo II).
 puntosCaixa: Literal que contiene un texto a mostrar cuando la
operación ha resultado en la adjudicación de Puntos Estrella Caixa
para el titular de la compra. Afecta a la impresión del recibo (Ver
Anexo II).
 datosDCC: conjunto de literales en una transacción DCC (útiles
para generar recibo)
 linLitTrans: literal Transacción
 linLitDivisa: literal Código Divisa
 linMarca: literal Marca Tarjeta
 linMarkup: literal Mark-up
 linLitComision: literal Comisión
 linLitEntidad: literal Entidad
 linCambio: literal Cambio aplicado
 linLitInfCambio: literal información Cambio
 linLitInf: literal información
 token: Token asociado a la tarjeta y comercio. Para pagos
recurrentes.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 8
5. Funcionalidad del Web Service TPV PC
La WSDL que describe el Web Service TPV PC posee varios métodos que
dan soporte a toda la funcionalidad del sistema. A continuación se
detalla cada uno de esos métodos y para qué se utilizan:
trataPeticionPago
Se utiliza para la realización de los siguientes tipos de operaciones:
 Pagos
 Preautorizaciones
 Preautorizaciones de reemplazo (modificación de
preautorizaciones)
 Anulaciones
 Recargas de teléfonos móviles
 Primer pago con tarjeta en archivo
trataComunicacionContable
Permite la realización de Devoluciones y Confirmaciones sobre
operaciones de Pago y/o Preautorización.
trataPeticionInfo
Permite realizar consultas específicas en el TPV PC. Bien se consulta
una operación concreta o se consulta el cambio en divisas.
Cada tipo de operación deberá enviarse utilizando el método

correspondiente.
5.1 Opciones de Pago
Con esta funcionalidad se permite que TPV PC informe al comercio de si

la transacción actual tiene algún tipo de operativa adicional. Por ahora
existen los siguientes tipos de operativa adicional:
 Pago en Divisas (DCC o Dinamyc Currency Conversion):

permite que un titular con una tarjeta extranjera pueda pagar en
su propia moneda, conociendo de antemano el importe que se le
va a cargar y la tasa de cambio aplicada. Por otra parte, la
entidad abonará el importe correspondiente al comercio en
EUROS, como si la transacción se hubiera realizado en la moneda
local. Para utilizar la operativa DCC, el comercio debe estar dado
de alta previamente.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 9
 Mostrar Tarjeta en claro: antes de continuar con la

transacción, devuelve el número de tarjeta en claro. Operativa
sólo disponible en PinPad, y siempre que la entidad habilité su
uso.
Para utilizar esta nueva funcionalidad, se ha definido un nuevo flujo de

mensajes distinto al habitual, que se basaba en:
Petición Transacción  Resultado Transacción
El nuevo flujo se basa en que en el mensaje de petición de transacción,

el comercio incluye un elemento que indica a TPV PC que debe mostrarle
la operativa adicional que puede ofrecer a dicha transacción. De esta
forma, el TPV PC puede responder dos tipos de mensaje:
Resultado de la transacción: si la transacción actual no tiene

disponible ningún tipo de operativa adicional, se lleva a cabo la
transacción de manera habitual.
Opciones de pago: en el caso de que TPV PC pueda ofrecer algún tipo

de opción de pago adicional a la transacción actual. En este caso, el
comercio evaluaría las opciones que le ofrece TPV PC, pudiendo enviar la
petición de pago actualizada.
En este caso, el flujo de mensajería sería el siguiente:
Petición Transacción  Opciones de Pago  Petición Transacción

(actualizada o no)  Resultado Transacción
En caso de no querer utilizar esta operativa, en el mensaje inicial (1),

se establece al valor N el elemento <opcionesPago>
Por tanto, se debe tener en cuenta lo siguiente:
1. La inclusión de la etiqueta <opcionesPago> con el valor S en

el mensaje de pago indica que el TPV PC puede responder con
un mensaje en el que mostrará la opción de pago que pueda
ofrecer a la transacción.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 10
2. La omisión de la etiqueta <opcionesPago> o su inclusión con

el valor N en el mensaje de pago indica a TPV PC que el pago
se realizará tal y como se indica, siendo siempre el mensaje
de respuesta el resultado de la transacción o un mensaje de
error.
5.2 Consultas
Se pueden realizar consultas de una operación en concreto y consultas

sobre datos específicos como por ejemplo, el cambio de divisas. Para las
consultas se debe utilizar el método trataPeticionInfo.
5.2.1 Consulta de datos específicos
Las únicas consultas de datos específicos habilitadas en este momento

son las consultas de cambios de divisas, mediante las cuales un
comercio puede obtener el cambio para un determinado importe en la
moneda seleccionada.
A continuación se muestra un ejemplo de una petición de consulta:
1. Consulta de cambio de divisas:
<Operaciones version="6.0">
<consulta>
<datosConsulta>
<datosDivisas>
<importeOriginal>1.00</importeOriginal>
<monedaOriginal>978</monedaOriginal>
<codigoDivisa>840</codigoDivisa>
<comercio>123443210</comercio>
<terminal>1</terminal>
<csb>4000</csb>
</datosDivisas>
</datosConsulta>
<timestamp>20050722 170606</timestamp>
<firma>709DDD08D9551768373EF6E95D6057616FFD46B9A04F9447B28ACDB89E28F2
AD</firma>
</consulta>
</Operaciones>
2. Respuesta de TPV PC a la consulta:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 11
<resultadoConsulta>
<divisas>
<importeDivisa>7.11</importeDivisa>
<nombreDivisa>POUND STERLING</nombreDivisa>
<simboloDivisa>GBP</simboloDivisa>
<formatoDivisa>2</formatoDivisa>
<csb>4000</csb>
<nombreEntTermAct>REDSYS</nombreEntTermAct>
</divisas>
<firma>25F86731E193C6FCDF5E7567309EC080C237FC3A</firma>
</resultadoConsulta>
</Operaciones>
5.2.2 Consulta de una operación.
Mediante esta consulta se pueden obtener los datos de una operación

determinada realizada previamente.
A continuación se muestra un ejemplo de una petición de consulta de

operación:
1. Consulta de operación:
<consulta>
<datosConsulta>
<datosOperacion>
<pedidoBase>1193</pedidoBase>
<idRTSOriginal>70001050804122347070785</idRTSOriginal>
</datosOperacion>
</datosConsulta>
<firma>AC3D35BF5EA0283C1526E1113B9416122B1BDEFE33BCAF274FBACEE62EEA
EFBB</firma>
</consulta>
</Operaciones>
2. Respuesta de TPV PC a la consulta:
<resultadoConsulta>
<operacion>
<tipoOperacion>Autorizacion</tipoOperacion>
<tarjetaComercioRecibo>************0004</tarjetaComercioRecibo>
<tarjetaClienteRecibo>************0004</tarjetaClienteRecibo>
<caducidad>0606</caducidad>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 12
<importe>12.00</importe>
<moneda>978</moneda>
<pedido>1193</pedido>
<tipoTasaAplicada>CRED</tipoTasaAplicada>
<identificadorRTS>070001050804122347070785</identificadorRTS>
<fechaOperacion>2005-08-04 12:23:47.188</fechaOperacion>
<estado>F</estado>
<resultado>Autorizada</resultado>
<codigoRespuesta>070785</codigoRespuesta>
</operacion>
<firma>F4C833CBB97610646B552EAF0B95259B6059AA4958645268AB82AA5EE87356
53</firma>
</Operaciones>
3. Consulta de operación DCC:
<consulta>
<datosConsulta>
<datosOperacion>
</datosOperacion>
</datosConsulta>
<firma>CA13C6BE7B2CBFD3D971204171B989EB078C02624EE7B8ED466CB8E257126D91<
/firma>
</consulta>
</Operaciones>
4. Respuesta de TPV PC a la consulta operación DCC:
<resultadoConsulta>
<operacion>
<estado>F</estado>
<resultado>Denegada</resultado>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 13
</operacion>
<firma>EEC00BAB30D23A2DE8A9A75C11DE08097D21F44C1076B6B8513D03240A84ED00<
/firma>
</Operaciones>
5. Consulta de operación EMV:
<consulta>
<datosConsulta>
<datosOperacion>
</datosOperacion>
</datosConsulta>
<firma>FFDF121D056ACA0F38713B9D3A69F883A60E2737C111367267A2E9EE38B08769</fi
rma>
</consulta>
</Operaciones>
6. Respuesta de TPV PC a la consulta de operación EMV:
<resultadoConsulta>
<operacion>
<estado>F</estado>
</operacion>
<firma>1122E5E4D8148EF4EA4BC3539AA1D8D4E74131A5C676070B2099261E54C3985D </f
irma>
</Operaciones>
7. Consulta de Recarga Telefónica
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 14
<consulta>
<datosConsulta>
<datosOperacion>
</datosOperacion>
</datosConsulta>
<firma>8B9F009EBE8A3638271361AD04290F39F565443D1F241949F5CEF19DBE960E0C</fi
rma>
</consulta>
</Operaciones>
8. Respuesta de TPV PC a Recarga Telefónica
<resultadoConsulta>
<operacion>
<factura>FAC-11245B</factura>
<estado>F</estado>
</operacion>
<firma>C344926461890D4813C919E40CB5813A8AAB276F472136A0FAF95D9B94227DDC </f
irma>
</Operaciones>
5.3 Recargas Telefónicas
En la operativa de recarga de tarjetas telefónicas, el cliente aporta un

medio de pago para realizar la recarga. Dicho medio de pago irá
especificado en el mensaje.
Ejemplo de petición de RECARGA (método trataPeticionPago):
<operacion>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 15
<datosPago>
<datosPagoTarjeta>
<tarjeta>4545840300508033</tarjeta>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<tipoPago>RECARGA</tipoPago>
<datosRecarga>
<numTelefono>660189756</numTelefono>
<idOperador>1</idOperador>
</datosRecarga>
</datosCompra>
<firma>A47916DFA35CD6DF6F5F026DA124D7059550C1C0BF8028962D2888A3B56381
2E</firma>
</operacion>
</Operaciones>
Ejemplo Respuesta:
<resultadoOperacion>
<marcaTarjeta>1</marcaTarjeta>
<estado>F</estado>
<firma>43886D70CA339808442368FE2876907B5C258385BFF32A7B19C9BC9C82E2E7B4</
firma>
</resultadoOperacion>
</Operaciones>
5.4 Anulación y Reemplazo de Preautorizaciones
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 16
A partir de la versión 4.3 del protocolo, se incorporan dos

funcionalidades nuevas en el sistema. Dichas funcionalidades permiten
operar sobre operaciones de Preautorización ya procesadas
anteriormente.
Anulación de Preautorizaciones
Cuando se realiza una preautorización, la entidad emisora retiene la

cantidad especificada de la cuenta del titular hasta que se realiza una
confirmación (por igual o menor importe), o bien hasta que dicha
preautorización caduca (dependiendo de la entidad). En este último
caso, el titular no puede disponer de su dinero, por estar retenido.
La operativa de anulación permite anular aquellas preautorizaciones que

no van a ser confirmadas posteriormente (ya se ha pagado el bien por
algún otro medio, etc.), para que el titular pueda disponer de nuevo de
su dinero.
Reemplazo de Preautorizaciones
Si en lugar de querer anular una preautorización, lo que se pretende es

modificar su importe (un hotel podría querer ampliar una
preautorización si un cliente decide prolongar su estancia en el
establecimiento), es conveniente utilizar la funcionalidad de reemplazo
de preautorizaciones.
En este caso, si al intentar modificar una preautorización existente, la
entidad emisora deniega la modificación (por ejemplo, por falta de
fondos), la preautorización original seguirá activa por el importe
especificado en un principio.
5.5 Repetición de pagos con tarjeta en archivo
A partir de la versión 6.0 del protocolo se incorpora una nueva

funcionalidad al sistema. Ésta consiste en permitir la repetición de un
pago con tarjeta en Archivo.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 17
El pago con tarjeta en archivo permite poder repetir un pago hasta 99

veces (lo que equivaldría a hacer un pago 100 veces). La particularidad
que tiene es que los datos de la tarjeta y el importe sólo se capturan y
se envían la primera vez (pago con tarjeta en archivo inicial). El resto de
veces sólo hay que repetir dicho pago, sin necesidad de tener la tarjeta
del cliente.
Para poder usar esta operativa, el comercio debe haberla solicitado

previamente a la entidad.
5.6 Ejemplos de mensajes
A continuación se muestran ejemplos de peticiones y respuestas del TPV

PC
Ejemplo de petición de PAGO con entrada manual (método

trataPeticionPago):
<operacion>
<datosPago>
<datosPagoTarjeta>
<cvc2>567</cvc2>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<tipoPago>PAGO</tipoPago>
</datosCompra>
<firma>834B9C31758F6D216A3E8496DD33694A87E90A29B64A4A3113B318B89482A21D</
firma>
</operacion>
</Operaciones>
Ejemplo de respuesta ok:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 18
<estado>F</estado>
<firma>A6A22149F609DAA35BE053C92D5C308E0382F04D1F79189EBF9BF73574D
CEE09</firma>
</Operaciones>
Ejemplo de respueta de una operación DCC:
<resultadoConsulta>
<divisas>
<porcentajeComision>3.0000</porcentajeComision>
<tasaDivisaConComision>1.406925</tasaDivisaConComision>
<tasaDivisaSinComision>1.449133</tasaDivisaSinComision>
<csb>4000</csb>
</divisas>
<firma>7E355F267858818E043BC559C62EDC6969EDCD610750B13A7770673A4F0D0F5E</f
irma>
</Operaciones>
Ejemplo de respuesta ko:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 19
<estado>G</estado>
<firma>8A61C94D2D4C990A266F35613252BF5F5E4167412436D0EE97AF29FF300AD426</f
irma>
</Operaciones>
Ejemplo de peticion de PREAUTORIZACION con entrada manual (método

trataPeticionPago):
<operacion>
<datosPago>
<datosPagoTarjeta>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<tipoPago>PREAUTORIZACION</tipoPago>
</datosCompra>
<firma>C8E78EC550265944B7B5FC5BD4BE01FF0413F37343EE9DE0535F60A27D108D3E<
/firma>
</operacion>
</Operaciones>
Ejemplo de respuesta Autorizada:
<fechaOperacion>2005-07-28 08:57:52</fechaOperacion>
<estado>F</estado>
<firma>F079A5DF89A37765BAC349DE43230BC98DA71B39F39453C4DEC305476C239AA6
</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 20
Ejemplo de respuesta Denegada:
<tarjetaComercioRecibo>4545840300508033
</tarjetaComercioRecibo>
<tarjetaClienteRecibo>4545840300508033</tarjetaClienteRecibo>
<estado>F</estado>
<Literales>
<literal> </literal>
</Literales>
<firma>830E40F41618D97C9C886591176707368E3EE70EDCE418BB1EC410AD7ABF348C</firma>
</Operaciones>
Ejemplo de peticion de DEVOLUCION sobre una operación (método

trataComunicacionContable):
<comunicacionContable tipo="DEVOLUCION">
<datosEntrada>
<factura>fact_devol</factura>
<firma>46677DB3C6F2B1AC903EEA5A90A104389AA60BF701282D92C7193BF55C36E86C</firm
a>
</datosEntrada>
</comunicacionContable>
</Operaciones>
Ejemplo de respuesta a la petición de DEVOLUCION:
<resultadoComunicacion>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 21
<estado>F</estado>
<firma>584142C5A0AB4823BA7FC07DD2EC3C965B2808B88C253F5A5D7F485D1C0CC078</firm
a>
</resultadoComunicacion>
</Operaciones>
Ejemplo de Consulta de divisas (método trataPeticionInfo):
<consulta>
<datosConsulta>
<datosDivisas>
<csb>4000</csb>
</datosDivisas>
</datosConsulta>
<firma>E2D90C9A51FF76CD1BE8E9147E710C6F62DD9B388A316B7902DF823DC378D08D
</firma>
</consulta>
</Operaciones>
Ejemplo de respuesta a la petición de Consulta:
<resultadoConsulta>
<divisas>
<nombreDivisa>DOLAR U.S.A.</nombreDivisa>
<simboloDivisa>USD</simboloDivisa>
<csb>4000</csb>
</divisas>
<firma>CAEC00F6C8510879834650AC70049087C11333315A21293563F8AB89A7B91068</fi
rma>
</Operaciones>
Ejemplo de respuesta de error:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 22
<Operaciones>
<Error>
<codigo>SOAP-TPVPC0002</codigo>
<mensaje>Firma Incorrecta</mensaje>
<descripcion>Operaciones.operacion.firma</descripcion>
</Error>
</Operaciones>
Ejemplo de Anulación de una preautorización:
Petición:
<operacion>
<datosCompra>
<factura>fact_anul</factura>
<tipoPago>ANULACION</tipoPago>
</datosCompra>
<firma>5BB787DA2F7F28C01B9EC42A8BE50A87496547213AA840B2786F92F50861CF8D</firma>
</operacion>
</Operaciones>
Resultado:
<estado>F</estado>
<Literales>
</Literales>
<firma>35D2BA93AC5F57A0288CB4198BC0DD2BCC2E32D438C01FAE0B31FC20D6396EFD
</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 23
Ejemplo de Reemplazo de una preautorización
Petición:
<operacion>
<datosCompra>
<factura>fact_P_reem</factura>
<tipoPago>PREAUT_REEMPLAZO</tipoPago>
</datosCompra>
<firma>2A9B40C1F487F552C043A3F41E7E6FD9229DD42365AE8FF65E0461B96C6401DC</firma>
</operacion>
</Operaciones>
Resultado:
<estado>F</estado>
<Literales>
</Literales>
<firma>94D62F3B6EF6357C73D142E21E99D85F619EEBCB0C068BDDED57D1DFDBB09A54 </fir
ma>
</Operaciones>
Ejemplo de pago con tarjeta en archivo y posterior repetición
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 24
Petición
<operacion>
<datosPago>
<datosPagoTarjeta>
<cvc2>567</cvc2>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<tipoPago>PAGO_TJT_ARCHIVO</tipoPago>
</datosCompra>
<firma>FC2B262F99A6DE728570CA28AF3E73BEFF185BC9F51CA7095307B16FAC8D4289
</firma>
</operacion>
</Operaciones>
Ejemplo de respuesta ok:
<estado>F</estado>
<firma>A7545AFB374579F69164E89E90AE75F789DA3C29011A79ED34EA887C8AC
11F85</firma>
</Operaciones>
Una vez recibida la operación original y autorizada ésta, se puede repetir

(una y varias veces, hasta 99), realizando la siguiente petición:
<operacion>
<datosCompra>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 25
<factura>fact_rep</factura>
</datosCompra>
<firma>992664DCCA7C556D5E9DD02E49B330C36F1B06590B8726D6709395B7C8DC9660</firma>
</operacion>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 26
6. Integración con TPV PC
A continuación se detalla la secuencia de pasos a seguir a la hora de

integrar su aplicación cliente Web Service con el servidor TPV PC.
6.1 Integración con TPV PC operativa Normal
El primer paso, es el desarrollo del cliente Web Service, utilizando las

especificaciones de los XML Schemas y del cálculo de firmas detallado en
este documento.
Una vez hecho esto, puede iniciar las pruebas en el entorno de

desarrollo. Para ello, sólo necesita tres datos:
 Número del comercio. El número que le proporcionamos en

este documento es válido únicamente para el entorno de
DESARROLLO. En los entornos de INTEGRACIÓN y PRODUCCIÓN
deberá utilizar el número de comercio que tenga asignado en
REDSYS (consulte con su entidad para conocer este número). El
número a utilizar es el: 123443210
 Número de terminal. Al igual que el dato anterior, no es un
número fijo, sino que dependerá de los terminales que tenga
dados de alta su comercio. En DESARROLLO el terminal a utilizar
es el número 1.
 Clave a utilizar para la firma. Es un dato secreto que no
deberá dar a conocer a nadie, ya que garantizará la integridad y
la autoría de los mensajes intercambiados con el servidor TPV
PC. Las claves suelen ser distintas en los entornos de
INTEGRACIÓN y PRODUCCIÓN. La que deberá utilizar en el
entorno de DESARROLLO es: AAABBB
El entorno de DESARROLLO está preparado para admitir conexiones

HTTP para facilitar la tarea de desarrollo del cliente. En los entornos de
INTEGRACIÓN y PRODUCCIÓN la conexión se realizará siempre
mediante HTTPS.
Una vez desarrollado y probado el cliente Web Service en el entorno de

DESARROLLO, puede continuar las pruebas en el entorno de
INTEGRACIÓN o bien pasar directamente a PRODUCCIÓN. Para ello, su
entidad deberá comunicarle los datos necesarios (comercio, terminal y
clave) para el entorno especificado.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 27
Nota: el alta de su comercio para la utilización del web service no es

inmediato, requiriendo algunos días para ser efectiva. Si desea empezar
a trabajar con él, informe a su entidad lo antes posible para que
comunique a REDSYS la petición de alta.
Las URLs de acceso a la WSDL son las siguientes, para los distintos
entornos:
DESARROLLO:
Sin SSL:
https://sis-
d.redsys.es/TPV_PC/services/SerClsWSPeticionSOAP/wsdl/SerClsWSPeticionSOAP.wsdl
Con SSL (deberá instalarse el certificado sis-d.redsys.es):

https://sis-
d.redsys.es/TPV_PC/services/SerClsWSPeticionSOAP/wsdl/SerClsWSPeticionSOAP.wsdl
INTEGRACIÓN:
https://tpvpc-
i.redsys.es:27443/TPV_PC/services/SerClsWSPeticionSOAP/wsdl/SerClsWSPeticionSOAP.w
sdl
EXPLOTACIÓN:
https://tpvpc.redsys.es/TPV_PC/services/SerClsWSPeticionSOAP/wsdl/SerClsWSPeticionSO
AP.wsdl
Aunque las WSDLs de los entornos de INTEGRACIÓN y EXPLOTACIÓN no

estén publicadas con protocolo Seguro (SSL o https), los Servicios Web
a los que hacen referencia sí lo están.
Si experimenta algún problema al utilizar el protocolo SSL (no confía en

los certificados de servidor, etc.), diríjase al Anexo VI: Problemas
más comunes.
6.2 Integración con TPV PC operativa EMV
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 28
A continuación se detalla la secuencia de pasos a seguir a la hora de

integrar su aplicación cliente con el ActiveX de acceso al PINPAD.
El primer paso es desarrollar la comunicación entre su aplicación y el

ActiveX. A continuación se adjunta los datos necesarios para realizar
esta comunicación:
CLSID: 77C72BE4-E64B-481A-8032-2431F90CB250
Nombre (Requerido para acceder desde lenguajes que soporten script):

AxTpvpcPinPadWS.TpvpcPinPad. Por ejemplo:
objAxPINPAD= CreateObject(“AxTpvpcPinPadWS.TPVpcPinPad”)
Una vez hecho esto, puede iniciar las pruebas en el entorno de

desarrollo (ver URLs de acceso en el Anexo I). Para ello, sólo necesita
tres datos:
 Número del comercio. El número que le proporcionamos en este

documento es válido únicamente para el entorno de
DESARROLLO. En los entornos de INTEGRACIÓN y PRODUCCIÓN
deberá utilizar el número de comercio que tenga asignado en
REDSYS (consulte con su entidad para conocer este número). El
número a utilizar es el: 309571370
 Número de terminal. Al igual que el dato anterior, no es un
número fijo, sino que dependerá de los terminales que tenga
dados de alta su comercio. En DESARROLLO el terminal a utilizar
es el número 1.
 Clave a utilizar para la firma. Es un dato secreto que no deberá
dar a conocer a nadie, ya que garantizará la integridad y la
autoría de los mensajes intercambiados con el servidor TPV PC.
Las claves suelen ser distintas en los entornos de INTEGRACIÓN
y PRODUCCIÓN. La que deberá utilizar en el entorno de
DESARROLLO es: AAABBB
El entorno de DESARROLLO está preparado para admitir conexiones

HTTP y HTTPS para facilitar la tarea de desarrollo del cliente. En los
entornos de INTEGRACIÓN y PRODUCCIÓN la conexión se realizará
siempre mediante HTTPS, por lo que es interesante que realice algunas
pruebas en DESARROLLO con dicha conexión, para comprobar si
necesita alguna modificación o agregar algún certificado.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 29
Una vez desarrollado y probado el ActiveX en DESARROLLO, puede

continuar las pruebas en el entorno de INTEGRACIÓN o bien, pasar
directamente a PRODUCCIÓN. Para ello, su entidad deberá comunicarle
los datos necesarios (comercio, terminal y clave) para el entorno
especificado, así como la nueva ruta wsdl de acceso al TPV PC WS.
Nota: el alta de su comercio para la utilización del ActiveX para acceso

al Web-Service TPV PC no es inmediato, requiriendo algunos días para
ser efectiva. Si desea empezar a trabajar con él, informe a su entidad lo
antes posible para que comunique a REDSYS la petición de alta.
A continuación se muestra la wsdl correspondiente al Web Service TPV

PC. Este dato lo necesita el ActiveX para poder acceder al TPV PC.
Las URLs de acceso a la WSDL son las siguientes, para los distintos
entornos:
DESARROLLO:
Sin SSL:
https://sis-
d.redsys.es/TPV_PC/services/SerClsWSPasarelaPINPAD/wsdl/SerClsWSPasarelaPINPAD
.wsdl
INTEGRACIÓN:
https://tpvpc-
i.redsys.es:27443/TPV_PC/services/SerClsWSPasarelaPINPAD/wsdl/SerClsWSPasarelaP
INPAD.wsdl
EXPLOTACIÓN:
https://tpvpc.redsys.es/TPV_PC/services/SerClsWSPasarelaPINPAD/wsdl/SerClsWSPas
arelaPINPAD.wsdl
Aunque las WSDLs de los entornos de INTEGRACIÓN y EXPLOTACIÓN no

estén publicadas con protocolo Seguro (SSL o https), los Servicios Web
a los que hacen referencia sí lo están.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 30
7. Control de Duplicidad de operaciones
Debido al mecanismo de funcionamiento peticion/respuesta del

protocolo web service, uno de los principales problemas que puede
presentar es el hecho de que la comunicación se pierda en el transcurso
de la transacción, no pudiendo el comercio obtener ninguna respuesta
de lo que ha sucedido en el servidor TPV PC. En estos casos el comercio
puede proceder a reenviar la petición, si entiende que el mensaje no ha
llegado a su destino, o que se ha producido un error en el servidor, lo
que puede provocar que, en caso de que la primera petición hubiera sido
autorizada, se realicen dos cargos al cliente.
Muy importante a tener en cuenta por el comercio, es que el

campo TimeStamp si debe generarse de nuevo, el resto de los
valores debe permanecer invariable.
Para solventar esta situación, existen dos alternativas:
1-. Sistema de Consulta de operaciones por Web Service

2-. Sistema de control de duplicidad de operaciones
7.1 Sistema de Consulta de operaciones por Web Service.
Permite consultar operaciones en base a diversos parámetros como

pueden ser el número de tarjeta, intervalos de fechas, números de
pedido, etc. De esta forma el comercio, al no recibir respuesta, podría
enviar una consulta especificando el número de tarjeta y la fecha de la
transacción, para saber qué ha ocurrido.
Por favor, consulte el documento Consulta de Operaciones del TPV

PC a través de Web Service, para obtener más información sobre el
funcionamiento e implementación de dicho sistema. Además de las
consultas descritas en dicho documento, se puede consultar el apartado
9.3 Mensajes de CONSULTA del presente documento donde se
especifican nuevos mensajes.
7.2 Sistema de control de duplicidad.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 31
Este sistema controla que en un determinado intervalo de tiempo no se

puedan autorizar operaciones con idénticos datos (mismo comercio,
terminal, importe y tarjeta), con el fin de que, en caso de que el
comercio reintente la operación por desconocer el estado de la primera,
no se duplique el cargo al cliente. En el caso de detectar una operación
duplicada, el sistema devuelve un mensaje de error donde se indica el
estado de la operación original, y su número de pedido, con el fin de que
el comercio pueda localizar la transacción por medio del Módulo de
Administración TPV PC, o bien, mediante las consultas por web service.
Si desea obtener más información acerca del control de duplicidad,

consulte con su entidad.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 32
8. Anexo I. Generación de firmas
A continuación se detallarán los datos necesarios que se utilizarán para

generar las firmas en los mensajes de petición y respuesta.
El proceso de obtención de la firma será siempre el mismo en todos los

casos. Lo único que variará será la cadena de la que se obtiene. Los
pasos a seguir son los siguientes:
 Generación de la cadena a firmar: se obtiene concatenando una

serie de campos del mensaje y la clave del comercio (que será
proporcionada por REDSYS y será única por comercio). Dado que
los mensajes no tienen la misma estructura ni los mismos
elementos, no se podrá definir una sola forma de generarla.
Por ejemplo:
Cadena = tarjeta + caducidad + importe + moneda + comercio +

clave
 Generación de la firma: se aplica el algoritmo SHA-256 sobre la

cadena obtenida.
Firma = SHA-256(Cadena)
La firma resultante tiene una longitud de 32 Bytes, y será incluida en el

mensaje en formato HEXADECIMAL (64 caracteres).
REDSÝS ofrece a los comercios una URL https://sis-

d.redsys.es/TPV_PC/html/sha/sha256_WebService.html donde validar la
generación de la firma. La página solicitará los siguientes datos:
 Clave de Firma. Valor recuperado del módulo de
Administración del TPVPC.
 Cadena de datos. Datos de la operación según el formato
indicado.
Al pulsar sobre el link “Calcular SHA-256” se calculará la firma y se
mostrará un ejemplo del registro de operación completo a incluir en la
petición para su posterior procesamiento.
Para este cálculo no se envía ninguna información al TPVPC, todo el
código de la página de prueba se ejecuta en el navegador del cliente.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 33
A continuación se detallan los distintos mensajes, y los campos que se

utilizará para generar la firma en cada uno de ellos. La clave de
comercio que se va a utilizar en todos los ejemplos es:
AAABBB.
8.1 Mensajes de PAGO / PREAUTORIZACION / RECARGA /

PAGO_TJT_ARCHIVO inicial
8.1.1 Mensaje de Petición
La cadena que se firmará consta de los campos siguientes:
 tipoPago
 tarjeta
 caducidad
 codBarras
 numTelefono
 importe
 moneda
 codigoDivisa
 plazoPago
 comercio
 terminal
 numTelefono2
 idOperador
 timestamp
 ClaveComercio
Los campos subrayados dependen del medio de pago utilizado en la

transacción. Si el medio de pago utilizado es el número de la tarjeta y la
caducidad, se utilizará esta información para montar la cadena y no se
añadirán el resto de campos subrayados. Si se utiliza el código de
barras, será únicamente este dato el que se incluya. Igualmente, si se
utiliza el número de teléfono. En el caso de la lectura de banda, ese dato
no será incluido en la firma.
Por tanto, la cadena se formará de la siguiente manera:
Cadena = tipoPago + [tarjeta + caducidad] | [codBarras] |

[numTelefono1] + importe + moneda + [codigoDivisa] + [plazoPago] +
comercio + terminal + [numTelefono2] + [idOperador] + timestamp +
ClaveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 34
Nota: el campo numTelefono1 hace referencia al número de teléfono

con el que se pagará la operación (elemento
datosPagoMobipay/numTelefono), mientras que el campo numTelefono2
hace referencia al teléfono a recargar (elemento
datosRecarga/numTelefono)
Ejemplo 1:
<operacion>
<datosPago>
<datosPagoTarjeta>
<cvc2>567</cvc2>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
</datosCompra>
<firma>
DA6E39B04774053DD49C5C5739EB168B70A42FA08F4442F99DEC160CD2414A5C</firma>
</operacion>
</Operaciones>
Para este mensaje, la cadena sobre la que se aplica la firma sería:

PAGO454584030050803307070.01978123443210120050629 141506AAABBB
Ejemplo 2:
<operacion>
<datosPago>
<datosPagoTarjeta>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<codigoDivisa>840</codigoDivisa >
<factura>fact</factura>
</datosCompra>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 35
<firma>
232F1871EF3D5A1C0082CFB3ABA337EE04AE9EB77F90D4A8A2E72EF15A57EC91</firma>
</operacion>
</Operaciones>
PAGO4948750000000004070710.00978840123443210120050726
140500AAABBB
Ejemplo 3:
<operacion>
<datosPago>
<datosPagoBanda>
<lecturaBanda>D6BAC20AB322864CF8A3554700BB411F9EA1C44D20F
0B70014CFE71A13EEE8765EE29A9372C895F5F8E978F17298A1D5CD7
68EB618815D0E96EE7FF8BB9EAF412BB033BD9ABD663BF8A3554700
BB411F1266C03D10061E2DBC71B66B7E00BA291CEE96B3468130F4</l
ecturaBanda>
</datosPagoBanda>
</datosPago>
<datosCompra>
<factura>fact1</factura>
<opcionesPago>S</opcionesPago>
</datosCompra>
<firma>
016CEC323578EC6BFF3B35B5195F25F44A658A76256FD0D0D13BD42B2182F0F3</firma>
</operacion>
</Operaciones>
PAGO1.00978123443210120050726 095800AAABBB
Ejemplo 4:
<operacion>
<datosPago>
<datosPagoMobipay>
<codBarras>0123456789012</codBarras>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 36
</datosPagoMobipay>
</datosPago>
<datosCompra>
<factura>fact_CB</factura>
</datosCompra>
<firma>
6FCBC32D390BF945AF5E92F5C4D57A3C092A1A25C42CE91FB6FD5C1D034710B8</firma
>
</operacion>
</Operaciones>
PAGO01234567890127.00978123443210120050727 084702AAABBB
Ejemplo 5:
<operacion>
<datosPago>
<datosPagoMobipay>
</datosPagoMobipay>
</datosPago>
<datosCompra>
<factura>fact_TelMbp</factura>
</datosCompra>
<firma>
ACA8644C5AC1D8DB96C85F0286DFC098C8BF89A200EAE44DF564FF634858C305</firma>
</operacion>
</Operaciones>
PAGO6601899870.01978123443210120050720 154500AAABBB
Ejemplo 6: recarga
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 37
<operacion>
<datosPago>
<datosPagoTarjeta>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<datosRecarga>
<idOperador>1</idOperador>
</datosRecarga>
</datosCompra>
<firma>
F6DEEA59B66BCE4BD23A38ABA5459E5EFA1C7462ADA7888325988DDBE8B8844E</firm
a>
</operacion>
</Operaciones>
RECARGA4545840300508033070710.0097812344321016601897561200507020
191000AAABBB
Ejemplo 7: pago con aplazamiento
<operacion>
<datosPago>
<datosPagoTarjeta>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
<plazoPago>10003</plazoPago>
</datosCompra>
<firma>
F6545081632CB3FD0BDFBFD754F259C06DA5B351E2AD1B118FA96771BEC91B11</firma>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 38
</operacion>
</Operaciones>

PAGO4509460000000003090915.0097810003123443210320050925
100000AAABBB
8.1.1.1 Mensajes de Operaciones Recurrentes.
En estos mensajes se podrá informar de los datos necesarios para llevar

a cabo pagos recurrentes. Por un lado, se podrá realizar una generación
de token a partir de la tarjeta, el comercio y la caducidad. Por otro lado
se podrá realizar las operaciones con un token ya generado
previamente.
A. Primera Operación. Generación de Token.
Será el primer mensaje que se enviará con los datos de la operación

y en caso de querer generar un token para poder realizar operaciones
recurrentes se mandará lo siguiente:
Ejemplo 8: pago con generación de token.
<operacion>
<datosPago>
<datosPagoTarjeta>
<generaToken>TRUE</generaToken>
</datosPagoTarjeta>
</datosPago>
<datosCompra>
</datosCompra>
<firma>
F6545081632CB3FD0BDFBFD754F259C06DA5B351E2AD1B118FA96771BEC91B11</firma>
</operacion>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 39
PAGO4509460000000003090915.0097810003123443210320050925
100000AAABBB
Con el nuevo tag <generarToken>TRUE</generarToken>, se generará

un token para ese comercio, tarjeta y fecha de caducidad.
B. Operación Recurrente con Token.
Una vez se tenga el token asociado al comercio y tarjeta con la que

queremos realizar la operación, se podrá realizar operaciones
recurrentes sin necesidad de introducir tarjeta ni caducidad.
Ejemplo 9: pago con token recurrente.
<operacion>
<datosPago>
<datosPagoToken>
<token>b9a32b531ace3d342f094fe81abcb3c245f51b14</token>
</datosPagoToken>>
</datosPago>
<datosCompra>
</datosCompra>
<firma>
67DD16BF93C1C4A390EC3FB1F39739FE0B272A1F57EDF6ED851E6A713F3C945C</firma>
</operacion>
</Operaciones>

Cadena = tipoPago + [Token] | [codBarras] | [numTelefono1] +
importe + moneda + [codigoDivisa] + [plazoPago] + comercio +
terminal + [numTelefono2] + [idOperador] + timestamp +
ClaveComercio
PAGO0242a2770c62e49ff4139f032b71e22d088e8682
15.0097810003123443210320050925 100000AAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 40
8.1.2 Mensaje de Respuesta de Operación
Estos mensajes son el resultado del procesamiento de una transacción,

esto es, la operación se ha realizado, pudiendo haber sido Autorizada o
Denegada.
 tipoPago
 tarjetaComercioRecibo (en el caso en que la tarjeta vaya
incluida en el mensaje)
 tarjetaClienteRecibo (en el caso en que la tarjeta vaya incluida

en el mensaje)
 caducidad (en el caso en que vaya incluido en el mensaje)
 numTelefono (en caso de tratarse de una recarga)
 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 identificadorRTS
 fechaOperacion
 titularTarjeta
 estado
 resultado (en el caso en que vaya incluido en el mensaje)
 ClaveComercio
Algunos de los campos indicados son opcionales, y por tanto pueden o

no ir incluidos en el mensaje de respuesta. En el caso de que no vayan
incluidos, se ignorarán.
Cadena = tipoPago + [tarjetaComercioRecibo + tarjetaClienteRecibo +

caducidad] + [numTelefono] + importe + moneda + [importeDivisa +
codigoDivisa + tasaCambio] + comercio + terminal + pedido +
identificadorRTS + fechaOperacion + estado + [resultado] +
claveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 41
Ejemplo 1:
<estado>G</estado>
<firma>14A5B811539955E782E0E3DC06DF80FBA1AFF3C72D63D29175860E6137811D2E</fi
rma>
</Operaciones>
PAGO************8033************803307070.0197812344321011173070
0120507261306263718002005-07-26 13:06:26.22FDenegadaAAABBB
Ejemplo 2: respuesta operación EMV OK:
<tipoTasaAplicada>DEB</tipoTasaAplicada>
<factura>IDOPER_PINPAD</factura>
<estado>F</estado>
<Literales>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 42
</Literales>
<firma>01247A0934549E03C94F02E68D6448ADECDE38B0E7950B2DFCE7C2C1E4
D27E61</firma>
<operacionemv>true</operacionemv>
<conttrans>000666</conttrans>
<sectarjeta>01</sectarjeta>
<idapp>A0000000031010</idapp>
<etiquetaApp>VISA CLASSIC</etiquetaApp>
<codrespauto>00</codrespauto>
</Operaciones>
PAGO************0090************009012100.0197877788899115521070
0010701040952230038762007-01-04 09:52:23.65FAutorizadaAAABBB
Ejemplo 3 de respuesta operación EMV KO:
<estado>G</estado>
<Literales>
</Literales>
<firma>C0615764653D2AAEAECEA164D6E101D9808FF70B961096D2FFA8843BF89
BDD26</firma>
<idapp>A0000000031010</idapp>
<resverificacion>0880008000</resverificacion>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 43
PAGO************0090************009012100.0197877788899115522070
0010701040952230038762007-01-04 09:52:23.65FDenegadaAAABBB
Ejemplo 4 de respuesta EMV a PAGO con DCC:
<titularTarjeta>Apellidos Nombre Titular</titularTarjeta>
<tasaCambio>1.406925</tasaCambio>
<estado>F</estado>
<Literales>
<literal>I ACCEPT THAT I HAVE BEEN OFFERED A CHOICE OF
CURRENCIES FOR PAYMENT. I ACCEPT THE CONVERSION
RATE AND FINAL AMOUNT. I UNDERSTAND THAT THE
CHOICE OF TRANSACTION CURRENCY IS FINAL.</literal>
</Literales>
<firma>B01C66815C38131861E0831FBC8FEE555E85CEC312AC95FC37FB94A5052007
0B</firma>
</Operaciones>
PAGO************5532************5532020730.0197821.338261.4069253
09571370113720700010601231516090284462006-01-23
12:36:02.22FAutorizadaAAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 44
Ejemplo 5 de respuesta EMV a PREAUTORIZACION:
<estado>F</estado>
<Literales>
</Literales>
<firma>612DFB3D8AD2CDF5B4714290EBF824583F6EF10F54AA62A5C67083D10C
AFB03C</firma>
<idapp>A0000000031010</idapp>
</Operaciones>
PREAUTORIZACION************0090************009012107.00978777888
991155230700010701040952230038772007-01-04
Ejemplo 6: recarga
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 45
<estado>F</estado>
<firma>D315253BE52109634F1AD33A8E6203122A8BCC66D8D4BFD1014FB6569FBCF473<
/firma>
</Operaciones>
RECARGA************8033************8033070766018975610.009781234
43210111710700120507261252193717982005-07-26
Ejemplo 7: pago con aplazamiento
<tarjeta>************0003</tarjeta>
<estado>F</estado>
<Literales>
<literal>PAG.FRAC. 3 MESES-INT.COMERCIO</literal>
</Literales>
<firma>32974066D41570A6B33910F4206269AEEF17CED5E652AC17005DAF88F8A72F40</f
irma>
</Operaciones>

PAGO************0003090915.00978123443210312452005-09-29
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 46
Ejemplo 8. Pago con generación de Token
<estado>G</estado>
<firma>6A0869A7EDEE549728180A969FF80801AA5B7BB2A5B5F48849E8B8B2BF5C26FE</f
irma>
</Operaciones>

PAGO************000088e868215.00978123443210312452005-09-29
Ejemplo 9. Pago con Token Recurrente.
<tokenComercioRecibo>************1b14</tokenComercioRecibo>
< tokenComercioRecibo>************1b14</tokenComercioRecibo>
<estado>G</estado>
<firma>A85CE5AF0FFD3306F5EE67A363E59EA71DB50253B51E0FEF0070CB031A12D720</f
irma>
</Operaciones>

PAGO************8e868215.00978123443210312452005-09-29
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 47
8.1.3 Mensaje de Respuesta de Opciones de Pago
Estos mensajes son devueltos por TPV PC cuando puede ofrecer una
funcionalidad determinada para la transacción actual (DCC, Tarjeta en
claro), siempre y cuando se haya especificado el campo ‘opcionesPago’
en el mensaje de petición.
Ejemplo de respuesta cuando existe Operativa DCC:
En general, la cadena que se firmará consta de los campos siguientes:
 importeOriginal
 monedaOriginal
 importeDivisa
 codigoDivisa
 nombreDivisa
 simboloDivisa
 formatoDivisa
 porcentajeComision
 tasaDivisaConComision
 tasaDivisaSinComision
 comercio
 terminal
 csb
 ClaveComercio
 Operacionemv
 Conttrans
 Sectarjeta
 Idapp
 etiquetaApp
 codrespauto
 resverificacion
La cadena se formará de la siguiente manera:
Cadena = importeOriginal + monedaOriginal + importeDivisa +

codigoDivisa + nombreDivisa + simboloDivisa + formatoDivisa
+porcentajeComision+tasaDivisaConComision+ tasaDivisaSinComision
+ comercio + terminal + csb + clave
Ejemplo 1: respuesta Opcion Pago DCC
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 48
<resultadoConsulta>
<divisas>
<csb>4000</csb>
<nombreEntTermAct>>REDSYS </nombreEntTermAct>
</divisas>
<firma>744721AE18CAD92E392360F98C71E70B6211D75DD26F2B43A77B78DCCD0BC40C <
/firma>
</Operaciones>

1.009780.71826POUND STERLINGGBP23.0000
1.4069251.44913312344321014000AAABBB
Ejemplo de Respuesta cuando existe operativa Tarjeta en Claro:
En general, la cadena que se firmará consta de los campos siguientes:
 comercio monedaOriginal
 Pan
 timestamp
Cadena = comercio + Pan + timestamp + clave
<resultadoConsulta>
<Pan>4548819002212219</Pan>
<csb>4000</csb>
<firma>90E5DF0FBB9BBEB0E7EA2352D2BBA95803FD637BCA797D7C391C2280D8CE695
A</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 49
123443210454881900221221920080121 104613AAABBB
8.2 Mensajes de DEVOLUCION/CONFIRMACION
 tipoComunicacion (atributo del elemento

comunicacionContable)
 comercio
 terminal
 pedidoBase
 idRTSOriginal
 importe
 timestamp
 ClaveComercio
Cadena = tipoComunicacion + comercio + terminal + pedidoBase +

idRTSOriginal + importe + timestamp + claveComercio
Ejemplo:
<datosEntrada>
<firma>
9283D44A97E1FA41316DC018DE5B7CCBF1B69ABEE77DE0CC80DE53723A951D4A</firma
>
</datosEntrada>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 50
DEVOLUCION123443210111740700120507261309153718010.0120050722
084900AAABBB
8.2.2 Mensaje de Respuesta
 tipoComunicacion
 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 pedidoBase
 fechaOperacion
 estado
 ClaveComercio

Cadena = tipoComunicacion + importe + moneda + [importeDivisa +

identificadorRTS + pedidoBase + fechaOperacion + estado + [resultado]
+ claveComercio
Ejemplo:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 51
<estado>F</estado>
<firma>6CFCCC3A2B06FA4EA7F3611A15141CF9E6833DDB30CF7F53AB08CA9F63AEE59
B</firma>
</Operaciones>
DEVOLUCION0.019781234432101117607001205072613161437180311742005-
07-26 13:16:14FAutorizadaAAABBB
8.3 Mensajes de Devolucion Sin Original
 tipoComunicacion (atributo del elemento

comunicacionContable)
 comercio
 terminal
 tarjeta
 caducidad
 importe
 timestamp
 ClaveComercio
Cadena = tipoComunicacion + comercio + terminal + tarjeta +

caducidad + importe + timestamp + claveComercio;
Ejemplo:
<comunicacionContable tipo="DEVOLSINORIG">
<datosEntrada>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 52
<factura>DevSinOrig_TEST</factura>
<firma>
6CF977D5BFAE22B9A952E5D1491F5F5A040D8BAA39FDB9741CFB898A872B49E4</firma>
</datosEntrada>
</Operaciones>
DEVOLSINORIG7778889910145488120494000041212100.0020110912 090000AAABBB
8.3.2 Mensaje de Respuesta
 tipoComunicacion
 importe
 comercio
 terminal
 tarjeta
 caducidad
 pedido
 fechaOperacion
 estado
 ClaveComercio

Cadena = tipoComunicacion + importe + moneda + [importeDivisa +

codigoDivisa + tasaCambio] + comercio + terminal + tarjeta +
caducidad + pedido + identificadorRTS + fechaOperacion + estado +
[resultado] + claveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 53
Ejemplo:
<comunicacionContable tipo="DEVOLSINORIG">
<tarjeta>************0004</tarjeta>
<estado>F</estado>
<firma>06BCA312AB29F2DABAF4BBD9D8F35F9637BD6E6CB76A67C64B642E7806F873B
9</firma>
</Operaciones>
DEVOLSINORIG100.009787778889911************000400005293070001110912094553497
4342011-09-12 09:00:00.0FAutorizadaAAABBB
8.4 Mensajes de CONSULTA
8.4.1 Mensaje de Petición de consulta DCC
 importeOriginal
 monedaOriginal
 codigoDivisa
 comercio
 terminal
 csb
 timestamp
 ClaveComercio
Cadena = importeOriginal + monedaOriginal + codigoDivisa + comercio

+ terminal + csb + timestamp + claveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 54
Ejemplo:
<consulta>
<datosConsulta>
<datosDivisas>
<csb>4000</csb>
</datosDivisas>
</datosConsulta>
<firma>A7675DC054728E9F9FF6FAE917F555C1B8AC90161E055B0E1ECC3AAEA791269E
</firma>
</consulta>
</Operaciones>
Para este mensaje, la cadena sobre la que se aplica la firma

sería: 1.009788401234432101400020050722 170606AAABBB
8.4.2 Mensaje de Respuesta de consulta DCC
 importeOriginal
 monedaOriginal
 importeDivisa
 codigoDivisa
 nombreDivisa
 simboloDivisa
 formatoDivisa
 comercio
 terminal
 csb
 ClaveComercio
Cadena = importeOriginal + monedaOriginal + importeDivisa +

codigoDivisa + nombreDivisa + simboloDivisa + formatoDivisa +
comercio + terminal + csb + clave
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 55
Ejemplo:
<resultadoConsulta>
<divisas>
<csb>4000</csb>
</divisas>
<firma>D4D70AED5144C2F53C17ED5D6CE2247BE923442830CAD5A44F006EA966D59435</fir
ma>
</Operaciones>

10.009787.11826POUND
STERLINGGBP23.00001.4069251.44913312344321014000AAABBB
8.4.3 Mensaje de Petición de consulta de una operación
 comercio
 terminal
 pedidoBase
 idRTSOriginal
 tarjeta
 importe
 fechaOper
 timestamp
 ClaveComercio
Cadena = comercio + terminal + pedidoBase + [idRTSOriginal] +

[tarjeta] + [importe] + [fechaOper] + timestamp + claveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 56
Ejemplo 1:
<consulta>
<datosConsulta>
<datosOperacion>
</datosOperacion>
</datosConsulta>
<firma>2BB7AA159DFFFB751C0C1F6AC52964A28B5C07E9AEAD126E6D1AC70D6FDE
EC9D</firma>
</consulta>
</Operaciones>

1234432101119307000105080412234707078520050804
084006AAABBB
Ejemplo 2:
<consulta>
<datosConsulta>
<datosOperacion>
<fechaOper>2005-08-04</fechaOper>
</datosOperacion>
</datosConsulta>
<firma>A782BDFA5E420B7AFD60260DCFA273C39A973A499A362D10D4CF8ABFDE7C375
2</firma>
</consulta>
</Operaciones>

12344321011193454881000000000412.002005-08-0420050802
084006AAABBB
8.4.4 Mensaje de Respuesta de consulta de una operación
 tipoOperacion
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 57
 tarjetaComercioRecibo (en el caso en que la tarjeta vaya

 tarjetaClienteRecibo (en el caso en que la tarjeta vaya vaya

 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 fechaOperacion
 estado
 ClaveComercio

Cadena = tipoOperacion + [tarjetaComercioRecibo +

tarjetaClienteRecibo + caducidad] + [numTelefono] + importe +
moneda + [importeDivisa + codigoDivisa + tasaCambio] + comercio +
terminal + pedido + identificadorRTS + fechaOperacion + estado +
[resultado] + claveComercio
Ejemplo:
<resultadoConsulta>
<operacion>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 58
<tipoTasaAplicada>DEB</tipoTasaAplicada>
<estado>F</estado>
</operacion>
<firma>67EEFB0EDE19C99BD7903436950918AA0543F61B925C69B39D8F80B5F27A3F
C9</firma>
</Operaciones>
Autorizacion************0004************0004060612.009781234
43210111930700010508041223470707852005-08-04
8.5 Mensajes de ANULACIÓN de Preautorizaciones
 tipoPago
 pedidoBase
 idRTSOriginal
 comercio
 terminal
 timestamp
 ClaveComercio
Cadena = tipoPago + pedidoBase + idRTSOriginal + comercio +

terminal + timestamp + claveComercio
Ejemplo:
<operacion>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 59
<datosCompra>
</datosCompra>
<firma>
C1038899EC82465282C3B12E33B5E810D7BE17CFEEBEF3D0FF1553F4B8B3BAC8</firma>
</operacion>
</Operaciones>
ANULACION10819070001070314161701328981123443210120070315
124500AAABBB
 tipoPago
 tarjetaComercioRecibo (en el caso en que vaya incluido en el
mensaje)
 tarjetaClienteRecibo (en el caso en que vaya incluido en el
mensaje)
 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 fechaOperacion
 estado
 ClaveComercio
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 60


claveComercio
Ejemplo 1:
<tarjetaComercioRecibo></tarjetaComercioRecibo>
<tarjetaClienteRecibo></tarjetaClienteRecibo>
<estado>F</estado>
<firma>C6A9CD5072BDA493174E22F9FCFB8C1C8A6A28F6C78007B48F3F420F7CB6F11F</
firma>
</Operaciones>
ANULACION07070.479781234432101108190700010703151253430593482007-
03-15 12:53:43FAutorizadaAAABBB
8.6 Mensajes de REEMPLAZO de Preautorizaciones
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 61
 tipoPago
 importe
 moneda
 PedidoBase
 idRTSOriginal
 comercio
 terminal
 timestamp
 ClaveComercio
Cadena = tipoPago + importe + moneda + pedidoBase + idRTSOriginal

+ comercio + terminal + timestamp + ClaveComercio
Ejemplo 1:
<operacion>
<datosCompra>
<tipoPago>PREAUT_REEMPLAZO</tipoPago>
</datosCompra>
<firma>
9ABED920636127C5A64E2CDF7202ADD00D2E4FF321A625154AEE7B8F329D215D</firma>
</operacion>
</Operaciones>
PREAUT_REEMPLAZO
311.009781059507000107021512181158002123443210120070308
172500AAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 62
 tipoPago
 tarjeta (en el caso en que vaya incluido en el mensaje)
 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 fechaOperacion
 estado
 ClaveComercio

claveComercio
Ejemplo 1:
<estado>F</estado>
<firma>778E440E5259C0EB082BD112A1D0949ABB9024F29E9E7DAAE6C744361926FB7E </firm
a>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 63
</Operaciones>
PREAUTORIZACION************0003************0003311.0097812344321
01105950700010703081748381752542007-03-08 17:48:38AutorizadaAAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 64
8.7 Mensajes de repetición de PAGO CON TARJETA EN

ARCHIVO
 tipoPago
 pedidoBase
 idRTSOriginal
 comercio
 terminal
 timestamp
 ClaveComercio
Cadena = tipoPago + pedidoBase + idRTSOriginal + comercio +

terminal + timestamp + claveComercio
Ejemplo:
<operacion>
<datosCompra>
</datosCompra>
<firma>
904C8CCBCC85401DB36A17CFF32BF6B3973A830C0E6DFFA02C4F8419E81EA6B8</firma>
</operacion>
</Operaciones>
PAGO_TJT_ARCHIVO10819070001070314161701328981123443210120110524
170500AAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 65
 tipoPago
 tarjetaComercioRecibo (en el caso en que vaya incluido en el
mensaje)
 tarjetaClienteRecibo (en el caso en que vaya incluido en el
mensaje)
 importe
 moneda
 importeDivisa
 codigoDivisa
 tasaCambio
 comercio
 terminal
 pedido
 fechaOperacion
 estado
 ClaveComercio


claveComercio
Ejemplo 1:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 66
<tarjetaComercioRecibo></tarjetaComercioRecibo>
<tarjetaClienteRecibo></tarjetaClienteRecibo>
<estado>F</estado>
<firma>75DB55DC61972FA1E208C4879207BBECC832EF2EEC1D091F3A9670E45234CF26</
firma>
</Operaciones>
PAGO_TJT_ARCHIVO07070.479781234432101108190700010703151253430593
482007-03-15 12:53:43FAutorizadaAAABBB
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 67
9. Anexo II. Formato del recibo
El recibo generado por la aplicación del comercio, una vez recibidos los
datos de la transacción por parte del servicio SOAP, debe tener un
formato que incluya una serie de campos de obligada aparición. Dichos
campos son los siguientes:
 Importe de la transacción y moneda de la misma.

 Importe en divisa en caso de que la transacción se haya
realizado en moneda extranjera.
 Tasa de cambio aplicada en caso de que la transacción se
haya realizado en moneda extranjera.
 Comercio donde se ha realizado la operación.
 Terminal por el que se ha tramitado la operación.
 Numero de pedido.
 IdentificadorRTS.
 Número de teléfono recargado (en el caso de una recarga)
 ID de transacción devuelto por la operadora telefónica
(en el caso de una recarga)
 Nombre de la operadora telefónica (en el caso de una
recarga)
 Número de tarjeta en el recibo del comercio.
 Número de tarjeta en el recibo del cliente.
 Fecha de caducidad de la tarjeta.
 Fecha de la transacción (viene en la respuesta del TPV PC).
 Hora de la transacción (viene en la respuesta del TPV PC).
 Código de Autorización. En caso de que la operación haya
sido autorizada.
 Literal de operación Autorizada o Denegada, según el
resultado de la operación.
 Los literales devueltos por el TPV PC en el mensaje de
respuesta de la transacción, por orden de aparición en el
mensaje.
 Espacio reservado para la firma del titular en la copia
para el comercio (en el caso de recibos de devolución no es
necesario)
 CRED / DEB cuando el dato tipoTasaAplicacion venga en el
mensaje, se incluye el literal al lado del numero de autorización.
 puntosCaixa: Cuando se reciba la etiqueta “puntosCaixa” se
debe imprimir el contenido de dicha etiqueta inmediatamente
después de la moneda de la transacción.
La respuesta dada por el TPV_PC a la petición puede incluir dos campos,

para los cuales se deberá realizar un tratamiento especial del recibo.
Estos campos y su tratamiento se exponen a continuación:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 68
 ReciboSoloCliente: En el caso de existir y de que su valor sea

“TRUE”, sólo se deberá imprimir el recibo cliente.
 autenticadoPorPin: En el caso de existir y de que su valor sea
“TRUE”, no se deberá imprimir el recuadro de firma. Este
recuadro deberá sustituirse por el literal del mismo nombre que
la marca, o por su traducción al idioma de la aplicación cliente.
Cuando una operación se realiza con una tarjeta con chip EMV, puede
suceder que el TPV PC dé como autorizada la operación, pero deniegue
la tarjeta. En este caso, se recibiran en el xml de resultado de la
operación unos nuevos elementos cuyo valor será necesario imprimirlos
en el recibo. A continuación detallamos estos nuevos elementos (el valor
de éstos debe ser impreso tal cual se devuelve en el recibo o ticket):
 Val5F20, en el recibo el nombre debe aparecer como 5F20
 Val5F2A, en el recibo el nombre debe aparecer como 5F2A
 Val82, en el recibo el nombre debe aparecer como 82
 Val9A, en el recibo el nombre debe aparecer como 9A
 Val9C, en el recibo el nombre debe aparecer como 9C
 Val9F1A, en el recibo el nombre debe aparecer como 9F1A
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 69
<factura>DENIEGA-TARJ</factura>
<estado>F</estado>
<Literales>
<literal></literal>
</Literales>
<firma>78F0FB5CE34E43ADF883BC8077E22C5D45F7C7ED131242C8E2C3920DE97E69F0</firma>
<idapp>A0000000031010</idapp>
<codrespauto></codrespauto>
<Val5F20>46554C4C2046554E4354494F4E414C</Val5F20>
<Val5F25>101231</Val5F25>
<Val5F2A>0978</Val5F2A>
<Val82>5C00</Val82>
<Val9A>081017</Val9A>
<Val9C>00</Val9C>
<Val9F10>06011A03900000</Val9F10>
<Val9F1A>0724</Val9F1A>
<Val9F17>03</Val9F17>
<Val9F26>395E4D911AB0196D</Val9F26>
<Val9F27>00</Val9F27>
<Val9F33>E0F0C0</Val9F33>
<Val9F40>4000F0B001</Val9F40>
<Val9F34>410302</Val9F34>
<Val9F37>37AEC214</Val9F37>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 70
A continuación se muestra un ejemplo de recibos válidos:

A continuación se muestra el recibo resultante, dado el mensaje de
respuesta del TPV PC:
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 71
<estado>F</estado>
<firma>A532D9956038241AFD4650BE50430B71CDACBF27016B3E59AF961C22856243
40</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 72
A continuación se muestra el recibo resultante, dado el mensaje EMV de

<estado>F</estado>
<Literales>
</Literales>
<firma>D936616FCEC18F86A0F564F2C4E773BD1C3421E986E68A654F0D688F1081
58B3</firma>
<idapp>A0000000031010</idapp>
<resverificacion>0880008000</resverificacion >
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 73

respuesta del TPV PC (DCC):
<pocentajeComision>1.2500</pocentajeComision>
<estado>F</estado>
<Literales>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 74

<datosDCC>
<linLitTrans>TRANSACTION CURRENCY</linLitTrans>
<linLitDivisa>GBP</linLitDivisa>
<linMarca>WHOLESALE RATE PROVIDED BY VISA</linMarca>
<linMarkUp>MARK-UP: 1.2500 %</linMarkUp>
<linLitComision>NO COMMISSION</linLitComision>
<linLitEntidad>SERVICE AND#N#EXCHANGE RATE PROVIDED
BY#N#REDSYS</linLitEntidad>
<linCambio>GBP 1.00 = 1.406925 EUR</linCambio>
<linLitInf>Questions, if any, please#N#call (+34) 91 343 32 18</linLitInf>
</datosDCC>
</Literales>
<firma>C536924ED534853E33D94FEB0918CB3BE69D613A506932B39814C00AE4625F
15</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 75
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 76

respuesta del TPV PC (DCC con EMV):
<pocentajeComision>1.2500</pocentajeComision>
<estado>F</estado>
<idapp>A0000000031010</idapp>
<Literales>
<datosDCC>
<linLitTrans>TRANSACTION CURRENCY</linLitTrans>
<linLitDivisa>GBP</linLitDivisa>
<linMarca>WHOLESALE RATE PROVIDED BY VISA</linMarca>
<linMarkUp>MARK-UP: 1.2500 %</linMarkUp>
<linLitComision>NO COMMISSION</linLitComision>
<linLitEntidad>SERVICE AND#N#EXCHANGE RATE PROVIDED
BY#N#REDSYS</linLitEntidad>
<linCambio>GBP 1.00 = 1.406925 EUR</linCambio>
<linLitInf>Questions, if any, please#N#call (+34) 91 343 32 18</linLitInf>
</datosDCC>
</Literales>
<firma>E28C655DEECEE2B93EDA4D8D0979BE528CA273AC7D0A418848A2B6C47C16D40
7</firma>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 77
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 78

<estado>F</estado>
<Literales>
</Literales>
<firma>747ED43BD4334E9164BA836877B01D73A9C7E6D54E6EF24F7D8E0F783A4
626B7</firma>
<idapp>A0000000031010</idapp>
<ReciboSoloCliente>TRUE</ReciboSoloCliente>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 79

<estado>F</estado>
<Literales>
<autenticadoPorPin>OPERACION CON PIN. FIRMA NO
NECESARIA.</autenticadoPorPin>
</Literales>
<firma>5A5A259BB7658859B84B45849E093FAE4E71FF37280C27BAA1BCEDF9BA
E3D5E0</firma>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 80
<idapp>A0000000031010</idapp>
<autenticadoPorPin>TRUE</autenticadoPorPin>
</Operaciones>
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 81
10. Anexo III. Códigos de Denegación
Cuando una petición de autorización da como resultado una operación

denegada, en el campo codigoRespuesta se devuelve el código de
denegación asociado a dicha respuesta. Este código indica el motivo por
el cual se ha denegado la operación.
Los códigos más comunes se detallan a continuación:
- 101 -
La tarjeta está caducada
- 102 -
Tarjeta bloqueada por el banco emisor
- 104 -
Operación no permitida para esa tarjeta o terminal
- 106 -
Intentos de PIN excedidos
- 107 y 167 -
Por favor, contacte con el banco emisor de la tarjeta
- 109 -
Identificación inválida de terminal o establecimiento
- 110 -
Importe inválido
- 112 -
Se requiere PIN obligatorio
- 114 -
Tarjeta no soporta el tipo de operación solicitado
- 116 -
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 82
Disponible insuficiente
- 117 -
PIN incorrecto
- 118 -
Tarjeta no registrada
- 119 -
Desconocido
- 120 -
Operaciones denegadas por SIS
- 121 -
Excede límite de importe en anticipos de efectivo
- 122 -
Denegación por controles sobre el VCA
- 123 -
CAUV erróneo
- 124 -
Titular necesita cambio de PIN previo a operar
- 125 -
Tarjeta no efectiva
- 126 -
Bloque de PIN inválido
- 129 -
Tarjeta no operativa (error en CVC2)
- 130 -
Moneda no soportada por el emisor
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 83
- 160 -
El terminal indica que la operación de consumo CEPS no ha finalizado
correctamente
- 161 -
Marca no admitida por el emisor
- 180 -
Tarjeta no soportada por el sistema
- 181 -
Tarjeta con restricciones débito
- 182 -
Tarjeta con restricciones crédito
- 183 -
Tarjeta con restricciones débito (cuenta de crédito)
- 184 -
Error en autenticación
- 185 -
Control dispositivos no adaptados EMV
- 187 -
Error en criptografía EMV
- 190 -
Denegada por el banco emisor de la tarjeta, por diversos motivos
- 191 -
Fecha de caducidad errónea
- 192 -
Datos de case no encontrados
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 84
- 193 -
Importe excesivo
- 194 -
Rechazo por el operador telefónico
- 195 -
Control Fallback
- 198 -
Denegación DCC para envío de contravalores
- 201 -
Tarjeta caducada. Orden de retirar la tarjeta
- 202 -
Consulte con su entidad. Retenga tarjeta cliente. NOTA: Es
OBLIGATORIO imprimir este literal en el recibo.
- 204 -
Operación no permitida para esa tarjeta o terminal
- 206 -
Intentos de PIN excedidos. Retener tarjeta
- 207 -
Tarjeta en condiciones especiales. Retener tarjeta
- 208 -
Tarjeta bloqueada por el banco emisor. Orden de retirar la tarjeta
- 209 -
Llame al 902102100. NOTA: Es OBLIGATORIO imprimir este literal en
el recibo.
- 210 -
Retención por controles sobre el VCA
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 85
- 280 -
CVV1/CVC1 o CVV2/CVC2 erróneo. Retener la tarjeta
- 290 -
Denegada por diversos motivos. Orden de retirar la tarjeta
- 9112 -
Número de tarjeta inexistente
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 86
11. Anexo IV. Códigos de Actividad
A nivel nacional, cada comercio tiene asignado un código que indica la

actividad a la que se dedica. Estos códigos se llaman Códigos de
Actividad, y cada uno de ellos determina la operativa disponible para
cada comercio, concretamente si tiene la posibilidad de realizar Entrada
Manual de datos (Reentry), y si es necesario pedir el dato CVC2 en sus
transacciones.
A la hora de implementar la operativa Web Service para TPV PC se

deberá tener en cuenta el código de actividad del comercio donde se
implantará, de manera que se permita o no la entrada manual de datos,
así como determinar si se debe pedir el CVC2.
A continuación se detalla la operativa que lleva asociada cada código de

actividad. En primer lugar, se detallan aquellos códigos de actividad que
permiten Entrada Manual de datos:
1426, 1427, 1428, 1429, 1430, 1432, 1437, 1445, 1446, 1448, 1449,
1453, 1454, 1456, 1458, 1461, 1476, 1477, 1478, 1481, 1482, 1483,
1485, 1490, 1491, 1492, 1494, 1495, 1856, 1877, 1878, 1893, 1894,
1898, 1899, 1900, 1901, 1907, 1908, 1909, 1912, 1913, 1914, 1915,
1916, 1918, 1919, 1920, 1921, 1922, 1923, 1924, 1958, 1999, 3102,
3357, 3381, 3389, 3548, 4012, 4013, 4131, 4214, 4511, 4722, 5331,
5333, 5338, 5350, 5542, 5732, 5912, 5959, 5961, 5964, 5967, 5992,
5994, 6310, 7011, 7013, 7014, 7512, 7941, 8062, 8220, 8244, 8398
A continuación se muestran los códigos de actividad que requieren

petición de CVC2 en sus transacciones:
1426, 1427, 1428, 1429, 1430, 1795, 1796, 1840, 1841, 1842, 1843,
1844, 1845, 1846, 1847, 1856, 1918, 1919, 1920, 1921, 1922, 1923,
1924, 1999, 4813, 4814, 4815, 4816, 5960, 5961, 5962, 5963, 5964,
5965, 5966, 5967, 5968, 5969
Ejemplos:
Comercio 1
Cod. Actividad 1999
Entrada Manual: Sí
Petición CVC2: Sí
Comercio 2
Cod. Actividad 8062
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 87
Entrada Manual: Sí
Petición CVC2: No
Comercio 3
Cod. Actividad 1847
Entrada Manual: No
Petición CVC2: Sí
Comercio 4
Cod. Actividad 2000
Entrada Manual: No
Petición CVC2: No
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 88
12. Anexo V. Códigos de Error TPV PC
A continuación se detallan los códigos de error más comunes que puede

devolver el TPV PC:
SOAP-TPVPC0000 Se ha producido un error al validar el mensaje.
SOAP-TPVPC0001 Error genérico.

SOAP-TPVPC0002 Firma incorrecta.
SOAP-TPVPC0003 La versión del mensaje no está soportada.
El mensaje no contiene los elementos
SOAP-TPVPC0004
requeridos.
Algunos elementos no contienen los valores
SOAP-TPVPC0005
esperados.
SOAP-TPVPC0006 El mensaje está caducado.
SOAP-TPVPC0007 Se ha producido un error desconocido.
La versión del mensaje no soporta la operativa
SOAP-TPVPC0008
especificada.
El mensaje de petición de consulta no puede
SOAP-TPVPC0009 incluir banda y número de tarjeta en el mismo
mensaje.
El método al que se envía la peticion no es el
SOAP-TPVPC0010 adecuado.
No existe una operacion con esos datos.

SOAP-TPVPC0014
Clave no localizada
SOAP-TPVPC0015
El importe de la devolución supera el importe de
TPV-PC0009
la operación original.
Se ha producido un error en el sistema.
TPV-PC0014 Inténtelo más tarde, o póngase en contacto con
el Administrador.
Faltan datos para llevar a cabo la operación
TPV-PC0015
solicitada.
El comercio no posee ningún terminal TPV PC
TPV-PC0016
válido.
La tarjeta no se ha leído correctamente.
TPV-PC0018 Asegúrese de que la asociación lector/terminal
es la correcta, e inténtelo de nuevo.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 89

TPV-PC0019 Asegúrese de que la asociación lector/terminal
es la correcta, e inténtelo de nuevo.
Se ha producido un error al realizar la operación.
TPV-PC0020
Inténtelo de nuevo.
No se han recibido todos los datos necesarios
TPV-PC0021
para modificar su contraseña.
La contraseña especificada no puede ser
TPV-PC0024 utilizada por motivos de seguridad. Por favor,
indique otra.
El formato del número de tarjeta introducido no
TPV-PC0025
es válido.
TPV-PC0026 Asegúrese de que la tarjeta está en buen
estado, e inténtelo de nuevo.
El formato de la fecha de caducidad introducida
TPV-PC0027
no es válido.
El sistema está ocupado. Reinténtelo de nuevo
TPV-PC0030 en unos instantes. Si el problema persiste,
póngase en contacto con su administrador.
TPV-PC0031
El sistema no puede acceder a las operaciones
TPV-PC0032
requeridas en este momento.
TPV-PC0033 Faltan datos para realizar la autenticación.
El usuario con el que intenta acceder ha sido
TPV-PC0034 bloqueado. Póngase en contacto con su
administrador para desbloquearlo.
El usuario con el que intenta acceder está dado
TPV-PC0035 de baja. Póngase en contacto con su
administrador.
Faltan datos para llevar a cabo la operación
TPV-PC0036
solicitada.
El sistema no puede acceder al usuario
TPV-PC0037
especificado en este momento.
El perfil del usuario especificado sólo tiene
TPV-PC0039 acceso al Módulo de Administración TPV PC. Por
favor, indique otro usuario.
El sistema no ha podido completar la operación
TPV-PC0040
especificada. Por favor, inténtelo de nuevo.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 90
El sistema no soporta actualmente el método de

TPV-PC0042 autenticación especificado. Por favor,
modifíquelo en intente de nuevo la operación.
Está intentando realizar una operación de alta
TPV-PC0043
sobre un usuario ya existente.
El formato del número de teléfono introducido
TPV-PC0044
no es válido.
El medio de pago especificado no es válido, o no
TPV-PC0048 es soportado por el comercio. Por favor, póngase
en contacto con su administrador.
No se han definido criterios suficientes para
TPV-PC0051
realizar la operación solicitada.
La contraseña no es correcta, inténtelo de
TPV-PC0052
nuevo.
TPV-PC0053 El usuario especificado no existe.
El comercio no tiene habilitada la operativa de
TPV-PC0055
Entrada Manual de datos.
El usuario ha sido creado satisfactoriamente,
pero se ha producido un error al término de la
TPV-PC0056 operación. Si este problema persiste en el
futuro, póngase en contacto con su
administrador.
TPV-PC0057 El código de entidad especificado no existe.
La moneda especificada no coincide con la
TPV-PC0058
moneda del terminal.
El sistema no puede acceder al terminal
TPV-PC0059 especificado. Asegúrese de que el terminal
existe, e intente de nuevo la operación.
No existe ningún terminal apropiado para tratar
TPV-PC0060
la marca de tarjeta introducida.
TPV-PC0061
El usuario ha sido modificado satisfactoriamente,
pero se ha producido un error al término de la
TPV-PC0062 operación. Si este problema persiste en el
futuro, póngase en contacto con su
administrador.
TPV-PC0063
TPV-PC0064 El usuario ha sido dado de baja

satisfactoriamente, pero se ha producido un
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 91
error al término de la operación. Si este

problema persiste en el futuro, póngase en
contacto con su administrador.
TPV-PC0065 El usuario especificado ya está dado de baja.
No se han encontrado usuarios que cumplan los
TPV-PC0066
criterios de búsqueda definidos.
TPV-PC0071
Preautorizaciones.
La operación no puede completarse debido a que
TPV-PC0072 no se ha recibido el dato de autenticación de la
tarjeta: CVC2.
El CVC2 introducido no coincide con el
especificado en la tarjeta. Asegúrese de que ha
TPV-PC0074
introducido correctamente los dígitos que figuran
en el reverso de la tarjeta.
El perfil del usuario especificado no tiene acceso
TPV-PC0075
al TPV PC.
Acceso denegado al sistema. El mensaje de
TPV-PC0077 acceso no es válido. Comprueba el formato del
mensaje, la firma y la fecha del mismo.
Está intentando realizar una operación sobre la
TPV-PC0078 que no tiene permisos asignados. Por favor,
póngase en contacto con su Administrador.
El comercio / terminal que ha especificado no
existe. Asegúrese de que ha introducido
TPV-PC0079
correctamente los datos y póngase en contacto
con su Administrador.
Contraseña incorrecta. Para realizar la operación
TPV-PC0081 requerida es necesario que especifique su
contraseña actual.
La configuración de su lector no es la correcta.
TPV-PC0083 Por favor, reintente la operación y consulte con
su Administrador.
Compruebe el estado de la tarjeta y que el lector
TPV-PC0084
sea el correcto, o póngase en contacto con su
Administrador
TPV-PC0085 Asegúrese de que la tarjeta está en buen
estado, e inténtelo de nuevo.
TPV-PC0087 El sistema está ocupado. Reinténtelo de nuevo

en unos instantes. Si el problema persiste,
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 92
póngase en contacto con su administrador.

TPV-PC0089
El terminal no tiene asociado ningún lector
TPV-PC0090 válido. Por favor, configure el terminal o
póngase en contacto con el Administrador.
Se ha producido un error. La operación
TPV-PC0091
especificada no existe.
TPV-PC0092
TPV-PC0093
No es posible realizar más confirmaciones sobre
TPV-PC0094
la preautorización original.
Se ha producido un error en el sistema. El
TPV-PC0096
formato de los datos pasados no es correcto.
Su contraseña no puede modificarse. Ya ha
TPV-PC0097 realizado las modificaciones permitidas para
hoy.
El comercio no está habilitado para operar con la
TPV-PC0099
tarjeta de fidelización indicada.
No puede realizar una
TPV-PC0100 DEVOLUCIÓN/CONFIRMACIÓN sobre la
operación especificada.
TPV-PC0101 La firma no es correcta.
El certificado no es válido o no está firmado por
TPV-PC0102
una CA en la que se confíe.
El certificado que está intentando asociar ya está
TPV-PC0103
asociado a otro usuario.
La tarjeta no está asociada a ningún usuario
TPV-PC0104
válido en TPV_PC.
El comercio no tiene configurada la moneda
TPV-PC0107
especificada.
Se ha producido un error al realizar la
TPV-PC0108
conversión de divisas.
La tarjeta no admite el pago en la divisa
TPV-PC0109
especificada.
TPV-PC0110 El número de plazos indicado no es válido.
TPV-PC0112 El importe de una recarga para la operadora
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 93
especificada debe ser múltiplo de 5.00 Euros.

El importe de una recarga para la operadora
TPV-PC0113
especificada debe ser múltiplo de 10.00 Euros.
TPV-PC0114
Entrada Manual de datos.
La tarjeta utilizada no admite aplazamiento de
TPV-PC0115
pagos.
El sistema ya está procesando una operación
TPV-PC0117 con los mismos datos. Si desea realizar una
nueva operación, reinténtelo en unos instantes.
El sistema ha detectado que existe una
operación anterior con los mismos datos, con
TPV-PC0118
resultado AUTORIZADA. Si desea duplicar la
operación, reinténtelo en unos instantes.
TPV-PC0119
resultado de ERROR. Si desea repetir de nuevo
la operación, reinténtelo en unos instantes.
TPV-PC0120 resultado RECHAZADA. Si desea repetir de
nuevo la operación, reinténtelo en unos
instantes.
No se puede realizar la acción requerida sobre la
TPV-PC0121
operación.
No se ha podido llevar a cabo la operación
TPV-PC0122
solicitada debido a un error en el importe.
No se puede realizar la acción requerida sobre
TPV-PC0123
una operación que resultó errónea o denegada.
No se puede realizar la acción requerida debido
TPV-PC0124
a un error.
TPV-PC0126 La tarjeta utilizada no es válida.
No existe ninguna lista negra para el comercio
TPV-PC0127
especificado.
No se puede actualizar la información de la
TPV-PC0128
descarga para el comercio.
No se puede asignar la operativa de Lista Negra
TPV-PC0129 al comercio. No existe ninguna lista negra
definida para ese comercio.
TPV-PC0131 El comercio no tiene activada esta operativa.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 94
TPV-PC0148 No es posible realizar el aplazamiento del pago.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 95
13. Anexo VI. Problemas más comunes
A continuación se detallarán los problemas más comunes que puede

encontrarse a la hora de realizar la conexión con el TPV PC Web Service,
por medio de su cliente SOAP:
El cliente no puede conectarse con el servidor de REDSYS, debido

a que no se confía en el certificado SSL de servidor (Producción).
El problema se debe a que el equipo local no confía en la Autoridad

de Certificación que ha firmado el certificado utilizado por el servidor de
REDSYS para la conexión HTTPS. Para ello, es necesario que instale el
certificado Root en su equipo. Para realizar este proceso debe hacer lo
siguiente:
 Acceda a la URL del TPV PC:

https://tpvpc.redsys.es/TPV_PC/entrada
 Una vez conectado, vaya al menú Archivo/Propiedades y pulse el

botón Certificados. Le aparecerá una ventana con la información
del certificado. Pulse el botón Instalar Certificado... y siga los
pasos que le indique el asistente.
TPV PC no responde a una petición realizada

Este problema puede tener dos posibles causas:
 No se ha recibido la petición SOAP, con lo que TPV PC no

responderá al mensaje de petición.
 TPV PC ha recibido el mensaje de petición, pero no puede

contactar con el Centro Autorizador. Esta conexión tiene definida
un timeout de 30 segundos, por lo que si transcurrido ese tiempo
no se recibe respuesta del Centro Autorizador, se devolverá un
mensaje de “Operación no Realizada”. La aplicación cliente
deberá por tanto establecer un timeout mayor (unos 40 o 50
segundos), para asegurar que TPV PC siempre le va a responder.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 96
14. Anexo VII: Ejemplo de un cliente en JAVA
A continuación se muestra un ejemplo de cliente SOAP para el acceso al

Web Service TPV PC:
Todos los datos para generar el acceso al Web Service, están definidos
en la wsdl del servicio (apartado 5).
El cliente SOAP deberá realizar los siguientes pasos:
- Indicar la URL del servicio SOAP al que se quiere acceder

Ej. URL url = new URL("URLRpcRouter");
- Crear un objeto del tipo SOAPMappingRegistry.

Ej. SOAPMappingRegistry smr = new SOAPMappingRegistry();
- Crear un objeto del tipo Call con los siguientes datos:

SOAPMappingRegistry (anteriormente creado)
TargetObjectURI. Urn del servicio de mensajeria.
MethodName. Método al que se quiere acceder.
EncodingStyleURI. Constante.
- Vector con los parámetros de la consulta

Ej.
Call call = new Call();

call.setSOAPMappingRegistry(smr);
call.setTargetObjectURI("urn:NombreURN");
call.setMethodName("NombreMetodo");
call.setEncodingStyleURI(Constants.NS_URI_SOAP_ENC);
Vector params = new Vector();
params.addElement(new Parameter("Mensaje", String.class, xml_doc, null));
call.setParams(params);
- Realizar invoke con la url del servicio SOAP que retornara un objeto Response
Ej.
Response resp=null;
resp = call.invoke(url, "");
Parameter ret = resp.getReturnValue();
Object value = ret.getValue();
EJ. CLIENTE SOAP JAVA (SERVLET)

import java.util.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.net. *;
import org.apache.soap.*;
import org.apache.soap.messaging.*;
import org.apache.soap.transport.*;
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 97
import org.apache.soap.util.xml.*;
import org.apache.soap.encoding.*;
import org.apache.soap.encoding.soapenc.*;
import org.apache.soap.rpc.*;
public class SerSvlClienteTJTSAS extends HttpServlet

{
public void doPost(HttpServletRequest req, HttpServletResponse res)
throws ServletException, IOException
{
String respuesta = "";
try
{
String xml_doc = req.getParameter("elXMLEnvio");
respuesta = ejecutaCallRPCStyle(xml_doc);
}
catch(Exception e)
{
e.printStackTrace();
}
}
public String ejecutaCallRPCStyle(String xml_doc)

throws ServletException, IOException
{
String respuesta = "";
String encodingStyleURI = Constants.NS_URI_SOAP_ENC;
URL url = new URL("URLRpcRouter");
SOAPMappingRegistry smr = new SOAPMappingRegistry();
Call call = new Call();
call.setSOAPMappingRegistry(smr);
call.setTargetObjectURI("urn:URN");
call.setMethodName("NombreMetodo");
call.setEncodingStyleURI(encodingStyleURI);
Vector params = new Vector();
params.addElement(new Parameter("Mensaje", String.class, xml_doc, null));
call.setParams(params);
Response resp=null;
try
{
resp = call.invoke(url, "");
}
catch (SOAPException e)
{
e.printStackTrace();
}
if (!resp.generatedFault())
{
Parameter ret = resp.getReturnValue();
Object value = ret.getValue();
respuesta = (String) value;
}
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 98
else
{
Fault fault = resp.getFault();
respuesta = fault.getFaultString();
}
return (respuesta);
}
}
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 99
15. Anexo VIII: Esquema del Servicio Web
A continuación, se muestran los XML-SCHEMA que deben cumplir los

mensajes xml que se envian al Web Service TPV PC:
DESARROLLO:
https://sis-d.redsys.es/TPV_PC/wsdl/PAGOSoap_v6d0.xsd
https://sis-d.redsys.es/TPV_PC/wsdl/CONSULTASoap_v2d4.xsd
INTEGRACIÓN:
https://tpvpc-i.redsys.es:27443/TPV_PC/wsdl/PAGOSoap_v6d0.xsd
https://tpvpc-i.redsys.es:27443/TPV_PC/wsdl/CONSULTASoap_v2d4.xsd
EXPLOTACIÓN:
https://tpvpc.redsys.es/TPV_PC/wsdl/PAGOSoap_v6d0.xsd
https://tpvpc.redsys.es/TPV_PC/wsdl/CONSULTASoap_v2d4.xsd
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 100

16. Anexo IX. Flujo de Llamadas para operativa DCC
A continuación se detalla el flujo de llamadas a los métodos del ActiveX

que se pueden realizar en una operativa DCC.
1. Llamada al método TrataPeticionOperacion (con bstOpcionesPago

= “S”).
1.1. Respuesta con información de tasa de Cambio y código de
moneda en la que se puede realizar la transacción.
a. El comercio procesa la transacción normal, llamada al método
TrataPeticioOperacion (con bstOpcionesPago = “N”)
b. El comercio procesa la transacción utilizando la
opción DCC, llamada al método
TrataPeticionOperacionDCC. En este caso y
dado que se va a procesar un pago DCC es
necesario mostrar al cliente una pantalla donde se
muestran las monedas que se pueden seleccionar
para realizar el pago. En caso de no poder mostrar
por pantalla será necesario imprimir un recibo para
el cliente en el cual se muestren las monedas para
la selección de una de ellas. Dicho recibo tendrá el
formato de la imagen adjunta.
2. El comercio analiza el Documento XML con el

resultado de la transacción devuelto por la llamada
al método TrataPeticionOperacion o
TrataPeticionOperacionDCC.
Ref SM.DE.DNC.MAN.0010 03/08/2015
Versión: 2.16 101

Conexion A Través de Webservices PDF

Încărcat de

Informații document

Descriere originală:

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Conexion A Través de Webservices PDF

Încărcat de

Drepturi de autor:

Formate disponibile

CONEXIÓN CON TPV PC A TRAVÉS DE WEB SERVICE

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

Autorizaciones y control de versión

Versión Fecha Afecta Breve descripción del cambio

Nueva versión que recoge las versiones

Actualización de los ejemplos de xml

Mensajes de Resultado devuelto G cuando la operación

Se agregan nuevos campos en resultado

Retira CRED/DEB de los recibos con DCC

Se actualizan los recibos de la operativa

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

Se agregan nuevos campos resultado de

Se agrega nueva operativa para devolver

Se añade el campo puntosCaixa para

Se agregan nuevos campos en resultado

Literales para Se agrega la información a incluir en las

Anexo III: Códigos

Mensajes de Nueva operativa de pagos con tarjeta en

Se actualizan los textos y las direcciones

4- Descripción de Actualización de la lista de operadores

Actualización Devolución sin Original

2.16 03/08/15 Documentación WSDL actualizadas

2.17 25/04/2016 Firma Actualización Firma SHA-256

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

Versión: 2.16 iii

2. Cliente de acceso al servicio SOAP............................................................. 2

3. Seguridad de la información ..................................................................... 3

4. Descripción de los datos ........................................................................... 4

5. Funcionalidad del Web Service TPV PC ....................................................... 9

6. Integración con TPV PC ...........................................................................27

7. Control de Duplicidad de operaciones .......................................................31

8. Anexo I. Generación de firmas .................................................................33

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

8.1.3 Mensaje de Respuesta de Opciones de Pago ....................................48

8.3 Mensajes de Devolucion Sin Original ....................................................52

9. Anexo II. Formato del recibo ...................................................................68

10. Anexo III. Códigos de Denegación ............................................................82

11. Anexo IV. Códigos de Actividad ................................................................87

12. Anexo V. Códigos de Error TPV PC ............................................................89

13. Anexo VI. Problemas más comunes ..........................................................96

14. Anexo VII: Ejemplo de un cliente en JAVA .................................................97

15. Anexo VIII: Esquema del Servicio Web ................................................... 100

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

El presente documento describe los pasos a seguir para poder

El fin de dicho acceso es permitir la realización de transacciones tanto

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

2. Cliente de acceso al servicio SOAP

El Servicio de Acceso al Web Service del TPV PC esta implementado con

Este servicio permite que de manera simple y fiable se pueda realizar

Es necesario implementar un cliente SOAP que hará la llamada al

El cliente SOAP tiene que enviar un XML al Servicio de Acceso al Servicio

Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA

Ref SM.DE.DNC.MAN.0010 03/08/2015

Con el fin de que la información intercambiada entre los componentes