Sunteți pe pagina 1din 37

Integración Tpvpc Implantado WEB

Versión: 1.2

06/03/2015

Referencia RS.TE.AEA.MAN.0005

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 i
Integración Tpvpc Implantado WEB

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

AUTOR: Redsys VALIDADO POR: APROBADO POR:

EMPRESA: Redsys EMPRESA: Redsys EMPRESA: Redsys

Firma: Firma: Firma:

Fecha: 02/03/2012 Fecha: 02/03/2012 Fecha: 02/03/2012

Comentarios: La gestión de la documentación impresa es responsabilidad de la persona que la imprime.


Las versiones impresas de los documentos no garantizan ser la última versión aprobada. Para consultar
la última versión acceder a la base de datos de Alejandría.

Versión Fecha Afecta Breve descripción del cambio

1.1 17/09/14 Documentación Actualizadas URLs del servicio

1.2 06/03/15 Documentación Anexo operativa recurrente

1.3 25/04/16 Firma Actualización Firma SHA-256

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 ii
Integración Tpvpc Implantado WEB

ÍNDICE DE CONTENIDO

1. Introducción ........................................................................................ 1
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros

2. Destinatarios ........................................................................................ 2

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

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

5. Descripción de los datos de respuesta. ................................................ 5

6. Integración con Implantado Web Tpvpc ............................................... 7


6.1 Solicitar operación de Pago .................................................................. 7
6.2 ¿Cómo validar si la operación resultó AUTORIZADA? ..............................10

7. ANEXO I. Ejemplo de formulario de petición. ..................................... 11

8. ANEXO II. Ejemplo de respuesta recibida. ......................................... 13

9. ANEXO III. Ejemplo pago recurrente ................................................. 15


9.1 Petición de pago con generación de token recurrente .............................15
9.2 Petición de pago mediante token recurrente .........................................17

10. ANEXO IV. Generación de firmas ........................................................ 18


Mensaje de Petición .................................................................................19
Mensaje de Respuesta de Operación ..........................................................20

11. ANEXO V. Esquema del Servicio Web. ................................................ 22

12. ANEXO VI. Códigos Error TPV-PC. ...................................................... 23

13. ANEXO VII. Códigos de Denegación. .................................................. 30

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 iii


Integración Tpvpc Implantado WEB
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 iv
Integración Tpvpc Implantado WEB

1. Introducción

Este documento describe la integración entre el comercio y la aplicación


TPV-PC Implantado Web para procesar una petición de PAGO mediante captura
manual de datos de tarjeta en una pantalla de TPV-PC.

Esta funcionalidad permite integrar la WEB del comercio con el pago en TPV-
PC sin necesidad de que el comercio tenga que capturar y/o almacenar el número
de tarjeta en su sistema.

Para facilitar la integración a comercios que tengan implementada la


conexión WS con TPV-PC o utilicen la librería de TPV-PC Implantado, los mensajes
de respuesta tendrán el mismo formato que la versión 6.0 de WS TPV-PC.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 1
Integración Tpvpc Implantado WEB

2. Destinatarios

Este documento está destinado a:

 COMERCIOS.
 ENTIDADES.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 2
Integración Tpvpc Implantado WEB

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 III se detallan dichos campos para cada tipo de
mensaje.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 3
Integración Tpvpc Implantado WEB

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

A continuación se detalla cada uno de los campos definidos en el mensaje de


petición de pago para este servicio.

Remítase al Anexo IV donde se especifica el 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.

 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 de
esta cadena, siendo responsabilidad del comercio.

 tipoPago: tipo de operación que desea realizarse. Para esta operativa


únicamente se permite el valor “PAGO” -> autorización normal.
 urlRespuesta: url utilizada para redirigir la respuesta al comercio.
Importante, en el caso de que el control de la sesión se realice
mediante parámetros en la url, el contenido de este campo debe ser la
url completa.
 urlNotificacion: url utilizada para enviar una notificación on-line al
