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

Índice 1 Acerca de esta guía 7 1.1 bjetivo 7 1.2 Destinatarios.7 1.3 Requisitos previos 1.4 Documentos relacionados 7.8 1.5 Convenciones 8 2 Información general 9 3 Almacenamiento Seguro de Tarjetas con Redirect: Configuración del pagador 12 3.1 Implementación de Redirect: Solicitud..12 3.1.1 Valores ocultos adicionales.13 3.1.2 Formato de valores ocultos adicionales.13 3.2 Implementación de Redirect: Respuesta...16 3.3 Firma digital para el servicio de Almacenamiento Seguro de Tarjetas con Redirect 20 4 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Escenarios 23 4.1 Escenario de configuración del método de pago, del pagador y de transacción correcta 23 4.2 Escenario de error de configuración del pagador o error de configuración del método de pago.24 4.2.1 Error de configuración del pagador: El pagador ya existe..24 4.2.2 Error de configuración del pago: La referencia del pago ya existe 25 4.2.3 Error de configuración del pagador y del pago.25 4.2.4 Transacción denegada..26 5 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: pciones de almacenamiento del pagador 27 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 2

5.1 Almacenamiento opcional del pagador 5.2 Almacenamiento automático del pagador..27..28 6 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Respuestas de error 30 6.1 Error 505 [Hash incorrecto: comprueba tu código y la documentación del desarrollador] 6.2 Error 514 [Datos no válidos en el campo PAYER_EXIST] 6.3 Error 515 [Datos no válidos en el campo PAYER_REF] 6.4 Error 516 [Datos no válidos en el campo FFER_SAVE_CARD] 6.5 Error 517 [Datos no válidos en el campo PMT_REF]...30.30.30.30..30 7 Servicio de Almacenamiento Seguro de Tarjetas con XML Remote: Configuración del pagador 31 7.1 Configuración de un nuevo pagador..32 7.1.1 Ejemplo 32 7.1.2 Sintaxis XML..33 7.1.3 Sintaxis de valor hash 37 7.2 Configuración del método de pago.37 7.2.1 Ejemplo...37 7.2.2 Sintaxis XML..38 7.2.3 Sintaxis de valor hash 40 8 XML de: Administración de pagadores 41 8.1 Edición de un pagador existente 41 8.1.1 Ejemplo 41 8.1.2 Sintaxis XML..42 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 3

8.1.3 Sintaxis de valor hash 45 8.2 Actualización de detalles de tarjeta 46 8.2.1 Sustituir la tarjeta existente con una nueva tarjeta 47 8.2.2 Sintaxis de valor hash 47 8.2.3 Actualizar la fecha de caducidad o el nombre del titular de una tarjeta existente.47 8.2.4 Sintaxis de valor hash 48 8.2.5 Actualizar el número de emisión de una tarjeta existente 48 8.2.6 Sintaxis de valor hash 48 8.2.7 Sintaxis XML..49 8.2.8 Sintaxis de valor hash 50 8.3 Eliminación de tarjeta almacenada.51 8.3.1 Ejemplo 51 8.3.2 Sintaxis XML..51 8.3.3 Sintaxis de valor hash 52 9 XML de Almacenamiento Seguro de Tarjetas: Procesamiento de pagos con tarjeta de crédito 54 9.1 Cargo de un pago con tarjeta de crédito..54 9.1.1 Ejemplo 54 9.1.2 Sintaxis XML..56 9.1.3 Sintaxis de valor hash 62 9.2 Establecer una transacción manual a partir de una solicitud «receiptin» 62 9.2.1 Ejemplo 62 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 4

9.2.2 Sintaxis XML..64 9.2.3 Sintaxis de valor hash 69 9.3 Procesamiento de un reembolso 69 9.3.1 Ejemplo 70 9.3.2 Sintaxis XML..71 9.3.3 Sintaxis de valor hash 75 9.4 Comprobación de si 3D Secure se puede utilizar en una tarjeta...75 9.4.1 Ejemplo 75 9.4.2 Sintaxis XML..76 9.4.3 Sintaxis de valor hash 78 9.5 Comprobación de si DCC se puede utilizar en una tarjeta.78 9.5.1 Ejemplo 78 9.5.2 Sintaxis XML..79 9.5.3 Sintaxis de valor hash 81 10 XML del Servicio de Almacenamiento de Tarjetas: Respuestas 82 10.1 Formato de respuesta...82 11 XML del Servicio de Almacenamiento Seguro de tarjetas: Respuestas de error estándar 84 11.1 Error 502 [El tipo «payer-new» no se ha implementado] 11.2 Error 503 [Tipo de solicitud no reconocido] 11.3 Error 504 [No existe este ID de comercio] 11.4 Error 505 [sha1hash incorrecto] 84..84 85..85 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 5

