Notificación

Contamos con un sistema de notificaciones, que permite a los comercios recibir notificaciones a través de una URL que ellos mismos configuran. Las notificaciones se envían en formato JSON y contienen información sobre el evento que ha ocurrido en el link asociado, permitiendo a los comercios tomar las acciones necesarias de manera automática.

Tipos de Notificaciones

Existen varios eventos que pueden disparar notificaciones, entre ellos:

• PAID: Se envía cuando un pago asociado al link ha concluido en estado Aprobado. Manejamos esta notificación para que el comercio este enterado de que ya puede consultar el link con el fin de verificar el pago y liberar el producto o servicio asociado.

  {
      "status": {
          "status": "PAID",
          "reason": 200,
          "message": "Tienes una transacción en estado aprobado",
          "date": "2024-06-25T00:43:21-05:00"
      },
      "linkId": 2,
      "reference": "#5321",
      "signature": "e1ab3b5d25dd2c81c3386a2e4c3a2818911e5d09f012005c21f8e20c6e0d5ab6"
  }
  

  CopyCopied!

• EXPIRED: Se envía cuando un link de pago ha expirado. Es importante que el comercio esté al tanto de que su link de pago ya no recibirá más pagos y, según esto, tome acciones como generar un nuevo link de pago.

  {
      "status": {
          "status": "EXPIRED",
          "reason": 200,
          "message": "El link ha caducado.",
          "date": "2024-06-25T00:53:36-05:00"
      },
      "linkId": 2,
      "reference": "#5321",
      "signature": "a02e7afa8f8313ccaa29edf056bc95a243671ec5e995c0dac5953c17f8bc529f"
  }
  

  CopyCopied!

Aunque estos son los eventos más comunes, es posible que en el futuro se agreguen más eventos que disparen notificaciones.

Seguridad de las Notificaciones

Para garantizar la seguridad de las notificaciones, cada notificación incluye una firma digital que permite al comercio verificar la autenticidad de la notificación. La firma se genera a partir de la información de la notificación y la secretKey del comercio.

La firma se envía en el campo signature de la notificación. Para verificar la firma, el comercio debe seguir los siguientes pasos:

1. Concatenar los valores de los campos de la notificación en el siguiente orden: linkId, status, date, secretKey.
2. Calcular el hash SHA-256 de la cadena resultante.
3. Comparar la firma generada con la firma recibida en la notificación.

Aqui hay un ejemplo de cómo se vería el proceso de verificación de la firma en un lenguaje de programación:

$secretKey = "mySiteSecretKey";

$notification = [
    "status" => [
        "status" => "PAID",
        "reason" => 200,
        "message" => "Tienes una transacción en estado aprobado",
        "date" => "2024-06-25T00:43:21-05:00"
    ],
    "linkId" => 2,
    "reference" => "#5321",
    "signature" => "e1ab3b5d25dd2c81c3386a2e4c3a2818911e5d09f012005c21f8e20c6e0d5ab6"
];

$string = sprintf(
    '%s%s%s%s',
    $notification['linkId'],
    $notification['status']['status'],
    $notification['status']['date'],
    $secretKey
);

$signature = hash('sha256', $string);

if ($signature === $notification['signature']) {
    // La notificación es auténtica
} else {
    // La notificación no es auténtica
}

Si las firmas coinciden, la notificación es auténtica y el comercio puede confiar en la información recibida. En caso contrario, la notificación no es auténtica y el comercio debe ignorarla.