Mono uses Webhooks to communicate updates on transaction objects initiated with the API and kick off additional workflows based on these events. Each time an event that you listen to occurs, Mono submits a POST request to the designated Webhook URL with information about the event transactions.

Your endpoint should respond to webhooks as quickly as possible. To acknowledge receipt of a webhook, your endpoint must return a 2xx HTTP status code. This status code should only indicate receipt of the message, not acknowledgment that it was successfully processed by your system. Any other information returned in the response headers or response body is ignored.


All Webhook requests are sent with a mono-webhook-secret header for verification. It should match the secret you passed when creating the webhook.


In a case where Mono was unable to reach the URL, all the Webhooks will be retried.

Also, all Webhook URLs must respond with a status 200 OK or the the request will be considered unsuccessful and retried.

Did this page help you?