11.4.1 Ejemplo 85 11.5 Error 508 [Transacción caducada] 11.6 Error 508 [Se ha especificado un hash no válido]..86 86 12 XML del Servicio de Almacenamiento Seguro de tarjetas: Campos de respuesta 87 13 Firmas digitales 89 14 Anexo A: Códigos de resultado 91 14.1 Transacción realizada correctamente 14.2 Error interno con TPV Virtual de Santander Elavon 14.3 Datos no válidos en la solicitud 91.91..91 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 6

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. Nota: Cuando pruebe este servicio, todo el tráfico de test debe ser enviado a la pasarela utilizando la URL de pruebas. El entorno de producción no puede ser utilizado para pruebas. 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 7

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 8

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 tarjeta con el fin de almacenar las referencias y tokens, aunque también para administrar al pagador en lo sucesivo. La figura 2 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 9

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 10

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 11

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://api.prueba.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 12

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://pay.prueba.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 13

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 A Z 0 9 _ "" 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 14

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 15

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 16

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 método de pago con tarjeta. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 17

Elemento/campo M//C Formato Longitud Descripción 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. Este campo solo se devolverá si las referencias de pagador y de TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 18

Elemento/campo M//C Formato Longitud Descripción 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-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 correctamente. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 19

Elemento/campo M//C Formato Longitud Descripción 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://pay.prueba.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"> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 20

<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. 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. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 21

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 22

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 23

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 24

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 25

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 26

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 27

Ejemplo de formulario de pago con almacenamiento opcional del pagador 5.2 Almacenamiento automático del pagador El comercio puede configurar la página de pago para que el cliente no pueda ver la casilla de almacenamiento opcional. De esta forma, siempre que la transacción se haya completado correctamente, los detalles de la tarjeta se almacenarán de forma automática. Con esta configuración, el titular de la tarjeta no se dará cuenta de que se han almacenado los datos de su tarjeta. Para ello, recibirás la ayuda del analista de Integración y Soporte. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 28

Ejemplo de formulario de pago con almacenamiento automático del pagador TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 29

6 Servicio de Almacenamiento Seguro de Tarjetas con Redirect: Respuestas de error 6.1 Error 505 [Hash incorrecto: comprueba tu código y la documentación del desarrollador] Se ha proporcionado un hash incorrecto para este servicio. La cadena hash correcta para el almacenamiento de la tarjeta y la autorización de Redirect es la siguiente: timestamp.merchantid.orderid.amount.curr.payerref.pmtref 6.2 Error 514 [Datos no válidos en el campo PAYER_EXIST] Se han enviado datos no válidos en el campo PAYER_EXIST. Los valores permitidos para este campo son «0» y «1». 6.3 Error 515 [Datos no válidos en el campo PAYER_REF] Se han enviado datos no válidos en el campo PAYER_REF. Este campo solo puede contener valores alfanuméricos. También puede incluir guiones (-) y guiones bajos (_). 6.4 Error 516 [Datos no válidos en el campo FFER_SAVE_CARD] Se han enviado datos no válidos en el campo FFER_SAVE_CARD. Los valores permitidos para este campo son «0» y «1». 6.5 Error 517 [Datos no válidos en el campo PMT_REF] Se han enviado datos no válidos en el campo PMT_REF. Este campo solo puede contener valores alfanuméricos. También puede incluir guiones (-) y guiones bajos (_). TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 30

7 Servicio de Almacenamiento Seguro de Tarjetas con XML Remote: Configuración del pagador Todas las solicitudes XML del servicio enviarse a la siguiente URL: de Almacenamiento Seguro de Tarjetas deben https://api.prueba.santanderelavontpvvirtual.es/vault Nota: Cuando pruebe este servicio, todo el tráfico de test debe ser enviado a la pasarela utilizando la URL de pruebas. El entorno de producción no puede ser utilizado para pruebas. Esta sección describe las solicitudes XML necesarias para configurar los pagadores en el sistema del servicio de Almacenamiento Seguro de Tarjetas. Antes de poder cobrar a un pagador con las referencias en lugar de con los detalles de la tarjeta, es necesario llevar a cabo dos pasos en la configuración: Debe establecerse un pagador en el sistema. Debe establecerse un método de pago para dicho pagador. Una vez completados estos pasos, podrás cobrar al pagador de forma periódica con solo una solicitud XML. Flujo recomendado para la primera autorización: Si vas a cobrar al cliente al tiempo que almacenas los detalles de su tarjeta, es recomendable que primero realices una autorización estándar. De esta forma, evitarás el almacenamiento de tarjetas no válidas o denegadas, y permitirás el envío de datos de CVN para la primera autorización. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 31

