TPV Virtual de Santander Elavon: Guía de desarrollador - Almacenamiento seguro de tarjetas

TPV Virtual de Santander Elavon: Guía de desarrollador - Almacenamiento seguro de tarjetas Versión: 1.1

Índice 1 Acerca de esta guía 5 1.1 bjetivo 5 1.2 Destinatarios.5 1.3 Requisitos previos 5 1.4 Documentos relacionados.6 1.5 Convenciones 6 2 Información general 7 3 Almacenamiento Seguro de Tarjetas con Redirect: Configuración del pagador 10 3.1 Implementación de Redirect: Solicitud..10 3.1.1 Valores ocultos adicionales.11 3.1.2 Formato de valores ocultos adicionales.11 3.2 Implementación de Redirect: Respuesta...14 3.3 Firma digital para el servicio de Almacenamiento Seguro de Tarjetas con Redirect 18 4 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Escenarios 21 4.1 Escenario de configuración del método de pago, del pagador y de transacción correcta 21 4.2 Escenario de error de configuración del pagador o error de configuración del método de pago.22 4.2.1 Error de configuración del pagador: El pagador ya existe..22 4.2.2 Error de configuración del pago: La referencia del pago ya existe 23 4.2.3 Error de configuración del pagador y del pago.23 4.2.4 Transacción denegada..24 5 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: pciones de almacenamiento del pagador 25 5.1 Almacenamiento opcional del pagador..25 5.2 Almacenamiento automático del pagador..26 6 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Respuestas de error 28 6.1 Error 505 [Hash incorrecto: comprueba tu código y la documentación del desarrollador]...28 6.2 Error 514 [Datos no válidos en el campo PAYER_EXIST].28 6.3 Error 515 [Datos no válidos en el campo PAYER_REF].28 6.4 Error 516 [Datos no válidos en el campo FFER_SAVE_CARD].28 6.5 Error 517 [Datos no válidos en el campo PMT_REF]..28 7 Servicio de Almacenamiento Seguro de Tarjetas con XML Remote: Configuración del pagador 29 7.1 Configuración de un nuevo pagador..30 7.1.1 Ejemplo 30 7.1.2 Sintaxis XML..31 7.1.3 Sintaxis de valor hash 35 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 2

7.2 Configuración del método de pago.35 7.2.1 Ejemplo...35 7.2.2 Sintaxis XML..36 7.2.3 Sintaxis de valor hash 38 8 XML de: Administración de pagadores 39 8.1 Edición de un pagador existente 39 8.1.1 Ejemplo 39 8.1.2 Sintaxis XML..40 8.1.3 Sintaxis de valor hash 43 8.2 Actualización de detalles de tarjeta 44 8.2.1 Sustituir la tarjeta existente con una nueva tarjeta 45 8.2.2 Sintaxis de valor hash 45 8.2.3 Actualizar la fecha de caducidad o el nombre del titular de una tarjeta existente.45 8.2.4 Sintaxis de valor hash 46 8.2.5 Actualizar el número de emisión de una tarjeta existente 46 8.2.6 Sintaxis de valor hash 46 8.2.7 Sintaxis XML..47 8.2.8 Sintaxis de valor hash 48 8.3 Eliminación de tarjeta almacenada.49 8.3.1 Ejemplo 49 8.3.2 Sintaxis XML..49 8.3.3 Sintaxis de valor hash 50 9 XML de Almacenamiento Seguro de Tarjetas: Procesamiento de pagos con tarjeta de crédito 52 9.1 Cargo de un pago con tarjeta de crédito..52 9.1.1 Ejemplo 52 9.1.2 Sintaxis XML..54 9.1.3 Sintaxis de valor hash 60 9.2 Establecer una transacción manual a partir de una solicitud «receipt-in» 60 9.2.1 Ejemplo 60 9.2.2 Sintaxis XML..62 9.2.3 Sintaxis de valor hash 67 9.3 Procesamiento de un reembolso 67 9.3.1 Ejemplo 68 9.3.2 Sintaxis XML..69 9.3.3 Sintaxis de valor hash 73 9.4 Comprobación de si 3D Secure se puede utilizar en una tarjeta...73 9.4.1 Ejemplo 73 9.4.2 Sintaxis XML..74 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 3

