Webhooks

Crear nueva suscripción

POST /v1/webhooks

Este endpoint permite suscribirse a notificaciones de Webhooks. Cuando te suscribes, recibirás notificaciones en una URL especificada y se utilizará una clave secreta para garantizar la seguridad de la comunicación. Para hacer esto, necesitas:

Crear un token secreto para el webhook y guarda el token de forma segura en tu servidor para poder acceder a él posteriormente y validar las notificaciones del webhook.

ℹ️

Este servicio permite crear más de una suscripción manteniendo todos esos webhooks conectados, utilizando difrentes urls, tipos y secrets según considere necesario. Recuerde que si tiene más de una suscripción al mismo url, recibirá más de un mensaje.

Es recomendable solo tener una suscripción, esta opcionalidad permite informar a mas de un sistema a la vez en caso de ser necesario.

ParámetrosDescripción
secret_key
  • string
  • Clave secreta para validar las firmas en las notificaciones de webhook. Debe contener como mínimo 8 caracteres, una mayúscula y un carácter especial
notification_url
  • string
  • URL donde se generará el evento de notificación
notification_type
  • array
  • Lista de tipos de eventos a los que deseas suscribirte
  • [OPERATION_CREATED, TAXED_OPERATION_CREATED]

Tipos de notificaciones

  • OPERATION_CREATED: Notificaciones sobre la creación de operaciones con datos básicos.
  • TAXED_OPERATION_CREATED: Notificaciones sobre la creación de operaciones con cálculos impositivos aplicados.
  curl --request POST \
    --url https://api.menta.global/api/v1/webhooks \
    --header 'Authorization: Bearer {access_token}' \
    --header 'Content-Type: application/json' \
    --data '{
      "secret_key": "string",
      "notification_url": "string",
      "notification_type": ["OPERATION_CREATED", "TAXED_OPERATION_CREATED"]
    }'
Obtener subscripcionesEliminar subscripción