comercio con el resultado de la operación. Esta notificación se realiza
mediante http-POST utilizando conexión host to host.
 correoNotificacion: dirección de correo utilizada para enviar una
notificación on-line al comercio con el resultado de la operación en
caso de que falle la Notificación vía http-POST.
 firma: contiene la firma del mensaje en formato Hexadecimal (64
caracteres)

 timestamp: fecha y hora en la que se monta el mensaje de petición,


en formato yyyyMMdd HHmmss. Este dato permitirá conocer si un
mensaje está caducado, con el fin de impedir que una persona no
autorizada reutilice el mensaje para realizar operaciones.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 4
Integración Tpvpc Implantado WEB

5. Descripción de los datos de respuesta.

Para facilitar la integración a comercios que tengan implementada la


conexión WS con TPV-PC o utilicen la librería de TPV-PC Implantado, los
mensajes de respuesta tendrán el mismo formato que los mensajes de
respuesta de TPV-PC Implantado. Ambos se basan en la versión 6.0 de WS
TPV-PC.
No obstante, indicamos a continuación los datos incluidos en el mensaje de
respuesta para una petición de PAGO:

 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.

 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.
 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 de esta
cadena, siendo responsabilidad del comercio. El tamaño máximo de esta
cadena puede ser de 20 caracteres.

 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 realizada. Valor: PAGO -> autorización


normal.
 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 (ver Anexo VII).

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 5
Integración Tpvpc Implantado WEB

 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

 tarjetaComercioRecibo: número de la tarjeta que se imprimirá en el


recibo del comercio. Esta se imprimirá en la boleta asteriscada.
 tarjetaClienteRecibo: número de la tarjeta que se imprimirá en el
recibo del cliente. Esta se imprimirá en la boleta asteriscada.
 caducidad: caducidad de la tarjeta en formato AAMM. Este campo
solamente podrá ser informado si el comercio que realiza la transacción
tiene permiso para realizar entrada manual de datos. Consulte con su
Entidad si su comercio dispone de esta posibilidad.
 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 terminales
nacionales. Sus valores son Crédito -> CRED, Débito -> DEB.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 6
Integración Tpvpc Implantado WEB

6. Integración con Implantado Web Tpvpc

6.1 Solicitar operación de Pago

Para solicitar una operación de pago será necesario componer un mensaje de


petición y enviarlo vía http-POST en un campo con nombre peticionXML a la
siguiente url:

DESARROLLO:
https://sis-d.redsys.es/TPV_PC/entradaImplantadoWeb

El contenido del campo deberá ir en formato Hexadecimal. Se incluye un ejemplo


de formulario utilizado para realizar la petición en el Anexo I.

A partir de este momento, el control de la ventana del navegador pasará al TPV-PC,


donde se solicitarán los datos necesarios para realizar el pago y se realizará la
operación.

Una vez finalizada la operación, la aplicación TPV-PC enviará el resultado de la


operación mediante http-POST a la url recibida en el campo “urlRespuesta”, junto
con el control de la ventana del navegador. El resultado de la operación viajará
como contenido del campo con nombre “respuestaXML”.
El contenido del campo deberá ir en formato Hexadecimal.

Existe la posibilidad de enviar una notificación on-line host to host desde el Servidor
TPV-PC a la url indicada por el comercio. Para ello, se debe informar en el campo
urlNotificacion del mensaje de petición la url que se utilizará para enviar estas
notificaciones. En esta notificación se enviará el mensaje XML de respuesta
generado por TPV-PC.

En el caso de que se produzca un error en esta notificación (Resultado http distinto


del código de respuesta “HTTP/1.1 200 OK”) existe la posibilidad de enviar el
mensaje XML de respuesta a una dirección de correo electrónico. Para ello, se
deberá informar esta dirección en el campo correoNotificacion del mensaje de
petición.

A continuación incluimos unos gráficos con el flujo de información/navegador:

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 7
Integración Tpvpc Implantado WEB

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 8
Integración Tpvpc Implantado WEB

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 9
Integración Tpvpc Implantado WEB