9.4.3 Sintaxis de valor hash 76 9.5 Comprobación de si DCC se puede utilizar en una tarjeta.76 9.5.1 Ejemplo 76 9.5.2 Sintaxis XML..77 9.5.3 Sintaxis de valor hash 79 10 XML del Servicio de Almacenamiento de Tarjetas: Respuestas 80 10.1 Formato de respuesta...80 11 XML del Servicio de Almacenamiento Seguro de tarjetas: Respuestas de error estándar 82 11.1 Error 502 [El tipo «payer-new» no se ha implementado] 82 11.2 Error 503 [Tipo de solicitud no reconocido]..82 11.3 Error 504 [No existe este ID de comercio] 83 11.4 Error 505 [sha1hash incorrecto]..83 11.4.1 Ejemplo 83 11.5 Error 508 [Transacción caducada]..84 11.6 Error 508 [Se ha especificado un hash no válido] 84 12 XML del Servicio de Almacenamiento Seguro de tarjetas: Campos de respuesta 85 13 Firmas digitales 87 14 Anexo A: Códigos de resultado 89 14.1 Transacción realizada correctamente 89 14.2 Error interno con TPV Virtual de Santander Elavon.89 14.3 Datos no válidos en la solicitud..89 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 4

1 Acerca de esta guía En esta sección se ofrece una descripción general de esta guía, se define cuál es su objetivo, quiénes son sus destinatarios y se hace referencia a otros documentos relacionados. Este documento es confidencial y solo pueden utilizarlo los clientes del servicio TPV Virtual de Santander Elavon. Además, ten en cuenta que se ha proporcionado bajo las condiciones particulares de tu contrato de procesamiento de pagos. 1.1 bjetivo El objetivo de esta guía es proporcionar toda la información requerida para enviar solicitudes XML y mensajes HTTP válidos para cada tipo de transacción disponible como parte del servicio de Almacenamiento Seguro de Tarjetas de TPV Virtual de Santander Elavon. 1.2 Destinatarios Los destinatarios de esta guía son los desarrolladores web y de software. 1.3 Requisitos previos Para utilizar esta guía, debes tener experiencia y conocimiento en los siguientes conceptos: El uso correcto del servicio de autorización de TPV Virtual de Santander Elavon, tal y como se expone en la guía del desarrollador correspondiente. La creación y envío remoto de mensajes XML. Con el fin de utilizar el servicio de Almacenamiento Seguro de Tarjetas para pagos con tarjeta de crédito recurrentes desde tus propios sistemas, primero debes integrarte con TPV Virtual de Santander Elavon mediante los métodos Remote o Redirect, como se describe en la guía TPV Virtual Santander Elavon: Guía de desarrollador-redirect o TPV Virtual Santander Elavon: Guía de desarrollador-remote. Este documento describe el formato de los mensajes XML necesarios para configurar clientes y métodos de pago, y la forma correcta de utilizarlos. Asimismo, proporciona información sobre cómo configurar clientes mediante el método de integración Redirect. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 5

1.4 Documentos relacionados Además de esta guía, para obtener información sobre el servicio de autorización, puedes consultar los documentos que forman parte de la documentación de TPV Virtual de Santander Elavon: TPV Virtual Santander Elavon: Guía de desarrollador-redirect TPV Virtual Santander Elavon: Guía de desarrollador-remote TPV Virtual Santander Elavon: Guía de integración-definiciones XML 1.5 Convenciones En la documentación de TPV Virtual de Santander Elavon, se han aplicado las siguientes convenciones: Nota: Señala sugerencias o consejos para el usuario. Precaución: Señala una nota importante. Indica un posible impacto económico.. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 6

