> ## Documentation Index
> Fetch the complete documentation index at: https://api-reference.hyperswitch.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Outgoing Webhook

> The next retry of an invoice under Schedule Only Recovery, sent to the profile's webhook URL

Under Schedule Only Recovery, when a transaction made outside Hyperswitch is reported to [`POST /v2/recovery`](https://api-reference.hyperswitch.io/v2/revenue-recovery/revenue-recovery--create), Hyperswitch tells when to retry the invoice. After recording the transaction, it decides the invoice's next retry and sends it to the profile's webhook URL.

A transaction that doesn't change the next retry sends no webhook: for example, one made with the customer present, or a charge that recovers the invoice.

Each webhook has its own `event_id`, and the request is signed in the `X-Webhook-Signature-512` header, like every Hyperswitch outgoing webhook.

## Webhook body

**merchant\_id** `string` *required*

The provider merchant id (platform/business owner).

**event\_id** `string` *required*

The unique event id for each webhook.

**event\_type** `string` *required*

`recovery_retry_scheduled` or `recovery_limits_exhausted`.

**content** `object` *required*

**properties**

**type** `string` *required*

Always `recovery_retry_details`.

**object** `object` *required*

The next retry of the invoice. Every field is always present.

**properties**

**id** `string` *required*

Unique identifier of the invoice in Hyperswitch.

**merchant\_reference\_id** `string` *required*

Unique identifier of the invoice in the merchant's billing system.

**retry\_count** `integer` *required*

Number of the next retry, counted the way the `max_retry_count` of the profile counts them: the first retry after the original payment is 1.

**schedule\_time** `string | null` *required*

The time to trigger the retry at, then report its result through the recovery API. `null` when no retry is scheduled.

**reason** `string | null` *required*

Why no retry is scheduled: `retries_exhausted`, `grace_period_expired` or `hard_declined`. `null` when a retry is scheduled.

**timestamp** `string`

The time at which the webhook was sent.

**processor\_merchant\_id** `string | null`

The merchant id of the merchant account whose connector credentials are used for payment processing.

```json Webhook body theme={null}
{
  "merchant_id": "merchant_1234567890",
  "event_id": "evt_01a1d62a41b17a208968368ec06459d7",
  "event_type": "recovery_retry_scheduled",
  "content": {
    "type": "recovery_retry_details",
    "object": {
      "id": "12_pay_01a3868d94a471219b5c4bc71638e2zc",
      "merchant_reference_id": "invoice_mbabizu24mvu3mela5njyh",
      "retry_count": 1,
      "schedule_time": "2026-11-13T21:31:24.979Z",
      "reason": null
    }
  },
  "timestamp": "2026-11-13T18:27:35.985Z",
  "processor_merchant_id": "merchant_1234567890"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.