6.2 ¿Cómo validar si la operación resultó


AUTORIZADA?

En la cadena con el resultado de operación, siempre deben aparecer los


siguientes elementos con el valor que se indica a continuación:

<estado>F</estado>
<resultado>Autorizada</resultado>

Si la respuesta no contiene estos valores, debe tomarse como una


transacción DENEGADA

Ejemplo de cadena con el resultado de la operación de PAGO:


<Operaciones version="6.0">
<resultadoOperacion>
<tipoPago>PAGO</tipoPago>
<importe>1.01</importe>
<moneda>978</moneda>
<tarjetaComercioRecibo>************0018</tarjetaComercioRecibo>
<tarjetaClienteRecibo>************0018</tarjetaClienteRecibo>
<marcaTarjeta>2</marcaTarjeta>
<caducidad>1210</caducidad>
<comercio>777888991</comercio>
<terminal>1</terminal>
<pedido>10549</pedido>
<tipoTasaAplicada>DEB</tipoTasaAplicada>
<identificadorRTS>070001070319153828378272</identificadorRTS>
<factura>FAC-LATENTE</factura>
<fechaOperacion>2007-03-19 15:38:28.484</fechaOperacion>
<estado>F</estado>
<resultado>Autorizada</resultado>
<codigoRespuesta>080922</codigoRespuesta>
<Literales>
<literal>NO REFUND</literal>
</Literales>
<firma>
760149C8F56DDAD17150C456B5B3DABB9949F4FCEAC7D71CC205C60B849A32DD</firma>
</resultadoOperacion>
</Operaciones>

Como se puede observar en el ejemplo, la transacción resultó


AUTORIZADA, ya que aparecen los campos estado con valor F, y resultado con
el literal Autorizada. Cualquier otro valor, debe tomarse como una transacción
Denegada.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 10
Integración Tpvpc Implantado WEB

7. ANEXO I. Ejemplo de formulario de petición.

A continuación se incluye un ejemplo de formulario en html para un mensaje


de petición de pago.

1. Mensaje de petición en formato xml:


<OperImplantadoWeb
version="6.0"><operacion><datosCompra><moneda>978</moneda>
<importe>0.01</importe><comercio>123443210</comercio><termin
al>1</terminal><tipoPago>PAGO</tipoPago><factura>FAC-
COMERCIO1</factura></datosCompra><datosConfiguracion><urlResp
uesta>urlRespuesta</urlRespuesta><urlNotificacion>urlNotificacion</u
rlNotificacion><correoNotificacion>correoNotificacion</correoNotificacio
n></datosConfiguracion><timestamp>20100916
120206</timestamp><firma>
6DA1D651CB31A053BC69491E8981D81781ECBB61CC7B86ECBA5B8B5
B3D0B39FE</firma></operacion></OperImplantadoWeb>

2. Mensaje de petición en formato hexadecimal:


3C4F706572496D706C616E7461646F5765622076657273696F6E3D223
62E30223E3C6F7065726163696F6E3E3C6461746F73436F6D7072613E
3C6D6F6E6564613E3937383C2F6D6F6E6564613E3C696D706F7274653
E302E30313C2F696D706F7274653E3C636F6D657263696F3E31323334
34333231303C2F636F6D657263696F3E3C7465726D696E616C3E313C2
F7465726D696E616C3E3C7469706F5061676F3E5041474F3C2F746970
6F5061676F3E3C666163747572613E4641432D434F4D455243494F313
C2F666163747572613E3C2F6461746F73436F6D7072613E3C6461746F
73436F6E66696775726163696F6E3E3C75726C5265737075657374613
E75726C5265737075657374613C2F75726C5265737075657374613E3C
75726C4E6F74696669636163696F6E3E75726C4E6F7469666963616369
6F6E3C2F75726C4E6F74696669636163696F6E3E3C636F7272656F4E6F
74696669636163696F6E3E636F7272656F4E6F74696669636163696F6E
3C2F636F7272656F4E6F74696669636163696F6E3E3C2F6461746F7343
6F6E66696775726163696F6E3E3C74696D657374616D703E323031303
0393136203132303230363C2F74696D657374616D703E3C6669726D61
3E3644413144363531434233314130353342433639343931453839383
144383137383145434242363143433742383645434241354238423542
33443042333946453C2F6669726D613E3C2F6F7065726163696F6E3E3
C2F4F706572496D706C616E7461646F5765623E

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 11
Integración Tpvpc Implantado WEB