2 Información general El servicio de Almacenamiento Seguro de Tarjetas es la solución de almacenamiento de tarjetas de TPV Virtual de Santander Elavon que se ha diseñado para mejorar la experiencia de los clientes y aliviar los requisitos de cumplimiento de PCI, ya que su mantenimiento supone un gasto continuo. Por ello, gracias al traslado de tus necesidades de almacenamiento de tarjetas a TPV Virtual, podrás ahorrar tiempo y dinero. Con el servicio de Almacenamiento Seguro de Tarjetas, cada cliente recibe un token llamado referencia del pagador y, cada método de pago, es decir, la tarjeta que se va a almacenar en el Servicio de Almacenamiento de Tarjetas, recibe una referencia de pago (o referencia de la tarjeta). El comercio es el encargado de asignar estas referencias. Asimismo, una vez capturados los detalles, el comercio puede utilizar el conjunto completo de mensajes Remote XML del Servicio Almacenamiento Seguro de Tarjetas para administrar el pagador y llevar a cabo transacciones con referencias y tokens (para el pagador y la tarjeta) en lugar de con números de tarjeta. Por lo tanto, es importante que almacenes las referencias y tokens devueltos en tu base de datos. Hay dos métodos mediante los cuales el cliente puede integrarse con TPV Virtual de Santander Elavon: Redirect (alojada) y Remote (integrada). A continuación, se incluye información general de cada uno de ellos. El servicio de autorización de TPV Virtual de Santander Elavon con integración Redirect puede configurarse para su funcionamiento con el servicio de Almacenamiento Seguro de Tarjetas. Con esta configuración, el servicio captura la información de pago del cliente mientras este realiza la operación. El servicio Redirect generará solicitudes de almacenamiento de referencias y tokens, siempre que la transacción se haya autorizado correctamente y que los mensajes Remote XML del servicio de Almacenamiento Seguro de Tarjetas puedan usarse para administrar el pagador a partir de entonces. La figura 1 ofrece una visión general del funcionamiento del servicio de Almacenamiento Seguro de Tarjetas con Redirect. En la solución Remote, el cliente introducirá los datos de su tarjeta en una página web alojada en el servidor del comercio. En este punto, el sistema del comercio recopila los detalles para que puedan enviarse a TPV Virtual de Santander Elavon para su almacenamiento y, si fuera necesario, para recaudar un pago inicial (no es necesario un pago inicial para almacenar los datos, aunque sí se recomienda). El comercio utilizará mensajes Remote XML para generar las solicitudes XML de nuevo pagador y de nueva TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 7

tarjeta con el fin de almacenar las referencias y tokens, aunque también para administrar al pagador en lo sucesivo. La figura 2 ofrece una visión general del funcionamiento del Servicio de Almacenamiento Seguro de Tarjetas con Remote. El servicio de Almacenamiento Seguro de Tarjetas conlleva un cargo y que debe activarse antes de su uso. Para obtener más información sobre el cargo del servicio de Almacenamiento Seguro de Tarjetas, ponte en contacto con el equipo de soporte TPV Virtual de Santander Elavon enviando un correo electrónico a soporte@santanderelavontpvvirtual.es. Figura 1: El diagrama a continuación ofrece una visión general del funcionamiento del servicio de Almacenamiento Seguro de Tarjetas con Redirect. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 8

Figura 2: El diagrama a continuación ofrece una visión general del funcionamiento del servicio de Almacenamiento Seguro de Tarjetas con Remote. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 9

3 Almacenamiento Seguro de Tarjetas con Redirect: Configuración del pagador 3.1 Implementación de Redirect: Solicitud Todas las solicitudes del servicio de Almacenamiento Seguro de Tarjetas con Redirect deben registrarse en la URL alojada estándar: https://remote.santanderelavontpvvirtual.es/vault Una vez autorizada la tarjeta correctamente, el servicio Redirect generará una solicitud XML de nuevo pagador, seguida de una solicitud de nuevo método de pago. El sistema Redirect solo configurará el pagador y el método de pago con tarjeta una vez que esta se haya autorizado correctamente. La referencia del pagador y del pago, que hacen alusión al pagador y al método de pago con tarjeta del sistema TPV Virtual de Santander Elavon, se devolverán al comercio con campos de respuesta adicionales devueltos en HTTP al script de respuesta del este. Para alojar esta nueva funcionalidad, deberán incluirse algunos campos de texto ocultos en el PST para el servicio de Autorización de TPV Virtual de Santander Elavon con integración Redirect. Estos campos se describen en la sección 3.1.1. Una vez configurado el pagador, los mensajes Remote XML del servicio de Almacenamiento Seguro de Tarjetas pueden usarse para llevar a cabo acciones posteriores como la actualización de los detalles del pagador y el cargo de los pagos. Las siguientes secciones proporcionan la información necesaria para configurar un nuevo pagador mediante Redirect: TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 10