Autentificación de 3D Secure (si lo deseas) Consulta la Guía del desarrollador de 3D Secure Autorización estándar Consulta la Guía del desarrollador de XML de Autorización de TPV Virtual de Santander Elavon Si la autorización se realiza correctamente, crea un perfil con la solicitud Payer-New. Almacena los detalles de la tarjeta con la solicitud Card-New Card Update Card Solicitud receipt-in para recaudar pagos posteriores 7.1 Configuración de un nuevo pagador El primer paso de la configuración es crear un pagador. El término «pagador» hace referencia a la información de que dispones sobre la empresa o persona real, y no a los detalles de la tarjeta de crédito. Las siguientes secciones proporcionan la información necesaria para configurar un nuevo pagador: Ejemplo Sintaxis XML Sintaxis de valor hash 7.1.1 Ejemplo Nota: Consulta la sección Firmas digitales para obtener detalles sobre cómo crear el hash. <request type="payer-new" timestamp="20030516175919"> <merchantid>tuiddecliente</merchantid> <orderid>idúnico</orderid> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 32

<payer type="empresa" ref="pérez01"> <title>sr</title> <firstname>juan</firstname> <surname>pérez Gómez</surname> <company>empresa</company> <address> <line1>c/monte del alto. 33. Madrid<line1> <line2 /> <line3 /> <city>madrid</city> <county>madrid</county> <postcode>28010</postcode> <country code="es">españa</country> </address> <phonenumbers> <home /> <work>00346665544</work> <fax> 00346665515</fax> <mobile>0034666554424</mobile> </phonenumbers> <email>jpgómez@correroelectrónico.com</email> <comments> <comment id="1" /> <comment id="2" /> </comments> </payer> <sha1hash>7daf026b193eb18344f5ab6822cd05959718c567</sha1hash> <comments> <comment id="1" /> <comment id="2" /> </comments> </request> 7.1.2 Sintaxis XML La siguiente tabla ofrece la información indicada a continuación para cada campo o elemento XML: La sintaxis para el elemento o campo TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 33

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 Sintaxis XML para configurar un nuevo pagador Elemento/campo M//C Formato Longitu d Descripción <request type="payer-new" timestamp="20030516175919"> M 0-9 14 El nombre de este tipo de solicitud es «payer-new». <merchantid>tuiddecliente</ merchantid> M a-z A-Z 0-9. 1-50 El ID de cliente que asignó TPV Virtual de Santander Elavon. <orderid>idúnico</orderid> a-z A-Z 0-9 _ - 1-40 Un ID único para identificar esta transacción. <payer type="empresa" ref="pérez01"> M a-z A-Z a-z A-Z 0-9 \ _ "" - 1-20 1-50 El tipo de pagador puede utilizarse para identificar la categoría «Pagador». Puede establecerse de forma predeterminada como «empresa». <title>sr.</title> <firstname>juan<firstname> <surname>pérez Gómez</surname> a-z A-Z 0-10 M a-z A-Z "" 1-30 M a-z A-Z "" - 1-50 La referencia del pagador es la referencia de este cliente y debe ser única. El tratamiento del pagador. Nombre del pagador. Apellidos del pagador. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 34

Elemento/campo M//C Formato Longitu d Descripción <company>empresa</company > a-z A-Z 0-9 "" 0-50 Nombre de la empresa. <address> Dirección del pagador. <line1>c/monte del alto. 33. Madrid</ line1> a-z A-Z 0-9 "" - /, 0-50 <line2>madrid </line2> a-z A-Z 0-9 0-50 "" - /, <line3> </line3> a-z A-Z 0-9 0-50 "" - /, <city>madrid</city> <county>madrid</county> 0 a-z A-Z "" - 0-20 a-z A-Z "" - 0-20 <postcode>28010</postcode> a-z A-Z 0-9 "" 0-8 <country code="es">españa </country> a-z A-Z 0-2 La lista de códigos de país está disponible en la TPV Virtual Santander Elavon: Guía de desarrollador- Remote </address> <phonenumbers> <home>00346665512</home> <work>00346665544</work> <fax>00346665515</fax> <mobile>0034666554424</ mobile> 0-9 + - 0-20 0-9 + - 0-20 0-9 + - 0-20 0-9 + - 0-20 Números de teléfono del pagador. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 35

