DESARROLLADORES

Aquí encontrarás todo lo necesario para integrar nuestra pasarela de pago de forma rápida y sencilla

Selecciona la opción a consultar:

PAGO POR MAIL/SMS (PAYGOLD)

Paygold se trata de un tipo de pago en el cual el comercio puede realizar un envio, mediante SMS o correo electronico, 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.

Introduccion

Este tipo de pago consta basicamente de dos fases.

  • Primera fase: En esta fase el comercio conecta con el SIS y solicita realizar un pago Paygold. En esta peticion el comercio deberá indicar el numero de telefono o el correo electronico al que se desea enviar la URL posteriormente. Tras recibir esa solcitud, el SIS 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 WebService o bien mediante el módulo 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

Descripción general del flujo

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 (Tipo de operación PayGold mediante la conexión WebService). 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 estará limitado por el TPV virtual según configuración.

  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 SIS solicita autorización a la entidad emisora por los circuitos tradicionales de medios de pago.

  7. Opcionalmente, el TPV virtual SIS 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.

Paygold desde el módulo de administración

Si la entidad le ha dado al usuario del comercio el permiso necesario, se podrán realizar operaciones PayGold desde el módulo de administración.

paygold módulo
  1. El usuario del comercio deberá simplemente completar toda la información para procesar el pago.

Paygold vía WebService

Para realizar este tipo de operacion via WebService, es preciso que el comercio realice una peticion al SIS. Tras realizar esta peticion, el SIS realizará las validaciones necesarias y en funcion de estas validaciones construirá un documento XML de respuesta que posteriormente devolverá al comercio

Para realizar esta peticion WebService es preciso indicar algunos campos que se muestran a continuacion:

DS_MERCHANT_TRANSACTIONTYPE = "F": Este campo indica que el tipo de operacion es Paygold.

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.

Ejemplo:

					
<REQUEST>
	<DATOSENTRADA>
		<DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT>
		<DS_MERCHANT_ORDER>1453971987</DS_MERCHANT_ORDER>
		<DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE>
		<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>
		<DS_MERCHANT_MERCHANTURL>
			http://comercio.es/notificacion
		</DS_MERCHANT_MERCHANTURL>
		<DS_MERCHANT_TERMINAL>1</DS_MERCHANT_TERMINAL>
		<DS_MERCHANT_CUSTOMER_MOBILE>
			XXXXXXXXX
		</DS_MERCHANT_CUSTOMER_MOBILE>
		<DS_MERCHANT_CUSTOMER_MAIL>
			Email.prueba@redsys.es
		</DS_MERCHANT_CUSTOMER_MAIL>
		<DS_MERCHANT_TRANSACTIONTYPE>F</DS_MERCHANT_TRANSACTIONTYPE>
		<DS_MERCHANT_P2F_XMLDATA>				
		<![CDATA[<nombreComprador>James</nombreComprador><subjectMailCliente>para 
		completar su compra pinche en el enlace</subjectMailCliente>]]>
		</DS_MERCHANT_P2F_XMLDATA>
	</DATOSENTRADA>
	<DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIGNATUREVERSION>
	<DS_SIGNATURE>
		Y+El8TJEKmFbyMLk30X/R0I1HE/1l2J2S8fWvJ33/U0=
	</DS_SIGNATURE>
</REQUEST>

					
					
					

Tras el envio de la solicitud de pago Paygold por parte del comercio, el SIS realiza las validaciones pertinentes y construye un documento XML con el siguiente aspecto:

					
					
<RETORNOXML>
	<CODIGO>0</CODIGO>
	<OPERACION>
		<Ds_Amount>145</Ds_Amount>
		<Ds_Currency>978</Ds_Currency>
		<Ds_Order>1453971987</Ds_Order>
		<Ds_Signature>
			0QY3dqPGU/69L8y5sA2XrqizqjLoO0fjRrb33oMY210=
		</Ds_Signature>
		<Ds_MerchantCode>999008881</Ds_MerchantCode>
		<Ds_Terminal>1</Ds_Terminal>
		<Ds_Response>9998</Ds_Response>
		<Ds_AuthorisationCode></Ds_AuthorisationCode>
		<Ds_TransactionType>F</Ds_TransactionType>
		<Ds_SecurePayment>0</Ds_SecurePayment>
		<Ds_Language>1</Ds_Language>
		<Ds_MerchantData></Ds_MerchantData>
		<Ds_UrlPago2Fases>
			http://sis-d.redsys.es/sis/p2f?t=B8792FD81101EDE46101FC154918EFDD0FDE4CD7
		</Ds_UrlPago2Fases>
	</OPERACION>
</RETORNOXML>


					
					
					

Catálogo de Errores

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.