3.1.1 Valores ocultos adicionales A continuación, se muestra un fragmento de los campos ocultos. Los campos en negrita son los campos adicionales requeridos en el PST: <form method="pst" action=" https://hpp.santanderelavontpvvirtual.es/pay"> <input type="hidden" name="merchant_id" value="tpv Virtual de Santander Elavon merchantid"> <input type="hidden" name="rder_id" value="unique order-id"> <input type="hidden" name="accunt" value="sub account name"> <input type="hidden" name="amunt" value="amount"> <input type="hidden" name="currency" value="currency code"> <input type="hidden" name="timestamp" value="yyyymmddhhmmss"> <input type="hidden" name="ffer_save_card" value="1"> <input type="hidden" name="payer_ref" value="abc"> <input type="hidden" name="pmt_ref" value="tarjeta01"> <input type="hidden" name="payer_exist" value="0"> <input type="hidden" name="sha1hash" value="32 character string"> <input type="hidden" name="aut_settle_flag" value="1 or 0"> <input type="submit" value="click here to Purchase"> </form> 3.1.2 Formato de valores ocultos adicionales La siguiente tabla ofrece información para cada campo o valor oculto: Una indicación sobre si el elemento o campo es obligatorio (M), opcional () o condicional (C) en función de otro campo El formato del valor en términos de caracteres o números permitidos La longitud permitida del valor Una descripción TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 11

Elemento/campo M//C Formato Longitud Descripción FFER_SAVE_CARD M 0-9 1 Este campo oculto activa el servicio de almacenamiento seguro de tarjetas. Asimismo, determina si mostrar la casilla «Guardar detalles de tarjeta» al cliente o no. Si el valor es «1», se muestra la casilla; si es «0», no. Si la casilla «Guardar detalles de tarjeta» está oculta en la página de pago para el almacenamiento automático de los detalles de la tarjeta, este valor deberá establecerse en «1». PAYER_REF M a z 0 9 _ "" A Z 1-50 Este campo contiene la referencia del pagador utilizada para el titular de la tarjeta. Si falta este campo o está vacío, y PAYER_EXIST es igual a «0», el valor de referencia del pagador se generará automáticamente. Para añadir otra tarjeta a un pagador existente, el campo PAYER_REF debe establecerse con su referencia de pagador actual. Este campo es obligatorio si se establecen los elementos FFER_SAVE_CARD y PAYER_EXIST en «1». De definirse así, siempre que faltase el campo o TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 12

Elemento/campo M//C Formato Longitud Descripción estuviese vacío se devolvería un error 5xx: 5xx «Falta un campo obligatorio. PAYER_REF no está presente en la solicitud» TPV Virtual de Santander Elavon sugiere que sea el comercio el que proporcione la referencia del pagador, ya que le facilitará la administración de sus pagadores. PMT_REF M a-z, A-Z, 0-9 1-30 La referencia que se va a utilizar para el método de pago guardado. Si falta este campo, se generará automáticamente una referencia alfanumérica. TPV Virtual de Santander Elavon sugiere que sea el comercio el que proporcione la referencia del pagador, ya que le facilitará la administración de sus pagadores. PAYER_EXIST M 0-9 1 Si quieres añadir una nueva tarjeta a un pagador existente, debes establecer este campo en «1». De lo contrario, se establecerá en «0», es decir, como un nuevo pagador. Si el pagador existe y el valor se establece en «1», TPV Virtual de Santander Elavon no creará un pagador nuevo, pero sí añadirá la TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 13

Elemento/campo M//C Formato Longitud Descripción nueva tarjeta utilizada al pagador especificado en el campo PAYER_REF. 3.2 Implementación de Redirect: Respuesta Como se ha mencionado anteriormente, se devolverán campos adicionales para que el comercio pueda guardar en su base de datos las referencias del pagador y los detalles del pago. La tabla a continuación ofrece la siguiente información: Una indicación sobre si el elemento o campo es obligatorio (M), opcional () o condicional (C) en función de otro campo El formato del valor en términos de caracteres o números permitidos La longitud permitida del valor Una descripción Elemento/campo M//C Formato Longitud Descripción REALWALLET_CHSEN M 0-9 1 Este campo indica al comercio si el titular de la tarjeta ha elegido la opción Redirect de integración redirigida del servicio de almacenamiento seguro de tarjetas. Si el campo se establece en «1», quiere decir que el titular de la tarjeta ha decidido almacenar los datos. En caso contrario, el campo se establece en «0». De este modo, el comercio conoce la opción escogida por el titular de la tarjeta. Si el comercio envía el campo solicitado (FFER_SAVE_CARD = 1), este siempre se devuelve. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 14