3. Formulario html para realizar POST:


<form method=“POST”
action=”https://host/TPV_PC/entradaImplantadoWeb” name=”formPago”>
<input name="peticionXML" type="hidden"
value="3C4F706572496D706C616E7461646F5765622076657273696F6E3D
22362E30223E3C6F7065726163696F6E3E3C6461746F73436F6D7072613E3
C6D6F6E6564613E3937383C2F6D6F6E6564613E3C696D706F7274653E302
E30313C2F696D706F7274653E3C636F6D657263696F3E3132333434333231
303C2F636F6D657263696F3E3C7465726D696E616C3E313C2F7465726D69
6E616C3E3C7469706F5061676F3E5041474F3C2F7469706F5061676F3E3C6
66163747572613E4641432D434F4D455243494F313C2F666163747572613E
3C2F6461746F73436F6D7072613E3C6461746F73436F6E666967757261636
96F6E3E3C75726C5265737075657374613E75726C5265737075657374613C
2F75726C5265737075657374613E3C75726C4E6F74696669636163696F6E3
E75726C4E6F74696669636163696F6E3C2F75726C4E6F7469666963616369
6F6E3E3C636F7272656F4E6F74696669636163696F6E3E636F7272656F4E6F
74696669636163696F6E3C2F636F7272656F4E6F74696669636163696F6E3
E3C2F6461746F73436F6E66696775726163696F6E3E3C74696D657374616D
703E3230313030393136203132303230363C2F74696D657374616D703E3C
6669726D613E3644413144363531434233314130353342433639343931453
8393831443831373831454342423631434337423836454342413542384235
4233443042333946453C2F6669726D613E3C2F6F7065726163696F6E3E3C2
F4F706572496D706C616E7461646F5765623E" />
</form>

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 12
Integración Tpvpc Implantado WEB

8. ANEXO II. Ejemplo de respuesta recibida.

A continuación se incluye un ejemplo de un mensaje de respuesta recibida:


1. Contenido del parametro http-POST “xmlRespuesta”:
3C4F7065726163696F6E65732076657273696F6E3D22362E30223E3C7
26573756C7461646F4F7065726163696F6E3E3C7469706F5061676F3E5
041474F3C2F7469706F5061676F3E3C696D706F7274653E302E30313C
2F696D706F7274653E3C6D6F6E6564613E3937383C2F6D6F6E6564613
E3C72656369626F4F7063696F6E616C3E545255453C2F72656369626F4
F7063696F6E616C3E3C7461726A657461436C69656E74655265636962
6F3E2A2A2A2A2A2A2A2A2A2A2A2A303030333C2F7461726A657461436
C69656E746552656369626F3E3C7461726A657461436F6D657263696F
52656369626F3E2A2A2A2A2A2A2A2A2A2A2A2A303030333C2F7461726
A657461436F6D657263696F52656369626F3E3C6D617263615461726A
6574613E313C2F6D617263615461726A6574613E3C636164756369646
1643E303030303C2F6361647563696461643E3C636F6D657263696F3E
3132333434333231303C2F636F6D657263696F3E3C7465726D696E616
C3E313C2F7465726D696E616C3E3C70656469646F3E343639303C2F70
656469646F3E3C6964656E746966696361646F725254533E3037383039
303130303931363132333234383034373239313C2F6964656E7469666
96361646F725254533E3C666163747572613E4641432D434F4D455243
494F313C2F666163747572613E3C66656368614F7065726163696F6E3E
323031302D30392D31362031323A30323A30362E303C2F66656368614
F7065726163696F6E3E3C65737461646F3E463C2F65737461646F3E3C7
26573756C7461646F3E4175746F72697A6164613C2F726573756C7461
646F3E3C636F6469676F5265737075657374613E3034303832343C2F63
6F6469676F5265737075657374613E3C4C69746572616C65733E3C6C6
9746572616C3E3C2F6C69746572616C3E3C2F4C69746572616C65733E
3C6669726D613E3731423244463044433941424337414237353839384
545453242433145313745444638423939423234374231323042443331
43413332414332304336304431313C2F6669726D613E3C2F726573756
C7461646F4F7065726163696F6E3E3C2F4F7065726163696F6E65733E
2. Respuesta en formato XML después de convertir desde formato
hexadecimal a ASCII:

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 13
Integración Tpvpc Implantado WEB

