PAGO POR MAIL/SMS (PAYGOLD)

Paygold es un tipo de pago en el cual el comercio realiza un envío, mediante SMS o correo electrónico a sus clientes de una URL de pago. Una vez los clientes hayan recibido esta URL, unicamente deben acceder e introducir sus datos de tarjeta para realizar el pago.

Funcionamiento

Este tipo de pago consta basicamente de dos fases.

  • Primera fase: En esta fase el comercio conecta con el TPV-Virtual y solicita realizar un pago Paygold. En esta peticion el comercio deberá indicar el número de teléfono o el correo electronico al que se desea enviar la URL posteriormente. Tras recibir esa solcitud, el TPV-Virtual almacenará la peticion. y enviará al titular el SMS o correo electronico con la URL.

    El comercio podrá realizar la solicitud de pago Paygold mediante peticion REST o bien mediante el portal de administración.

  • Segunda fase: En esta segunda fase, el titular procede a realizar el pago mediante la URL facilitada. Dentro de esta URL el titular procederá a introducir los datos de tarjeta y a realizar su autenticacion si es necesario.

El flujo general que realiza un pago Paygold es el siguiente:

  1. El usuario del comercio solicita el pago de una determinada cantidad a través del TPV virtual. En esta petición se envía el número de teléfono del titular o la dirección de e-mail según el caso.
  2. El TPV virtual envía un SMS (o e-mail) con un link al titular de la tarjeta.
  3. El titular pulsa en el link y se conecta al TPV virtual para introducir los datos de pago (tarjeta, caducidad y cvv2). El tiempo de validez de una operación no está limitado, pero es posible configurar el tiempo de validez que tiene el cliente para realizar el pago.
  4. El TPV virtual contacta con la entidad financiera que ha emitido dicha tarjeta.
  5. Si así lo tiene establecido, la entidad emisora solicita autenticación al titular de la tarjeta.
  6. El TPV virtual solicita autorización a la entidad emisora por los circuitos tradicionales de medios de pago.
  7. Opcionalmente, el TPV virtual envía una notificación On-Line al servidor del comercio con el resultado de la operación.
  8. Por último, el TPV virtual SIS muestra el recibo de la operación al titular de la tarjeta.

Parámetros PayGold

Para realizar este tipo de operación vía REST, es preciso que el comercio realice una peticion al TPV-Virtual. Tras realizar esta peticion, el TPV-Virtual realizará las validaciones necesarias y en función de estas validaciones enviará un mensaje de respuesta al comercio.

Para utilizar esta funcionalidad, es preciso indicar algunos campos que se muestran a continuacion:

  • Ds_Merchant_TransactionType: Este campo indica que el tipo de operacion es Paygold, el valor del parámetro es "F".
  • Ds_Merchant_Customer_Mobile: Para informar el número de teléfono del titular para enviar el SMS con el enlace.
  • Ds_Merchant_Customer_Mail: Para informar la dirección de mail del titular para enviar el enlace.
  • Ds_Merchant_P2F_ExpiryDate: Permite especificar la fecha de caducidad del enlace siendo posible especificar la fecha de cada operación mediante este parámetro. El valor del campo podrá ser el número de minutos desde la operación o la fecha y hora exacta de caducidad con el siguiente formato: aaaa-mm-dd-HH.MM.ss.sss (por ejemplo 2014-08-06-16.31.35.318).
  • Ds_Merchant_Customer_Sms_Text: Personalización de los mensajes SMS enviados al usuario. Este campo contendrá una cadena de texto con los campos relevantes entre arrobas, es obligatorio incluir siempre la URL (@URL@). Los datos entre arrobas se sustituiran por los valores correspondientes.
  • Ds_Merchant_P2F_XMLData: Personalización de los mensajes de correo enviados. Dicho campo permite pasar TAGs para la personalización. Es importante escapar los símbolos <> y / por su codigo html correspondiente así como dejarlos dentro del CDATA. Los campos que incluye este parámetro son:
    • nombreComprador: El nombre del comprador. Sin limitación de caracteres.
    • direccionComprador: La dirección del comprador. Sin limitación de caracteres.
    • textoLibre1: El texto que se incluirá describiendo la compra. Sin limitación de caracteres.
    • subjectMailCliente: Asunto del e-mail personalizado.
La petición al TPV virtual SIS se realizará mediante un envío de peticiones REST a las siguientes direcciones en función del entorno de trabajo:

Entorno URL conexión
Pruebas https://sis-t.redsys.es:25443/sis/rest/trataPeticionREST
Real https://sis.redsys.es/sis/rest/trataPeticionREST

Petición REST


