---
title: "Payout finalised"
method: POST
path: "payments_payout.finalised"
tags: ["Payouts"]
---

# Payout finalised

`POST payments_payout.finalised` (webhook)

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.

## Payload

- PaymentsPayoutFinalisedWebhook
  - `data` object, required
    - `uid` string, required: The unique identifier supplied at payout creation time
    - `type` 'payments_payout.finalised', required: The type of event that triggered the webhook delivery
    - `published_at` string, date-time, required: When the event was published by Zepto
    - `metadata` object, required: Merchant-attached metadata supplied at payout creation time
    - `body` object, nullable, required: Event-specific details. Null for events that carry no extra detail.
      - `status` 'settled' | 'failed' | 'cancelled', required: The payout's final status
      - `errors` PaymentsError[], required: The reasons the payout failed. Empty unless `status` is `failed`.
        - `code` string, required: A code identifying the error
        - `title` string, required: A short summary of the error
        - `detail` string, required: A detailed explanation of the error
        - `data` object: Additional data about the error, such as validation errors keyed by field name
        - `links` object
          - `about` string, required: A link to relevant documentation

## Acknowledgement `200`

Successfully received webhook.

---

[API](https://skmtc.dev/zeptopayments/apis/zepto-payments-api.md) - [All operations](https://skmtc.dev/zeptopayments/apis/zepto-payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeptopayments/apis/zepto-payments-api/revisions/1b8fcb07a70b?raw)