Elemento/campo M//C Formato Longitud Descripción PAYER_SETUP M 0-9 2-3 Este campo indica si se configuró el titular de la tarjeta como pagador en el sistema TPV Virtual de Santander Elavon o no. Un valor «00» implica una configuración correcta y cualquier otro valor indica un error (normalmente, un error «508»). El campo solo se devuelve si se ha intentado configurar un pagador, es decir, que no se devolverá si la solicitud implica la configuración de un pagador existente con un nuevo método de pago. PAYER_SETUP_MSG M a-z A-Z Este campo indica el texto del mensaje devuelto por TPV Virtual de Santander Elavon como resultado de la configuración del titular de la tarjeta como pagador. El campo solo se devuelve si se ha intentado configurar un pagador, es decir, que no se devolverá si la solicitud implica la configuración de un pagador existente con un nuevo método de pago. PMT_SETUP M 0-9 2-3 Este campo indica si se han configurado los detalles de la tarjeta del titular o no. El valor «00» significa que la configuración es correcta; cualquier otro valor indica un error. Consulta el anexo A para ver la lista de los códigos de error. El campo solo se devuelve si se ha intentado configurar un TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 15

Elemento/campo M//C Formato Longitud Descripción método de pago con tarjeta. PMT_SETUP_MSG M a-z A-Z Este campo indica el texto del mensaje devuelto por TPV Virtual de Santander Elavon como resultado de la configuración de los detalles de pago con tarjeta en dicho sistema. El campo solo se devuelve si se ha intentado configurar el método de pago con tarjeta. SAVED_PAYER_REF C a z A Z 0 9 _ "" 1-50 Este campo indica la referencia del pagador para este titular de tarjeta. Si PAYER_REF estaba presente en los campos ocultos entrantes, el campo SAVED_PAYER_REF será similar a este último. De lo contrario, contendrá un valor alfanumérico generado automáticamente. Este campo solo se devolverá si las referencias de pagador y de pago se han configurado correctamente. SAVED_PMT_REF C a-z A-Z 0-9 1-30 Este campo indica la referencia de pago con tarjeta para este método de pago. Se trata de un valor alfanumérico. Si PMT_REF estaba especificado en los campos ocultos entrantes, el campo SAVED_PMT_REF será similar a este último. De lo contrario, contendrá un valor alfanumérico generado automáticamente. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 16

Elemento/campo M//C Formato Longitud Descripción Este campo solo se devolverá si las referencias de pagador y de pago se han configurado correctamente. SAVED_PMT_TYPE C a-z A-Z El tipo de tarjeta del pago guardado, es decir, todos los tipos de tarjeta. Es el tipo de tarjeta del método de pago con tarjeta almacenado. Este campo solo se devolverá si las referencias de pagador y de pago se han configurado correctamente. SAVED_PMT_DIGITS C a-z A-Z 0-9 14 En este campo se ocultarán algunos dígitos del número de la tarjeta, por ejemplo, 664422xxxx7820. Este campo solo se devolverá si las referencias de pagador y de pago se han configurado correctamente. SAVED_PMT_EXPDATE C 0-9 4 El campo contendrá la fecha de caducidad del método de pago con tarjeta. También puede utilizarse para advertir a los titulares sobre el vencimiento inminente de los detalles almacenados. Esta información se mostrará con el formato MMAA, por ejemplo, 1108. Este campo solo se devolverá si las referencias de pagador y de pago se han configurado TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 17

Elemento/campo M//C Formato Longitud Descripción correctamente. SAVED_PMT_NAME C a-z A-Z 0-9 -+ "" ' 1-100 El nombre de la persona asociada con el método de pago, por ejemplo, el nombre del titular de la tarjeta. Se utiliza por motivos de visualización. Este campo solo se devolverá si las referencias de pagador y de pago se han configurado correctamente. 3.3 Firma digital para el servicio de Almacenamiento Seguro de Tarjetas con Redirect La cadena hash para del servicio de Almacenamiento Seguro de Tarjetas incluye las referencias del pagador y del pago. Formato: timestamp.merchant_id.order_id.amount.currency.payerref.pmt_ref Ejemplo: 20090320151742.tuiddecliente.transacción1.9999.EUR.pérez01.visa1 Con los detalles del ejemplo de la sección 10.1, se ha creado el hash SHA1 que se muestra a continuación: <form method="pst" action="https://hpp.santanderelavontpvvirtual.es/pay"> <input type="hidden" name="merchant_id" value="tpv Virtual de Santander Elavon merchantid"> <input type="hidden" name="rder_id" value="unique order-id"> <input type="hidden" name="accunt" value="sub account name"> <input type="hidden" name="amunt" value="amount"> <input type="hidden" name="currency" value="currency code"> <input type="hidden" name="timestamp" value="yyyymmddhhmmss"> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 18