Ejemplo del valor de Ds_MerchantParameter sin codificar para una petición PayGold vía REST:

							
	{
	  "DS_MERCHANT_AMOUNT": "145",
	  "DS_MERCHANT_CURRENCY": "978",
	  "DS_MERCHANT_CUSTOMER_MAIL": "Email.prueba@redsys.es ",
	  "DS_MERCHANT_CUSTOMER_MOBILE": "666555444",
	  "DS_MERCHANT_MERCHANTCODE": "999008881",
	  "DS_MERCHANT_MERCHANTURL": "http://comercio.es/notificacion",
	  "DS_MERCHANT_ORDER": "1453971987",
	  "DS_MERCHANT_P2F_XMLDATA": {
			"<nombreComprador>NOMBRE DEL COMPRADOR</nombreComprador><direccionComprador>DIRECCION DEL COMPRADOR</direccionComprador><textoLibre1>TEXTO LIBRE</textoLibre1><subjectMailCliente>ASUNTO EMAIL</subjectMailCliente>"},
	  "DS_MERCHANT_TERMINAL": "999",
	  "DS_MERCHANT_TRANSACTIONTYPE": "F"
	}

Tras el envio de la solicitud de pago Paygold por parte del comercio, el SIS realiza las validaciones pertinentes y se recibirá la respuesta:

										
	{
	  "Ds_Amount": "145",
	  "Ds_AuthorisationCode": "",
	  "Ds_Currency": "978",
	  "Ds_Language": "1",
	  "Ds_MerchantCode": "999008881",
	  "Ds_MerchantData": "",
	  "Ds_Order": "1453971987",
	  "Ds_Response": "9998",
	  "Ds_SecurePayment": "0",
	  "Ds_Terminal": "1",
	  "Ds_TransactionType": "F",
	  "Ds_UrlPago2Fases": "http://sis-d.redsys.es/sis/p2f?t=B8792FD81101EDE46101FC154918EFDD0FDE4CD7"
	}

Errores específicos

El tipo de pago Paygold tiene asociados una serie de codigos de error que devolverá el SIS en caso de que todo no se lleve a cabo correctamente. Estos codigos de error son:

  • SIS0324: Imposible enviar link al titular.
  • SIS0325: Paygold ya finalizado o no existe fase inicial.
  • SIS0487: El comercio terminal no tiene habilitado el método de pago.

Paygold + Generación de Referencia

Desde una operación PayGold se podrá generar una referencia asociada a los datos de tarjeta utilizado en el pago. El comercio deberá solicitar la generación de la referencia en el momento de enviar la petición de envío de enlace PayGold.

Integración REST.
Si el comercio utiliza la integración REST para solicitar el envío de un enlace PayGold, deberá añadir el parámetro de solicitud de generación de referencia en la petición Ds_Merchant_Identifier="REQUIRED".


Parámetro "Ds_MerchantParameters" para una devolución:

				 	
{
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_CVV2": "123",
  "DS_MERCHANT_EXPIRYDATE": "3912",
  "DS_MERCHANT_IDENTIFIER": "REQUIRED",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "0281WjRq",
  "DS_MERCHANT_PAN": "4548810000000003",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "F"
}

Respuesta de la petición de generación de referencia de PayGold:

				 					
	
{
  "Ds_Amount": "145",
  "Ds_AuthorisationCode": "630117",
  "Ds_CardNumber": "454881******0003",
  "Ds_Card_Brand": "1",
  "Ds_Card_Country": "724",
  "Ds_Currency": "978",
  "Ds_ExpiryDate": "3912",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_Merchant_Identifier": "01903f9b923895767228066924f23b5892e88fdb",
  "Ds_Order": "0281WjRq",
  "Ds_Response": "0000",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "F"
}

Para poder recibir la referencia una vez generada, el comercio deberá tener configurado el envío de notificación on-line. Si el comercio desea ser él mismo quien envíe el mail o SMS con el enlace de PayGold, podrá indicarlo en la solicitud REST de forma que el TPV Virtual generará el enlace, pero no enviará SMS ni mail.

Vista del apartado PayGold en el módulo de administración de TPVV.

"Vista del apartado PayGold en el módulo de administración de TPVV."

PayGold + Pago con Referencia

El comercio podrá informar el valor de una referencia en el momento de enviar la petición de envío de enlace de PayGold. En este caso cuando el titular pulse el enlace ya no será necesario que introduzca los datos de la tarjeta para realizar el pago, se procederá directamente a solicitar la autorización en función de la configuración del comercio.

Integración REST.
Si el comercio utiliza la integración REST para solicitar el envío de un enlace de PayGold con referencia, deberá añadir el parámetro Ds_Merchant_Identifier con la referencia asociada a los datos de pago.