Elemento/campo M//C Formato Longitu d Descripción </phonenumbers> <email> jpgómez@correroelectrónico.c om</email> a-z A-Z 0-9. @ - _ 0-50 Correo electrónico del pagador. <comments> a-z A-Z 0-9 "",. - / 0-30 Comentarios sobre el pagador. <comment id="1" /> a-z A-Z 0-9 0-255 ""., - _ + @!? $ <comment id="2" /> a-z A-Z 0-9 0-255 ""., - _ + @!? $ </comments> </payer> <sha1hash>7daf026b193e.59 597 18c567</sha1hash> <comments> M a-f 0-9 40 El hash SHA1 de este mensaje. Comentarios sobre esta transacción. <comment id="1" /> a-z A-Z 0-9 ""., - _ + @!? $ 0-255 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 36

Elemento/campo M//C Formato Longitu d Descripción <comment id="2" /> </comments> </payer> a-z A-Z 0-9 ""., - _ + @!? $ 0-255 7.1.3 Sintaxis de valor hash La siguiente tabla muestra la sintaxis de valor hash para la configuración de un nuevo pagador: Formato: timestamp.merchantid.orderid.amount.currency.payerref Ejemplo: 20030516175919.tuiddecliente.idúnico pérez01 7.2 Configuración del método de pago Una vez creado el pagador, puedes añadirle los métodos de pago que desees. Una vez más, este paso debe realizarse de forma manual (mediante la herramienta Información de gestión) o integrarse con los mensajes XML. Adición de detalles de la tarjeta de crédito Para añadir los detalles de una tarjeta de crédito o débito, debes utilizar la solicitud «cardnew». Las siguientes secciones proporcionan la información necesaria para añadir los detalles de una tarjeta de crédito o débito: Ejemplo Sintaxis XML Sintaxis de valor hash 7.2.1 Ejemplo <request type="card-new" timestamp="20030516181127"> <merchantid>tuiddecliente</merchantid> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 37

<orderid>idúnico</orderid> <card> <ref>visa01</ref> <payerref>pérez01</payerref> <number>498843******9991</number> <expdate>0115</expdate> <chname>juan Pérez Gómez</chname> <type>visa</type> <issueno /> </card> <sha1hash>4d708b24e3494bf80916ba3c8afd8347060fdd65</sha1hash> </request> Nota: Consulta la sección Firmas digitales para obtener detalles sobre cómo crear el hash. 7.2.2 Sintaxis XML La siguiente tabla ofrece la información indicada a continuación para cada campo o elemento XML: La sintaxis para el elemento o campo 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 Sintaxis XML para añadir detalles de la tarjeta de crédito Elemento/campo M//C Formato Longitud Descripción <request type="card-new" timestamp="20030516181127"> M 0-9 14 El nombre de este tipo de solicitud es «card-new». <merchantid>tuiddecliente</ merchantid> M a-z A-Z 0-9. 1-50 El ID de cliente que asignó TPV Virtual de Santander Elavon. TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 38

Elemento/campo M//C Formato Longitud Descripción <orderid>idúnico</orderid> a-z A-Z 0-9 _ - 1-40 Un ID único para identificar esta transacción. <card> M <ref>visa01</ref> M a-z A-Z 0-9 _ 1-30 La referencia para esta tarjeta. <payerref>pérez01</payerref> M a-z A-Z 0-9 _ 1-50 Si vas a añadir varias tarjetas, la referencia debe ser un valor único del registro del pagador, aunque no tiene por qué serlo en relación con otros pagadores. La referencia del pagador para este cliente. <number>4988433008499991</ number> M 0-9 12-19 El número de tarjeta del pagador. <expdate>0115</expdate> M 0-9 4 La fecha de caducidad de la tarjeta (MMAA). <chname>juan Pérez Gómez </chname> M a-z A-Z 0-9 - + "" ' 1-100 El nombre que aparece en la tarjeta. <type>visa</type> M Consulta la columna Detalles. N/A El tipo de tarjeta (consulta la TPV Virtual Santander Elavon: Guía de desarrollador-remote para conocer los diferentes tipos de tarjeta). </card> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 39

