Home
Home
  1. Webhooks
  • Welcome
    • About Ontime
    • Overview
    • Test and Learn Projects
  • Authentication
  • Availability Check
    • Light Availability Check
      POST
    • Full Availability Check
      POST
  • Payment Management
    • Mandates
      • Create a new mandate
      • Cancel an existing mandate
      • Get a Mandate
      • Get many Mandates
    • Payment Requests
      • Instruct a new payment request
      • Cancel an existing payment request
      • Get a Payment
      • Get many Payments
  • Payouts
    • Get a Payout
      GET
    • Get Available Payouts
      GET
  • Webhooks
    • Mandate Created/Updated
    • Payment Request Created/Updated
    • Payout Created
  1. Webhooks

Mandate Created/Updated

Introduction#

The mandate.created and mandate.updated webhook notifies the biller when a mandate has been created or the details updated within Ontime. Updates to the mandate may occur when:
The status of the mandate changes e.g. the specified end date passes and the mandate is no longer active.
You cancel the mandate

🔹 Webhook Event Format#

All Ontime webhooks share a consistent structure with a top-level event object.
Webhook

WebhookMandatePayload

{
    "event_id": "8f3e1d97-1234-4abc-9876-abcdef123456",
    "event_type": "payment_request.updated",
    "event_timestamp": "2024-03-02T15:30:00Z",
    "payload": {
        "mandate_id": "12a3500a-eecf-47e2-8352-3a36693e84d9",
        "status": "Submitted"
    }
}
Previous
Webhooks
Next
Payment Request Created/Updated