Efectivo

Consulta de una cuenta pendiente de pago

Los servicios expuestos permiten la consulta de una o varias cuentas pendientes de pago, básicamente dependiendo del servicio usado. Para ello, tu desarrollo debe contar con una interfaz de captura de datos que sirven para cada consumo. Debido a que el servicio está pensado para atender a múltiples comercios, se deberá parametrizar cada establecimiento para determinar qué consultas son soportadas y cual es el significado del dato.

Así que en la configuración de cada establecimiento deberá ir:

• El login que lo identifica en Place to Pay
• La llave transaccional (tranKey) que lo identifica en Place to Pay
• Si soporta consulta por referencia y el significado de la referencia para ese establecimiento (factura, cuenta de cobro, etc.).
• Si soporta consulta por documento del deudor.
• Si soporta consulta por código del deudor y su significado el código para el establecimiento (Código de estudiante, Placa, Número de póliza, etc.).
• La frecuencia de reintento de notificación ante una falla.

Tenga en cuenta que las consultas por documento del deudor y por el código del deudor están pensadas para retornar múltiples registros de cobro, así que su desarrollo si soporta estos métodos tendrá que dar la posibilidad de presentar las diferentes deudas y que el cliente pagador determine cuál o cuales va a pagar.

Si el valor retornado como deuda para alguno de las consultas es cero, se entenderá que el valor a recaudar es abierto y no cerrado. Sin embargo será el proyecto el que defina si el valor a recaudar es o no alterable por el cajero.

Asiento de un pago

Independiente del servicio usado para obtener las cuentas pendientes de pago. En el momento de indicar a Place to Pay un recaudo, se deberá consumir el servicio para una referencia en particular.  Es decir que si en un momento en una sola transacción recaudas más de una referencia, en el asiento deberá hacer tantos consumos como referencias haya recaudado.

El asiento del pago se entiende como una tarea asincrónica o al menos no bloqueante.  Esto implica que cuando realizas el recaudo, invocas al servicio de Place to Pay para notificar de la operación, sin embargo si el servicio no está disponible o hay una falla de telecomunicaciones o el estado de la notificación no es exitoso; puedes reintentar posteriormente la notificación sin tener que retrasar la operación en taquilla.

Los reintentos de notificación de pago pueden hacerse cada 30 minutos o lo que se establezca en la parametrización particular y dependiendo del volumen de información manejada.  De igual manera como recurso final, al terminar el día se puede intercambiar un archivo de recaudo que sirve para conciliar los asientos realizados.

Descripción de la interfaz del Webservice

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

Tipos de datos o estructuras

En este apartado se describen cada una de las estructuras de datos usadas por los métodos del Webservice.

Estados retornados por el servicio

A continuación se enuncian los diferentes códigos de estado que se retornan en la respuesta de las peticiones a los diferentes métodos.

Ejemplos

A continuación se muestran algunos ejemplos de generación de una fecha en formato ISO 8601 y de la generación del hash en SHA1.

$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);