<Operaciones
version="6.0"><resultadoOperacion><tipoPago>PAGO</tipoPago><import
e>0.01</importe><moneda>978</moneda><reciboOpcional>TRUE</recib
oOpcional><tarjetaClienteRecibo>************0003</tarjetaClienteRecib
o><tarjetaComercioRecibo>************0003</tarjetaComercioRecibo><
marcaTarjeta>1</marcaTarjeta><caducidad>0000</caducidad><comercio
>123443210</comercio><terminal>1</terminal><pedido>4690</pedido>
<identificadorRTS>078090100916123248047291</identificadorRTS><factu
ra>FAC-COMERCIO1</factura><fechaOperacion>2010-09-16
12:02:06.0</fechaOperacion><estado>F</estado><resultado>Autorizada
</resultado><codigoRespuesta>040824</codigoRespuesta><Literales><lit
eral>
</literal></Literales><firma>71B2DF0DC9ABC7AB75898EEE2BC1E17EDF8
B99B247B120BD31CA32AC20C60D11</firma></resultadoOperacion></Op
eraciones>

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 14
Integración Tpvpc Implantado WEB

9. ANEXO III. Ejemplo pago recurrente

9.1 Petición de pago con generación de token recurrente

Si el comercio tiene activada dicha operativa, se mostrará la siguiente


pantalla:

Se da la opción de realizar un pago manual o un pago recurrente por token.


 Pago manual: se introducirán los datos de la tarjeta necesarios para
realizar el pago. Se incluye la opción de generar un token recurrente
asociado a los datos de pago introducidos.
 Pago recurrente: se introducirá el token recurrente para realizar el
pago.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 15
Integración Tpvpc Implantado WEB

Respuesta de la operación de pago con generación de token:

<Operaciones version="6.0">
<resultadoOperacion>
<tipoPago>PAGO</tipoPago>
<importe>1.01</importe>
<moneda>978</moneda>
<tarjetaClienteRecibo>************0017</tarjetaClienteRecibo>
<tarjetaComercioRecibo>************0017</tarjetaComercioRecibo>
<marcaTarjeta>1</marcaTarjeta>
<token>67c68a0c028cf63008fa00e2c998ca60a65f474c</token>
<paisTarjeta>724</paisTarjeta>
<caducidad>0000</caducidad>
<comercio>777888991</comercio>
<terminal>3</terminal>
<pedido>2923</pedido>
<identificadorRTS>070001140922060949215263</identificadorRTS>
<factura>FAC-IMPLANTADO-WEB</factura>
<fechaOperacion>2014-09-22 05:54:22.0</fechaOperacion>
<estado>F</estado>
<resultado>Autorizada</resultado>
<codigoRespuesta>215263</codigoRespuesta>
<firma>CDB8F7E36E039CC10CD7BD1AC5745041C70FCF19BD5CB3208D21
0F18A6D814F9</firma>
</resultadoOperacion></Operaciones>

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 16
Integración Tpvpc Implantado WEB

9.2 Petición de pago mediante token recurrente

