---
search:
  tags:
    - Webhooks
    - POST
    - Webhook
seo:
  description: >-
    Sent when a settlement run starts and when it finishes, scheduled or
    started… Reference for the POST settlement.status_changed webhook in the
    iSmartPay API.
sidebar:
  label: settlement.status_changed
  badge: POST
title: settlement.status_changed
type: openapi-operation
---
Sent when a settlement run starts and when it finishes, scheduled or started with `POST /v1/settlements`. Check `outcome` on a `completed` run: `failed_partial` and `failed_all` can be retried with `POST /v1/settlements/{id}/resettlements`. Answer with any 2xx within 10 seconds. Anything else, a timeout or a redirect is retried up to 6 times over about a day. Events can arrive out of order, so compare statuses rather than trusting arrival order.

`POST settlement.status_changed`

**Webhook.** The API sends this request to your endpoint.