<input type="hidden" name="ffer_save_card" value="1"> <input type="hidden" name="payer_ref" value="abc"> <input type="hidden" name="pmt_ref" value="tarjetas1"> <input type="hidden" name="payer_exist" value="0"> <input type="hidden" name="sha1hash" value="32 character string"> <input type="hidden" name="aut_settle_flag" value="1 or 0"> <input type="submit" value="click here to Purchase"> </form> Crea una cadena mediante la concatenación con un punto («.») de los campos anteriores en el orden siguiente: (TIMESTAMP.MERCHANT_ID.RDER_ID.AMUNT.CURRENCY,PAYER_REF.PMT_REF) Por ejemplo: (20100630163022.latienda.ord_123456.2.500.EUR.pagador1.pérez01) btén el hash de esta cadena (el SHA-1 indicado abajo). (de29ed5a54ce86e021d57bda22a699569730d3e6) Crea una cadena nueva mediante la concatenación con un punto («.») de esta cadena y el secreto compartido. (de29ed5a54ce86e021d57bda22a699569730d3e6.misecreto) btén el hash de este valor, que es el que se envía a TPV Virtual de Santander Elavon. (9b371d45a17089532f34b00ed649a95e328a8cb2) Cuando TPV Virtual de Santander Elavon recibe la solicitud, se lleva a cabo el mismo procedimiento con los siete fragmentos de información y el secreto compartido (almacenado en la base de datos). Si el hash resultante es el mismo que el que nos enviaste, entonces los datos solo pudo haberlos enviado una persona que conociese tu secreto compartido. Nota: La firma digital para el servicio de Almacenamiento Seguro de Tarjetas con Redirect es diferente a la firma digital para el servicio de Autorización de TPV Virtual de Santander Elavon con Redirect. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 19

Si estableces el valor «FFER_SAVE_CARD» en «1», indicarás que quieres utilizar el servicio de Almacenamiento Seguro de Tarjetas y, en consecuencia, se te pedirá que utilices la firma digital mencionada anteriormente. Si falta el valor «FFER_SAVE_CARD» o lo estableces en «0», indicarás que no deseas utilizar el servicio de Almacenamiento Seguro de Tarjetas y, en consecuencia, se te pedirá que utilices la firma digital estándar mencionada en la TPV Virtual Santander Elavon: Guía de desarrollador-redirect. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 20

4 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Escenarios Es posible que un comercio se encuentre con un escenario en el que la tarjeta se ha autorizado, pero el método de pago o el pagador han fallado. En cualquiera de estos casos, es necesario mostrar al titular de la tarjeta el texto adecuado generado por el comercio con el fin de indicarle que la compra se ha realizado correctamente, pero que no se han almacenado los detalles de la tarjeta. El comercio puede determinar el resultado de una configuración del pagador o de un método de pago mediante el análisis de los campos de respuesta: 4.1 Escenario de configuración del método de pago, del pagador y de transacción correcta RESULT=00 Resultado de la solicitud de autorización. PAYER_SETUP=00 Resultado del XML de nuevo pagador generado por Redirect tras la correcta autorización de la tarjeta. PAYER_SETUP_MSG Satisfactorio PMT_SETUP=00 Resultado del XML de nueva tarjeta generado por Redirect tras la correcta configuración del pagador. PMT_SETUP_MSG Satisfactorio En este caso, el comercio debería ver los siguientes elementos devueltos en la respuesta: REALWALLET_CHSEN=1 PAYER_SETUP=00 PAYER_SETUP_MSG= Satisfactorio SAVED_PAYER_REF=pgtestpayer4 PMT_SETUP=00 PMT_SETUP_MSG= Satisfactorio SAVED_PMT_TYPE=VISA TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 21