Petición de pago recurrente:

Respuesta de la operación de pago recurrente con token:

<Operaciones version="6.0">
<resultadoOperacion>
<tipoPago>PAGO</tipoPago>
<importe>1.01</importe>
<moneda>978</moneda>
<tarjetaClienteRecibo>************0017</tarjetaClienteRecibo>
<tarjetaComercioRecibo>************0017</tarjetaComercioRecibo>
<token>67c68a0c028cf63008fa00e2c998ca60a65f474c</token>
<paisTarjeta>724</paisTarjeta>
<caducidad>1249</caducidad>
<comercio>777888991</comercio>
<terminal>3</terminal>
<pedido>2925</pedido>
<identificadorRTS>070001140922061504215265</identificadorRTS>
<factura>FAC-IMPLANTADO-WEB</factura>
<fechaOperacion>2014-09-22 06:13:17.0</fechaOperacion>
<estado>F</estado>
<resultado>Autorizada</resultado>
<codigoRespuesta>215265</codigoRespuesta>
<firma>812CA3C77C3195E25AD2718B5DB30F59A629A854B7D50C0C4DB7
956E0BC7D4AF</firma>
</resultadoOperacion>
</Operaciones>

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 17
Integración Tpvpc Implantado WEB

10. ANEXO IV. 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.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 18
Integración Tpvpc Implantado WEB

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

Mensaje de Petición

La cadena que se firmará consta de los campos siguientes:

 tipoPago
 importe
 moneda
 comercio
 terminal
 timestamp
 ClaveComercio

Por tanto, la cadena se formará de la siguiente manera:

Cadena = tipoPago + importe + moneda + comercio + terminal +


timestamp + ClaveComercio

<OperImplantadoWeb version="6.0">
<operacion>
<datosCompra>
<moneda>978</moneda>
<importe>0.01</importe>
<comercio>123443210</comercio>
<terminal>1</terminal>
<tipoPago>PAGO</tipoPago>
</datosCompra>
<timestamp>20100916 141506</timestamp>
<firma>
39CD59A3B505A9E6C1E1B48E7823771449D3D1576CD375CD033E3401FE45AEA2</firma>
</operacion>
</OperImplantadoWeb>

Para este mensaje, la cadena sobre la que se aplica la firma sería:


PAGO0.01978123443210120100916 141506AAABBB

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 19
Integración Tpvpc Implantado WEB

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.

La cadena que se firmará consta de los campos siguientes:

 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)

 importe
 moneda
 comercio
 terminal
 pedido
 identificadorRTS
 fechaOperacion
 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.

Por tanto, la cadena se formará de la siguiente manera:

Cadena = tipoPago + [tarjetaComercioRecibo + tarjetaClienteRecibo +


caducidad] + importe + moneda + comercio + terminal + pedido +
identificadorRTS + fechaOperacion + estado + [resultado] + claveComercio

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 20
Integración Tpvpc Implantado WEB

Ejemplo:

<Operaciones version="6.0">
<resultadoOperacion>
<tipoPago>PAGO</tipoPago>
<importe>0.01</importe>
<moneda>978</moneda>
<tarjetaComercioRecibo>************8033</tarjetaComercioRecibo>
<tarjetaClienteRecibo>************8033</tarjetaClienteRecibo>
<marcaTarjeta>1</marcaTarjeta>
<caducidad>0707</caducidad>
<comercio>123443210</comercio>
<terminal>1</terminal>
<pedido>1173</pedido>
<identificadorRTS>070012050726130626371800</identificadorRTS>
<fechaOperacion>2005-07-26 13:06:26.22</fechaOperacion>
<estado>G</estado>
<resultado>Denegada</resultado>
<codigoRespuesta>190</codigoRespuesta>
<firma>14A5B811539955E782E0E3DC06DF80FBA1AFF3C72D63D29175860E6137811D2E</firma>
</resultadoOperacion>
</Operaciones>

Para este mensaje, la cadena sobre la que se aplica la firma sería:

