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_Merchat_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_Tex: 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.

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 a titular.
SIS0325 Paygold ya finalizado o no existe fase inicial.
SIS0487 El comercio terminal no tiene habilitado el método de pago Paygold.