ZEzeptopayments
Payouts

Payout finalised

Sent once a payout has reached its final status and will not change again. body.status is settled when the funds are available to the creditor, cancelled when the payout was cancelled, or failed with the reasons in body.errors. For a failed payout, any funds debited for it are back in the debtor's account by the time this is sent, so it is safe to retry the payout or arrange a fallback payment.

postWebhookpayments_payout.finalised

Payload

Example payload

{
  "data": {
    "uid": "payout-uid-123",
    "type": "payments_payout.finalised",
    "published_at": "2026-05-07T12:34:57Z",
    "metadata": {
      "order_id": "abc-123"
    },
    "body": {
      "status": "failed",
      "errors": [
        {
          "code": "ZIS99",
          "title": "Unknown Payment Error",
          "detail": "An unknown error occurred while processing the payment. Please contact Zepto for assistance."
        }
      ]
    }
  }
}

Response

Successfully received webhook.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.