PAGO************8033************803307070.01978123443210111730700120
507261306263718002005-07-26 13:06:26.22FDenegadaAAABBB

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 21
Integración Tpvpc Implantado WEB

11. ANEXO V. Esquema del Servicio Web.

A continuación se indica el XML-SCHEMA que deben cumplir los mensajes de


petición para esta operativa.

DESARROLLO:
https://sis-d.redsys.es/TPV_PC/wsdl/PAGOImplantadoWeb_v6d0.xsd

INTEGRACIÓN:
https://tpvpc-
i.redsys.es:27443/TPV_PC/wsdl/PAGOImplantadoWeb_v6d0.xsd

EXPLOTACIÓN:
https://tpvpc.redsys.es/TPV_PC/wsdl/PAGOImplantadoWeb_v6d0.xsd

Para los mensajes de respuesta, se utilizarán los siguientes:

DESARROLLO:
https://sis-d.redsys.es/TPV_PC/wsdl/PAGOSoap_v6d0.xsd

INTEGRACIÓN:
https://tpvpc-i.redsys.es:27443/TPV_PC/wsdl/PAGOSoap_v6d0.xsd

EXPLOTACIÓN:

https://tpvpc.redsys.es/TPV_PC/wsdl/PAGOSoap_v6d0.xsd

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 22
Integración Tpvpc Implantado WEB

12. ANEXO VI. Códigos Error TPV-PC.

Se han definido los mismos códigos de error que en TPV-PC Implantado. 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 operación 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.

TPV-PC0018 La tarjeta no se ha leído correctamente.


Asegúrese de que la asociación lector/terminal

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 23
Integración Tpvpc Implantado WEB

es la correcta, e inténtelo de nuevo.


La tarjeta no se ha leído correctamente.
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.
La tarjeta no se ha leído correctamente.
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.
Se ha producido un error al realizar la operación.
TPV-PC0031
Inténtelo de nuevo.
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.
TPV-PC0040 El sistema no ha podido completar la operación

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 24
Integración Tpvpc Implantado WEB

especificada. Por favor, inténtelo de nuevo.


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.
El sistema no ha podido completar la operación
TPV-PC0061
especificada. Por favor, inténtelo de nuevo.
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 El sistema no ha podido completar la


operación especificada. Por favor,

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 25
Integración Tpvpc Implantado WEB

inténtelo de nuevo.
El usuario ha sido dado de baja
satisfactoriamente, pero se ha producido un
TPV-PC0064 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.
El comercio no tiene habilitada la operativa de
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.
La tarjeta no se ha leído correctamente.
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 La tarjeta no se ha leído correctamente.


Asegúrese de que la tarjeta está en buen

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 26
Integración Tpvpc Implantado WEB

estado, e inténtelo de nuevo.


El sistema está ocupado. Reinténtelo de nuevo
TPV-PC0087 en unos instantes. Si el problema persiste,
póngase en contacto con su administrador.
Se ha producido un error al realizar la operación.
TPV-PC0089
Inténtelo de nuevo.
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.
Se ha producido un error al realizar la operación.
TPV-PC0092
Inténtelo de nuevo.
Se ha producido un error al realizar la operación.
TPV-PC0093
Inténtelo de nuevo.
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.
TPV-PC0109 La tarjeta no admite el pago en la divisa

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 27
Integración Tpvpc Implantado WEB

especificada.
TPV-PC0110 El número de plazos indicado no es válido.
El importe de una recarga para la operadora
TPV-PC0112
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.
El comercio no tiene habilitada la operativa de
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.
El sistema ha detectado que existe una
operación anterior con los mismos datos, con
TPV-PC0119
resultado de ERROR. Si desea repetir de nuevo
la operación, reinténtelo en unos instantes.
El sistema ha detectado que existe una
operación anterior con los mismos datos, con
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.
TPV-PC0129 No se puede asignar la operativa de Lista Negra

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 28
Integración Tpvpc Implantado WEB

al comercio. No existe ninguna lista negra


