# Paystack webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/paystack/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill paystack-webhooks` ([details](https://hookdeck.com/webhooks/paystack/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Paystack's official docs](https://paystack.com/docs/payments/webhooks/).

[Overview](https://hookdeck.com/webhooks/paystack) · [Webhook events (35)](https://hookdeck.com/webhooks/paystack/events) · [MCP events](https://hookdeck.com/webhooks/paystack/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/paystack/verify) · [Production guide](https://hookdeck.com/webhooks/paystack/guide-duplicates-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/paystack/skill)

## charge

### charge.dispute.create

Confidence: documented · Schema: from Paystack docs (example)

Customer opens a dispute against your business

Identified by: event field in the body · Object: `charge`

```json
{
  "event": "charge.dispute.create",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-create.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-create.json)

### charge.dispute.remind

Confidence: documented · Schema: from Paystack docs (example)

Open dispute still hasn't been resolved

Identified by: event field in the body · Object: `charge`

```json
{
  "event": "charge.dispute.remind",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-remind.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-remind.json)

### charge.dispute.resolve

Confidence: documented · Schema: from Paystack docs (example)

Dispute reaches a resolution

Identified by: event field in the body · Object: `charge`

```json
{
  "event": "charge.dispute.resolve",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-resolve.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-dispute-resolve.json)

### charge.failed

Confidence: documented · Schema: No payload yet

Charge attempt fails

Identified by: event field in the body · Object: `charge`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-failed.json)

### charge.success

Confidence: documented · Schema: official schema

Charge completes successfully

Identified by: event field in the body · Object: `charge`

```json
{
  "event": "charge.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/charge-success.json)

## invoice

### invoice.create

Confidence: documented · Schema: from Paystack docs (example)

Subscription invoice is raised, usually three days before the charge

Identified by: event field in the body · Object: `invoice`

```json
{
  "event": "invoice.create",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-create.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-create.json)

### invoice.payment_failed

Confidence: documented · Schema: official schema

Payment attempt on an invoice fails

Identified by: event field in the body · Object: `invoice`

```json
{
  "event": "invoice.payment_failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-payment-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-payment-failed.json)

### invoice.update

Confidence: documented · Schema: from Paystack docs (example)

Invoice changes, usually after a successful charge

Identified by: event field in the body · Object: `invoice`

```json
{
  "event": "invoice.update",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-update.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/invoice-update.json)

## preauthorization

### preauthorization.capture.failed

Confidence: documented · Schema: official schema

Capturing a preauthorized amount fails

Identified by: event field in the body · Object: `preauthorization`

```json
{
  "event": "preauthorization.capture.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-failed.json)

### preauthorization.capture.success

Confidence: documented · Schema: official schema

Preauthorized amount is captured

Identified by: event field in the body · Object: `preauthorization`

```json
{
  "event": "preauthorization.capture.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-success.json)

### preauthorization.release.failed

Confidence: documented · Schema: official schema

Releasing a preauthorization hold fails

Identified by: event field in the body · Object: `preauthorization`

```json
{
  "event": "preauthorization.release.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-release-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-release-failed.json)

### preauthorization.release.success

Confidence: documented · Schema: official schema

Preauthorization hold is released

Identified by: event field in the body · Object: `preauthorization`

```json
{
  "event": "preauthorization.release.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-release-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-release-success.json)

### preauthorization.reserve.success

Confidence: documented · Schema: from Paystack docs (example)

Preauthorization hold is placed on a card

Identified by: event field in the body · Object: `preauthorization`

```json
{
  "event": "preauthorization.reserve.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-reserve-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/preauthorization-reserve-success.json)

## refund

### refund.failed

Confidence: documented · Schema: official schema

Refund can't be processed, and the amount returns to your balance

Identified by: event field in the body · Object: `refund`

```json
{
  "event": "refund.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-failed.json)

### refund.needs-attention

Confidence: documented · Schema: from Paystack docs (example)

Refund reaches the needs-attention status

Identified by: event field in the body · Object: `refund`

```json
{
  "event": "refund.needs-attention",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-needs-attention.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-needs-attention.json)

### refund.pending

Confidence: documented · Schema: official schema

Refund starts and waits on the processor

Identified by: event field in the body · Object: `refund`

```json
{
  "event": "refund.pending",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-pending.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-pending.json)

### refund.processed

Confidence: documented · Schema: official schema

Processor completes a refund

Identified by: event field in the body · Object: `refund`

```json
{
  "event": "refund.processed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-processed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-processed.json)

### refund.processing

Confidence: documented · Schema: official schema

Processor receives a refund

Identified by: event field in the body · Object: `refund`

```json
{
  "event": "refund.processing",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-processing.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/refund-processing.json)

## subscription

### subscription.create

Confidence: documented · Schema: from Paystack docs (example)

New subscription is created

Identified by: event field in the body · Object: `subscription`

```json
{
  "event": "subscription.create",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-create.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-create.json)

### subscription.disable

Confidence: documented · Schema: from Paystack docs (example)

Subscription is disabled

Identified by: event field in the body · Object: `subscription`

```json
{
  "event": "subscription.disable",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-disable.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-disable.json)

### subscription.expiring_cards

Confidence: documented · Schema: official schema

Monthly list of subscriptions whose cards expire that month

Identified by: event field in the body · Object: `subscription`

```json
{
  "event": "subscription.expiring_cards",
  "data": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-expiring-cards.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-expiring-cards.json)

### subscription.not_renew

Confidence: documented · Schema: from Paystack docs (example)

Subscription turns non-renewing, so its next charge won't run

Identified by: event field in the body · Object: `subscription`

```json
{
  "event": "subscription.not_renew",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-not-renew.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/subscription-not-renew.json)

## transfer

### transfer.failed

Confidence: documented · Schema: from Paystack docs (example)

Outgoing transfer fails

Identified by: event field in the body · Object: `transfer`

```json
{
  "event": "transfer.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-failed.json)

### transfer.reversed

Confidence: documented · Schema: from Paystack docs (example)

Outgoing transfer is reversed

Identified by: event field in the body · Object: `transfer`

```json
{
  "event": "transfer.reversed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-reversed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-reversed.json)

### transfer.success

Confidence: documented · Schema: official schema

Outgoing transfer completes

Identified by: event field in the body · Object: `transfer`

```json
{
  "event": "transfer.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/transfer-success.json)

## Other Paystack events

### bank.transfer.rejected

Confidence: documented · Schema: from Paystack docs (example)

Customer's bank transfer is rejected, for example for a wrong amount

Identified by: event field in the body · Object: `bank`

```json
{
  "event": "bank.transfer.rejected",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/bank-transfer-rejected.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/bank-transfer-rejected.json)

### customeridentification.failed

Confidence: documented · Schema: from Paystack docs (example)

Customer identity validation fails

Identified by: event field in the body · Object: `customeridentification`

```json
{
  "event": "customeridentification.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/customeridentification-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/customeridentification-failed.json)

### customeridentification.success

Confidence: documented · Schema: from Paystack docs (example)

Customer identity validation passes

Identified by: event field in the body · Object: `customeridentification`

```json
{
  "event": "customeridentification.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/customeridentification-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/customeridentification-success.json)

### dedicatedaccount.assign.failed

Confidence: documented · Schema: from Paystack docs (example)

Dedicated virtual account can't be assigned to a customer

Identified by: event field in the body · Object: `dedicatedaccount`

```json
{
  "event": "dedicatedaccount.assign.failed",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-failed.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-failed.json)

### dedicatedaccount.assign.success

Confidence: documented · Schema: from Paystack docs (example)

Dedicated virtual account is assigned to a customer

Identified by: event field in the body · Object: `dedicatedaccount`

```json
{
  "event": "dedicatedaccount.assign.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-success.json)

### direct_debit.authorization.active

Confidence: documented · Schema: official schema

Direct debit authorization becomes chargeable

Identified by: event field in the body · Object: `direct_debit`

```json
{
  "event": "direct_debit.authorization.active",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-active.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-active.json)

### direct_debit.authorization.created

Confidence: documented · Schema: official schema

Customer approves a direct debit authorization request

Identified by: event field in the body · Object: `direct_debit`

```json
{
  "event": "direct_debit.authorization.created",
  "status": true,
  "message": "Authorization retrieved successfully",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-created.json)

| Key field | Type | Example |
|---|---|---|
| `status` | boolean | `true` |

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-created.json)

### paymentrequest.pending

Confidence: documented · Schema: from Paystack docs (example)

Payment request goes out to a customer

Identified by: event field in the body · Object: `paymentrequest`

```json
{
  "event": "paymentrequest.pending",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/paymentrequest-pending.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/paymentrequest-pending.json)

### paymentrequest.success

Confidence: documented · Schema: from Paystack docs (example)

Customer pays a payment request

Identified by: event field in the body · Object: `paymentrequest`

```json
{
  "event": "paymentrequest.success",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paystack/events/paymentrequest-success.json)

From Paystack docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paystack/events/paymentrequest-success.json)

### zero_charge_authorization.failed

Confidence: documented · Schema: No payload yet

Zero-amount card authorization fails

Identified by: event field in the body · Object: `zero_charge_authorization`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paystack/events/zero-charge-authorization-failed.json)

---

Not affiliated with Paystack. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/paystack.json) · [Report a correction](https://hookdeck.com/contact)