Elemento/campo M//C Formato Longitud Descripción <sha1hash>4d708b24e...8afd8 347060fdd65</sha1hash> M a-f 0-9 40 El hash SHA1 de este mensaje. </request> M 7.2.3 Sintaxis de valor hash La siguiente tabla muestra la sintaxis de valor hash para añadir detalles de la tarjeta de crédito: Formato: timestamp.merchantid.orderid.amount.currency.payerref.chname.(card)number Ejemplo: 20030516181127.tuiddecliente.idúnico pérez01.juanpérezgómez.498843******9991 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 40

8 XML de: Administración de pagadores Todas las solicitudes XML del servicio enviarse a la siguiente URL: de Almacenamiento Seguro de Tarjetas deben https://api.prueba.santanderelavontpvvirtual.es/vault Una vez configurado el pagador en el sistema de Almacenamiento Seguro de Tarjetas a través de los métodos Redirect (alojado) o Remote (integrado), pueden usarse los mensajes Remote XML para su administración. Esta sección describe las solicitudes XML necesarias para administrar los pagadores en el sistema. 8.1 Edición de un pagador existente Este tipo de solicitud se utiliza para editar los detalles de un pagador y debe contener la referencia original de este. La solicitud dispone de dos conjuntos de comentarios: el primero corresponde a los comentarios sobre el pagador y el segundo a los comentarios sobre la propia transacción de edición de este. Las siguientes secciones proporcionan la información necesaria para editar un pagador existente: Ejemplo Sintaxis XML Sintaxis de valor hash 8.1.1 Ejemplo Nota: Consulta la sección Firmas digitales para obtener detalles sobre cómo crear el hash. <request type="payer-edit" timestamp="20030516175919"> <merchantid>tuiddecliente</merchantid> <orderid>idúnico</orderid> <payer type="empresa" ref="pérez01"> <title>sr</title> <firstname>juan</firstname> <surname>pérez Gómez</surname> <company>empresa</company> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 41

<address> <line1>c/monte del alto. 33. Madrid</line1> <line2 /> <line3 /> <city>madrid</city> <county>madrid</county> <postcode>28010</postcode> <country code="es"> España </country> </address> <phonenumbers> <home /> <work> 00346665544</work> <fax> 00346665515</fax> <mobile> 0034666554424</mobile> </phonenumbers> <email>jpgómez@correroelectrónico.com</email> <comments> <comment id="1" /> <comment id="2" /> </comments> </payer> <sha1hash>7daf026b193eb18344f5ab6822cd05959718c567</sha1hash> <comments> <comment id="1" /> <comment id="2" /> </comments> </request> 8.1.2 Sintaxis XML La siguiente tabla ofrece la información indicada a continuación para cada campo o elemento XML: La sintaxis para el elemento o campo 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 42

Sintaxis XML para editar un pagador existente Elemento/campo M//C Formato Longitud Descripción <request type="payer-edit" timestamp="20030516175919"> <merchantid>tuiddecliente</ merchantid> <orderid>idúnico</orderid> M 0-9 14 M a-z A-Z 0-9 1-50. a-z A-Z 0-9 1-40 _ - El nombre de este tipo de solicitud es «payeredit». El ID de cliente que asignó TPV Virtual de Santander Elavon. Un ID único para identificar esta transacción. <payer type="empresa" ref="pérez01 > M a-z A-Z a-z A-Z 0-9 \ _ "" - 1-20 1-50 La referencia del pagador para este cliente. Debe ser única. <title>sr.</title> <firstname>juan</firstname> <surname>pérez Gómez</surname> a-z A-Z 0-10 M a-z A-Z "" 1-30 M a-z A-Z "" - 1-50 El tratamiento del pagador. Nombre del pagador. Apellidos del pagador. <company>empresa</company> a-z A-Z 0-9 0-50 Nombre de la empresa. "" <address> Dirección del pagador. <line1>c/monte del alto. 33. Madrid</ line1> a-z A-Z 0-9 "" - /, 0-50 <line2>plaza</line2> a-z A-Z 0-9 0-50 "" - /, <line3></line3> a-z A-Z 0-9 0-50 "" - /, <city>madrid</city> 0 a-z A-Z "" - 0-20 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 43