definida para ese comercio.
TPV-PC0131 El comercio no tiene activada esta operativa.
TPV-PC0148 No es posible realizar el aplazamiento del pago.
TPV-PC_EMV0000 Error interno en el protocolo TPVPC EMV
TPV-PC_EMV0001 Error interno en el protocolo TPVPC EMV
TPV-PC_EMV0002 Error interno en el protocolo TPVPC EMV
TPV-PC_EMV0003 Error interno en el protocolo TPVPC EMV
TPV-PC_EMV0004 Error en el proceso TLS.
TPV-PC_EMV0005 Pin OnLine Solicitado no Introducido.
TPV-PC_EMV0006 Terminal no Operativo. Sin Claves Simétricas.

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 29
Integración Tpvpc Implantado WEB

13. ANEXO VII. 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:

Código Descripción
101 La tarjeta está caducada
102 Tarjeta bloqueada por el banco emisor
Operación no permitida para esa tarjeta o
104
terminal
106 Intentos de PIN excedidos
Por favor, contacte con el banco emisor de la
107, 167
tarjeta
Identificación inválida de terminal o
109
establecimiento
110 Importe inválido
112 Se requiere PIN obligatorio
114 Tarjeta no soporta el tipo de operación solicitado
116 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

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 30
Integración Tpvpc Implantado WEB

El terminal indica que la operación de consumo


160
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
Tarjeta con restricciones débito (cuenta de
183
crédito)
184 Error en autenticación
185 Control dispositivos no adaptados EMV
187 Error en criptografía EMV
Denegada por el banco emisor de la tarjeta, por
190
diversos motivos
191 Fecha de caducidad errónea
192 Datos de case no encontrados
193 Importe excedido
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 tarje
Tarjeta bloqueada por el banco emisor. Orden de
202, 208, 209
retirar la tarjeta
Operación no permitida para esa tarjeta o
204
terminal
206 Intentos de PIN excedidos. Retener tarjeta
Tarjeta en condiciones especiales. Retener
207
tarjeta
210 Retención por controles sobre el VCA
CVV1/CVC1 o CVV2/CVC2 erróneo. Retener
280
tarjeta
Denegada por diversos motivos. Orden de retirar
290
la tarjeta
9112 Número de tarjeta inexistente
Código Descripción
101 La tarjeta está caducada

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 31
Integración Tpvpc Implantado WEB

102 Tarjeta bloqueada por el banco emisor


Operación no permitida para esa tarjeta o
104
terminal
106 Intentos de PIN excedidos
Por favor, contacte con el banco emisor de la
107, 167
tarjeta
Identificación inválida de terminal o
109
establecimiento
110 Importe inválido
112 Se requiere PIN obligatorio
114 Tarjeta no soporta el tipo de operación solicitado
116 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
El terminal indica que la operación de consumo
160
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
Tarjeta con restricciones débito (cuenta de
183
crédito)
184 Error en autenticación
185 Control dispositivos no adaptados EMV

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 32
Integración Tpvpc Implantado WEB

187 Error en criptografía EMV


Denegada por el banco emisor de la tarjeta, por
190
diversos motivos
191 Fecha de caducidad errónea
192 Datos de case no encontrados
193 Importe excedido
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 tarje
Tarjeta bloqueada por el banco emisor. Orden de
202, 208, 209
retirar la tarjeta
Operación no permitida para esa tarjeta o
204
terminal
206 Intentos de PIN excedidos. Retener tarjeta
Tarjeta en condiciones especiales. Retener
207
tarjeta
210 Retención por controles sobre el VCA
CVV1/CVC1 o CVV2/CVC2 erróneo. Retener
280
tarjeta
Denegada por diversos motivos. Orden de retirar
290
la tarjeta
9112 Número de tarjeta inexistente

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

Ref RS.TE.AEA.MAN.0005 <USO EXTERNO RESTRINGIDO> 06/03/2015

Versión: 1.2 33

S-ar putea să vă placă și