Tarjetas Éxito y Alkosto (Tuya)

¿Cómo funciona?

1. Se muestra como opción de pago Tarjeta Éxito y Tarjeta Alkosto, lo cual dependerá de que el comercio active estos medios de pago.
2. Una vez el usuario la selecciona el medio de pago y confirma la operación, debe consumirse el servicio para realizar la petición de la transacción.
3. Si la petición es exitosa se retorna la URL a la cual debe enviarse al cliente para que realice la operación en en medio de pago. En caso contrario se retorna el motivo del rechazo de la transacción.
4. Almacenar los datos de la transacción retornados por el servicio (identificador de la transacción, autorización, identificador sesión de placetopay).
5. Redirigir el navegador a la URL retornada en caso de exito.
6. Una vez la transacción retorna (retorna a la URL especificada en el consumo del crear transacción), se debe preguntar por el estado de la transacción mediante el consumo un servicio.
7. Dependiendo de la respuesta del servicio, la transacción puede haber sido aprobada, rechazada o seguir pendiente de procesamiento.
8. Informar al usuario el estado de la transacción.
9. Si la transacción está pendiente, o si el cliente al abandonar el portal no ha regresado, se debe tener una sonda que pregunte por el estado de la transacción.

Reingreso del cliente

Una vez el cliente ha finalizado la transacción en la interfaz del banco, el banco redirige al cliente a la URL especificada al crear la transacción, en este punto de entrada a su aplicativo, deberás consumir el servicio getTransactionInformation que permite determinar el estado de la transacción. Sólo si la transacción tiene estado OK, se debe a que fue autorizada. Por el contrario, si obtiene un estado PENDING, es porque aún no hay respuesta final del banco sobre la transacción.

Ya sea que el cliente retorne al punto de reingreso y que la transacción esté pendiente, o que haya abandonado la operación y haya roto el flujo normal, se deberá consumir el servicio getTransactionInformation para todas las operaciones que desde que fue invocado el createTransaction llevan más de 7 minutos sin un estado final de operación.

Confirmación y redirección al banco

Una vez se poseen los datos del pagador y comprador, así como la información de qué medio de pago usar deberá entonces consumir el servicio de createTransaction para obtener la URL a la cual deberá redirigir al cliente para finalizar la transacción.

Los datos solicitados para crear la transacción se requiere la dirección IP desde la cual el cliente está realizando la transacción, así como la información del navegador usado.  Si lo deseas, puedes proveer datos adicionales con la transacción, que permitirán tener esta información disponible en la consola administrativa.  Recuerda que el documento del pagador es el documento del dueño de la tarjeta y no podrá ser modificado posteriormente en la interfaz de Tuya para ese medio de pago.

Si la respuesta del servicio es SUCCESS, entonces debes almacenar la información retornada en tu base de datos, el transactionID es muy importante pues este es el identificador para consultar el estado final de la transacción.

Ten en cuenta que una respuesta SUCCESS en este punto sólo implica que la transacción ha sido aprovisionada por Tuya y está en espera que el cliente llegue a la interfaz del medio de pago, se autentique y autorice la operación iniciada.

Al crear la transacción, esta puede fallar; algunos motivos incluyen montos por fuera del rango permitido, no disponibilidad del medio de pago, problemas de configuración de la cuenta recaudadora, entre otros.  Utiliza la propiedad responseReasonText para obtener el por qué falló la creación de la transacción.  Algunos códigos no relacionados con el pagador pueden indicar que generes una alerta sobre problemas con la disponibilidad del servicio, particularmente los relacionados con mala configuración.

Una vez has almacenado la información en su base de datos y confirmado que es exitosa la petición, se redirigirá al cliente a la URL del medio de pago.  La redirección a la interfaz del medio de pago no debe realizarse en un frame o cualquier otro mecanismo que oculte la URL en la cual el cliente ingresará sus datos de autenticación.

Descripción de la interfaz del Webservice

A continuación, describimos los métodos que el webservice brinda. Las operaciones descritas a continuación son tipo petición – respuesta. Además, se describen cada una de las operaciones expuestas por el webservice y se muestran los parámetros de entrada a cada operación y vínculos a las estructuras de datos usadas.

$seed = date('c');

using System;
using System.Globalization;

String seed = DateTime.UtcNow.ToString("s",
System.Globalization.CultureInfo.InvariantCulture);

import java.util.Date;
import java.text.SimpleDateFormat;

Date now = new Date();
SimpleDateFormat isoDate = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssZ");
String seed = isoDate.format(now);

$hashString = sha1($seed  . $tranKey, false);

using System.Text;
using System.Security.Cryptography;

private string GetSHA1(string text)
{
	ASCIIEncoding UE = new ASCIIEncoding();
	byte[] hashValue;
	byte[] message = UE.GetBytes(text);
	SHA1 hashString = new SHA1CryptoServiceProvider();
	string hex = "";
	hashValue = hashString.ComputeHash(message);
	foreach (byte x in hashValue) {
		hex += String.Format("{0:x2}", x);
	}
	return hex;
}

string hashString = GetSHA1(seed + tranKey);

import java.security.MessageDigest;
import java.util.Formatter;

private static String byteToHex(final byte[] hash)
{
	Formatter formatter = new Formatter();
	for (byte b : hash)
	{
		formatter.format("%02x", b);
	}
	String result = formatter.toString();
	formatter.close();
	return result;
}

private static String GetSHA1(String password)
{
	String sha1 = "";
	try
	{
		MessageDigest crypt = MessageDigest.getInstance("SHA-1");
		crypt.reset();
		crypt.update(password.getBytes("UTF-8"));
		sha1 = byteToHex(crypt.digest());
	}
	catch(UnsupportedEncodingException e)
	{
		e.printStackTrace();
	}
	return sha1;
}

string hashString = GetSHA1(seed + tranKey);