Elemento/campo M//C Formato Longitud Descripción <county>madrid</county> a-z A-Z "" - 0-20 <postcode>3</postcode> a-z A-Z 0-9 "" 0-8 <country code="es">españa </country> </address> <phonenumbers> <home>00346665512</home> <work>00346665544</work> <fax>00346665515</fax> <mobile>0034666554424</ mobile> </phonenumbers> a-z A-Z 0-2 0-9 + - 0-20 0-9 + - 0-20 0-9 + - 0-20 0-9 + - 0-20 La lista de códigos de país está disponible en la TPV Virtual Santander Elavon: Guía de desarrollador- Remote. Números de teléfono del pagador. <email>jpgómez@correroelectrónico. com</ email> a-z A-Z 0-9. @ - _ 0-50 Correo electrónico del pagador. <comments> a-z A-Z 0-9 "",. - / 0-30 Comentarios sobre el pagador. <comment id="1" /> a-z A-Z 0-9 0-255 ""., - _ + @!? $ TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 44

Elemento/campo M//C Formato Longitud Descripción <comment id="2" /> </comments> </payer> a-z A-Z 0-9 ""., - _ + @!? $ 0-255 <sha1hash>7daf026b193e.59597 18c567</sha1hash> <comments> M a-f 0-9 40 El hash SHA1 de este mensaje. Comentarios sobre esta transacción. <comment id="1" /> <comment id="2" /> </comments> </payer> a-z A-Z 0-9 ""., - _ + @!? $ a-z A-Z 0-9 ""., - _ + @!? $ 0-255 0-255 8.1.3 Sintaxis de valor hash La siguiente tabla muestra la sintaxis de valor hash para la edición de un pagador existente: Formato: timestamp.merchantid.orderid.amount.currency.payerref Ejemplo: 20030516175919.tuiddecliente.idúnico pérez01 TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 45

8.2 Actualización de detalles de tarjeta Para actualizar los detalles de una tarjeta almacenada (por ejemplo, la fecha de caducidad), debes utilizar la solicitud «card-update-card». En este punto, no se puede deshacer el proceso por lo que debes prestar especial atención. Requisitos obligatorios: Para sustituir la tarjeta existente con una nueva tarjeta, deberás proporcionar la siguiente información: Nuevo número de la tarjeta Tipo de tarjeta coincidente (se actualizará) Nombre del titular de la tarjeta (se actualizará) Fecha de caducidad (se actualizará) Número de emisión (opcional) Para actualizar la fecha de caducidad de la tarjeta existente, deberás proporcionar la siguiente información: Nueva fecha de caducidad Nombre del titular de la tarjeta (se actualizará) Tipo de tarjeta (si se desconoce, debes definir un valor) Para actualizar el nombre del titular de la tarjeta de la tarjeta existente, deberás proporcionar la siguiente información: Nuevo nombre del titular de la tarjeta Fecha de caducidad válida (se actualizará) Tipo de tarjeta (si se desconoce, debes definir un valor) Para actualizar el número de emisión de la tarjeta existente, deberás proporcionar la siguiente información: Nuevo número de emisión Nombre del titular de la tarjeta (se actualizará) Fecha de caducidad válida (se actualizará) Tipo de tarjeta (si se desconoce, debes definir un valor) TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 46

Las siguientes secciones proporcionan la información necesaria para enviar un tipo de solicitud «card-update-card» válido: Ejemplo de cada solicitud de actualización Sintaxis XML Sintaxis de valor hash 8.2.1 Sustituir la tarjeta existente con una nueva tarjeta <request timestamp="20091002153434" type="card-update-card"> <merchantid>tuiddecliente</merchantid> <card> <ref>visa01</ref> <payerref>pérez01</payerref> <number>4242424242424242</number> <expdate>0415</expdate> <chname>juan Pérez Gómez</chname> <type>visa</type> <issueno></issueno> </card> <sha1hash>4d708b24e 8afd8347060fdd65</sha1hash> </request> 8.2.2 Sintaxis de valor hash La siguiente tabla muestra la sintaxis de valor hash para la sustitución de una tarjeta existente con una tarjeta nueva: Formato: Timestamp.merchantID.payerref.ref.expirydate.cardnumber Ejemplo: 20030516175919.tuiddecliente.pérez01.visa01.0415.4242424242424242 8.2.3 Actualizar la fecha de caducidad o el nombre del titular de una tarjeta existente <request timestamp="20091002153434" type="card-update-card"> <merchantid>tuiddecliente</merchantid> <card> <ref>visa01</ref> <payerref>perez01</payerref> <expdate>0415</expdate> TPV Virtual Santander Elavon: Guía de desarrollador-almacenamiento seguro de tarjetas 47