PSE

¿Cómo Funciona?

1. El usuario visualiza y selecciona PSE una opción de pago, que son débitos a cuentas de ahorro y corriente en Colombia.
2. Luego se presenta la lista de bancos, que debe estar cacheada localmente y su refrescamiento debe ser una vez por día, y el tipo de banca a desplegar: personas o empresas.
3. Al tiempo que el cliente confirma la operación, debe consumirse el servicio para realizar la petición de la transacción.
4. Si la petición es exitosa, se retorna la URL a la cual debe enviarse al cliente para que realice la operación en el banco. En caso contrario, se muestra el motivo del rechazo de la transacción.
5. Se almacenan los datos de la transacción retornados por el servicio (identificador de la transacción, autorización/cus, identificador sesión de Place to Pay).
6. Se redirige el navegador a la URL retornada en caso de éxito.
7. Una vez la transacción retorna (retorna a la URL especificada en el consumo de la transacción), se debe preguntar por el estado de la transacción mediante el consumo un servicio.
8. Dependiendo de la respuesta del servicio, la transacción puede haber sido aprobada, rechazada o seguir pendiente de procesamiento.
9. Informa al usuario el estado de la transacción.
10. 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.

Despliegue de bancos disponibles

Una vez el cliente ha decidido pagar con débito a una cuenta corriente o de ahorros, verá la lista de los bancos que en el momento están disponibles para la transacción.  Esta lista se obtiene mediante el consumo del método getBankList, el cual debe ser consumido una vez por día, lo que exige que esté disponible un mecanismo de caché que permita recuperar la lista si ya ha sido consumido el servicio en el día. Simultáneamente, el usuario también debe indicar qué tipo de persona es si natural o jurídica.

Si por algún motivo la lista de bancos no pudo ser obtenida, debe mostrarse un mensaje de “no se pudo obtener la lista de entidades financieras, por favor intente más tarde” y, consumir nuevamente el servicio de lista de bancos y poderla almacenar en el caché.

Ten presente que en operaciones de Multicrédito debes utilizar su código de servicio y que siempre deberá pasar todas las cuentas dependientes (entidad, servicio) para los créditos así algunas de ellas vayan con valores en cero.  Es requerido que la lista de créditos corresponda con todos los subcódigos dependientes.

Confirmación y redirección al banco

Una vez se poseen los datos del pagador y comprador, así como el nombre e interfaz del banco, se 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 requieren la dirección IP desde la cual el cliente está realizando la transacción, así como la información del navegador usado. Si deseas, puedes proveer datos adicionales con la transacción que permitirán tener esta información disponible en la consola de consulta de transacciones de Place to Pay.

Si la respuesta del servicio es SUCCESS, entonces se deberá almacenar la información retornada en tu base de datos, especialmente el transactionID pues es con este identificador que podrá 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 el banco y está en espera que el cliente llegue a la interfaz del banco, 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 banco, problemas de configuración de la cuenta recaudadora, entre otros.  Utiliza la propiedad responseReasonText para obtener el mensaje de por qué falló la creación de la transacción.  Algunos códigos no relacionados con el pagador pueden indicarle que genere una alerta sobre problemas con la disponibilidad del servicio, particularmente los relacionados con mala configuración.

Una vez has almacenado la información en tu base de datos y confirmado que es exitosa la petición, se redirigirá al cliente a la URL del banco. La redirección a la interfaz del banco 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

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 tu aplicación, deberás consumir el servicio getTransactionInformation que determine el estado de la transacción.  Solo si la transacción tiene como estado OK es porque la transacción fue autorizada, si por el contrario obtiene un estado PENDING es porque aún no tiene respuesta final del banco acerca de 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.

Descripción de la interfaz del Webservice

Aquí describimos los métodos que el webservice brinda. Las operaciones descritas a continuación son tipo petición – respuesta 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);