Proceso de Notificación

Notificación

Una notificación será enviada cada vez que cambie el status de un retiro.

Por razones de seguridad no enviamos el estado del retiro en la notificación. Una vez que enviamos la notificación, puede ser sacada utilizando el Endpoint de Estado de Retiro.

Las notificaciones serán enviadas a la notification_url en el request, o por de default en la "URL de Retiros" que está configurada en su panel vía POST protocolo en el formato x-www-form-urlencoded.

Testing en Staging

En el entorno STG, puede forzar que se envíe una notificación a su URL de notificación desde el Panel de Comerciantes de STG yendo a la página Transacciones -> Retiros, abriendo la transacción de retiro y haciendo clic en una de las opciones que aparecerán al hacer clic en el botón de tres puntos en la parte superior derecha de la pantalla. Esas opciones cambiarán el estado del retiro y enviarán la notificación respectiva después de unos minutos.

Respuesta de la notificación

    date=2020-03-12%2020%3A26%3A11
    &bank_reference_id=
    &comments=
    &external_id=cashoutV35381
    &control=A4CFF64E78C4BD01F8BFCA4AFF04632EC4A33CC61BD6BBD156BA1289897892EB
    &cashout_id=60067
    &status_reason=

Campo	Formato	Descripción
date	Fecha. Formato: YYYY-MM-DD HH:MM:SS (GMT)	Fecha que el retiro cambio su estado
bank_reference_id	string	(max length 50) Id de referencia del banco (si aplica)
comments	string	(max length 200) Comentarios (si aplica)
external_id	string	(max length 100) ID del retiro que enviaron al crearlo
control	string	Control signature de la notificacion
cashout_id	number	ID del retiro de nuestro lado
status_reason	string	Razon del estado (si aplica)

El control string de las notificaciones está compuesto por caracteres aleatorios al principio y al fin del request, y la external_id recibido en el medio.

El control string debería ser generado utilizando su secret key (API Signature) y debe estar en mayúsculas.

Asegurarse de convertir el mensaje a hash en formato UTF-8 para prevenir errores.

Ejemplos:

JAVA

public static void main(String[] args) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
      String external_id = "cashoutID1234";
      String message = "Be4" + external_id + "Bo7";
      String apiSignature = "your_deposits_api_signature";

      Mac hasher = Mac.getInstance("HmacSHA256");
      hasher.init(new SecretKeySpec(apiSignature.getBytes(StandardCharsets.UTF_8), "HmacSHA256"));
      byte[] result = hasher.doFinal(message.getBytes(StandardCharsets.UTF_8));

      System.out.println(StringUtils.upperCase(DatatypeConverter.printHexBinary(result)));
}

PHP

$external_id = 'cashoutID1234';
$message = 'Be4' . $external_id . 'Bo7';
$api_signature = 'cashout_api_signature';

$hash = strtoupper(hash_hmac('sha256', pack('A*', $message), pack('A*', $api_signature)));

C#

 string external_id = "cashoutID1234";
 string message = "Be4" + external_id + "Bo7";
 string apiSignature = "your_cashouts_api_signature";
 
 byte[] keyByte = new System.Text.Encoding.UTF8.GetBytes(apiSignature);
 byte[] messageBytes = new System.Text.Encoding.UTF8.GetBytes(message);
 byte[] hashmessage = new HMACSHA256(keyByte).ComputeHash(messageBytes);

 string control = BitConverter.ToString(hashmessage).Replace("-", "").ToUpper();

Lógica de Reintentos y Reenvió de Notificaciones

Logica de reintentos

Cada vez que el estado del retiro cambie, enviaremos una notificación con este cambio.

En caso de que su servidor no pueda recibir la notificación, y fue devuelto un código HTTP code diferente a 2XX, se reintentará enviar la notificación 5 veces o hasta que un código HTTP 2XX sea presente, lo que pase primero.

En caso de errores, asegúrense de que la notificación enviada sea distinta a una con código HTTP 2XX, así se reintenta automáticamente.

Reenviar notificaciones.

En caso de que su sistema no pudo recibir la notificación correcta luego de 5 intentos, se podrá realizar manualmente.

Esto se puede realizar yendo al merchant panel, elegir el retiro (transacciones --> Retiros), y hacer click en los 3 puntos arriba a la derecha del estado de la notificación, y tocar "reenviar notificación".

La notificación puede tardar hasta 2 minutos en ser reenviada.