Overview

Webhooks are a way for your application to receive real-time notifications when events occur in your account.

When an event occurs, we send an HTTP POST request to the webhook’s configured URL. You can use webhooks to trigger custom code, workflows, or integrations in your application.

Creating webhooks

You can create webhooks to subscribe to specific events that occur on JustPaid.

Kindly contact us to set them up.

Webhook Events

The following events can trigger a webhook:

INVOICE_PAYMENT_STATUS_CHANGE

When the status of an invoice payment changes to SCHEDULED, PROCESSED, SENT, NEED_ACTION, COMPLETED, FAILED, CANCELLED or VOIDED, we send a webhook event.

Example:

{
   "webhook_type": "INVOICE_PAYMENT_STATUS_CHANGE",
   "data": {
      "invoice_payment_uuid": "d0b1c4c0-4b1e-4b3e-8b4b-1f1d8b1d8b1d",
      "status": "PAID"
   }
}