SAVED_PMT_REF=123 SAVED_PMT_DIGITS=664422xxxx1307 SAVED_PMT_EXPDATE=0212 SAVED_PMT_NAME=Juan Pérez Gómez RESULT=00 4.2 Escenario de error de configuración del pagador o error de configuración del método de pago 4.2.1 Error de configuración del pagador: El pagador ya existe RESULT=00 Resultado de la solicitud de autorización. PAYER_SETUP=508 Resultado del XML de nuevo pagador generado por Redirect tras la correcta autorización de la tarjeta. PAYER_SETUP_MSG Este cliente ya existe PMT_SETUP=508 Resultado del XML de nueva tarjeta generado por Redirect tras la correcta configuración del pagador. PMT_SETUP_MSG Se ha producido un error al crear el cliente método de pago abortado. En este caso, el comercio debería ver los siguientes elementos devueltos en la respuesta: REALWALLET_CHSEN=1 PAYER_SETUP=508 PAYER_SETUP_MSG= Este cliente ya existe PMT_SETUP=508 PMT_SETUP_MSG=Se ha producido un error al crear el cliente método de pago abortado RESULT=00 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 22

4.2.2 Error de configuración del pago: La referencia del pago ya existe RESULT=00 Resultado de la solicitud de autorización. PAYER_SETUP=00 Resultado del XML de nuevo pagador generado por Redirect tras la correcta autorización de la tarjeta. PAYER_SETUP_MSG Satisfactorio. PMT_SETUP=508 Resultado del XML de nueva tarjeta generado por Redirect tras la correcta configuración del pagador. PMT_SETUP_MSG Este método de pago ya existe. En este caso, el comercio debería ver los siguientes elementos devueltos en la respuesta: REALWALLET_CHSEN=1 PAYER_SETUP=00 PAYER_SETUP_MSG= Satisfactorio SAVED_PAYER_REF=pgtestpayer4 PMT_SETUP=508 PMT_SETUP_MSG= Este método de pago ya existe RESULT=00 4.2.3 Error de configuración del pagador y del pago RESULT=00 Resultado de la solicitud de autorización. PAYER_SETUP=508 Resultado del XML de nuevo pagador generado por Redirect tras la correcta autorización de la tarjeta. PAYER_SETUP_MSG Se ha producido un error creando el cliente. PMT_SETUP=508 Resultado del XML de nueva tarjeta generado por Redirect tras la correcta configuración del pagador. PMT_SETUP_MSG Se ha producido un error creando el método de pago En este caso, el comercio debería ver los siguientes elementos devueltos en la respuesta: TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 23

REALWALLET_CHSEN=1 PAYER_SETUP=508 PAYER_SETUP_MSG=Se ha producido un error creando el cliente PMT_SETUP=508 PMT_SETUP_MSG= Se ha producido un error creando el método de pago RESULT=00 4.2.4 Transacción denegada RESULT=101 Resultado de la solicitud de autorización. En este caso, el comercio no verá los valores adicionales devueltos del servicio, ya que en casos en los que se haya denegado la tarjeta no se realizará el proceso. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 24

5 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: pciones de almacenamiento del pagador Según la configuración enviada en el PST oculto, el cliente tendrá la posibilidad de guardar los detalles de su tarjeta en el sistema mientras se encuentra en la página de pago seguro de TPV Virtual de Santander Elavon. Para ello, el comercio dispone de una de las opciones indicadas a continuación: Almacenamiento opcional del pagador: El comercio ofrece al pagador la posibilidad de que se almacenen los detalles de su tarjeta. Almacenamiento automático del pagador: El comercio guarda de forma automática los detalles del pagador una vez que la transacción se ha completado correctamente. 5.1 Almacenamiento opcional del pagador Mientras el cliente realiza el pago, se muestra una casilla y texto informativo que le ofrece la posibilidad de guardar los datos de su tarjeta para futuras transacciones. Si marca esta casilla y la tarjeta de crédito está correctamente autorizada, se configurará automáticamente el cliente como pagador en el sistema TPV Virtual de Santander Elavon. El servicio Redirect generará una solicitud XML de nuevo pagador, seguida de una solicitud XML de nueva tarjeta. La referencia del pagador y la referencia del pago generadas se devolverán al comercio junto con los campos de respuesta adicionales. Este almacenará entonces los nuevos fragmentos de información en el registro del cliente. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 25