# Paystack MCP events

Paystack's webhook events are available to agents as MCP events through Hookdeck Event Gateway.

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)

## Paystack's MCP server

Paystack's MCP server (`@paystack/mcp-server`, in public preview) lets agents look up API operations and make requests to Paystack's API, using test keys only. Those tools call Paystack; they don't deliver Paystack's events. To get Paystack's events into an agent, subscribe it through Hookdeck Event Gateway, as described below. [Paystack's MCP docs](https://github.com/PaystackOSS/paystack-mcp-server)

## How to subscribe

1. Connect your agent to Hookdeck's MCP server ([MCP Events bridge](https://hookdeck.com/blog/mcp-events-bridge)).
2. Point your Paystack webhook at a Hookdeck source.
3. Your agent lists the available events and subscribes to the ones it needs.

## Events

| Webhook event | MCP event |
|---|---|
| [bank.transfer.rejected](https://hookdeck.com/webhooks/paystack/events#bank.transfer.rejected) | `paystack.bank.transfer.rejected` |
| [charge.dispute.create](https://hookdeck.com/webhooks/paystack/events#charge.dispute.create) | `paystack.charge.dispute.create` |
| [charge.dispute.remind](https://hookdeck.com/webhooks/paystack/events#charge.dispute.remind) | `paystack.charge.dispute.remind` |
| [charge.dispute.resolve](https://hookdeck.com/webhooks/paystack/events#charge.dispute.resolve) | `paystack.charge.dispute.resolve` |
| [charge.failed](https://hookdeck.com/webhooks/paystack/events#charge.failed) | `paystack.charge.failed` |
| [charge.success](https://hookdeck.com/webhooks/paystack/events#charge.success) | `paystack.charge.success` |
| [customeridentification.failed](https://hookdeck.com/webhooks/paystack/events#customeridentification.failed) | `paystack.customeridentification.failed` |
| [customeridentification.success](https://hookdeck.com/webhooks/paystack/events#customeridentification.success) | `paystack.customeridentification.success` |
| [dedicatedaccount.assign.failed](https://hookdeck.com/webhooks/paystack/events#dedicatedaccount.assign.failed) | `paystack.dedicatedaccount.assign.failed` |
| [dedicatedaccount.assign.success](https://hookdeck.com/webhooks/paystack/events#dedicatedaccount.assign.success) | `paystack.dedicatedaccount.assign.success` |
| [direct_debit.authorization.active](https://hookdeck.com/webhooks/paystack/events#direct_debit.authorization.active) | `paystack.direct_debit.authorization.active` |
| [direct_debit.authorization.created](https://hookdeck.com/webhooks/paystack/events#direct_debit.authorization.created) | `paystack.direct_debit.authorization.created` |
| [invoice.create](https://hookdeck.com/webhooks/paystack/events#invoice.create) | `paystack.invoice.create` |
| [invoice.payment_failed](https://hookdeck.com/webhooks/paystack/events#invoice.payment_failed) | `paystack.invoice.payment_failed` |
| [invoice.update](https://hookdeck.com/webhooks/paystack/events#invoice.update) | `paystack.invoice.update` |
| [paymentrequest.pending](https://hookdeck.com/webhooks/paystack/events#paymentrequest.pending) | `paystack.paymentrequest.pending` |
| [paymentrequest.success](https://hookdeck.com/webhooks/paystack/events#paymentrequest.success) | `paystack.paymentrequest.success` |
| [preauthorization.capture.failed](https://hookdeck.com/webhooks/paystack/events#preauthorization.capture.failed) | `paystack.preauthorization.capture.failed` |
| [preauthorization.capture.success](https://hookdeck.com/webhooks/paystack/events#preauthorization.capture.success) | `paystack.preauthorization.capture.success` |
| [preauthorization.release.failed](https://hookdeck.com/webhooks/paystack/events#preauthorization.release.failed) | `paystack.preauthorization.release.failed` |
| [preauthorization.release.success](https://hookdeck.com/webhooks/paystack/events#preauthorization.release.success) | `paystack.preauthorization.release.success` |
| [preauthorization.reserve.success](https://hookdeck.com/webhooks/paystack/events#preauthorization.reserve.success) | `paystack.preauthorization.reserve.success` |
| [refund.failed](https://hookdeck.com/webhooks/paystack/events#refund.failed) | `paystack.refund.failed` |
| [refund.needs-attention](https://hookdeck.com/webhooks/paystack/events#refund.needs-attention) | `paystack.refund.needs-attention` |
| [refund.pending](https://hookdeck.com/webhooks/paystack/events#refund.pending) | `paystack.refund.pending` |
| [refund.processed](https://hookdeck.com/webhooks/paystack/events#refund.processed) | `paystack.refund.processed` |
| [refund.processing](https://hookdeck.com/webhooks/paystack/events#refund.processing) | `paystack.refund.processing` |
| [subscription.create](https://hookdeck.com/webhooks/paystack/events#subscription.create) | `paystack.subscription.create` |
| [subscription.disable](https://hookdeck.com/webhooks/paystack/events#subscription.disable) | `paystack.subscription.disable` |
| [subscription.expiring_cards](https://hookdeck.com/webhooks/paystack/events#subscription.expiring_cards) | `paystack.subscription.expiring_cards` |
| [subscription.not_renew](https://hookdeck.com/webhooks/paystack/events#subscription.not_renew) | `paystack.subscription.not_renew` |
| [transfer.failed](https://hookdeck.com/webhooks/paystack/events#transfer.failed) | `paystack.transfer.failed` |
| [transfer.reversed](https://hookdeck.com/webhooks/paystack/events#transfer.reversed) | `paystack.transfer.reversed` |
| [transfer.success](https://hookdeck.com/webhooks/paystack/events#transfer.success) | `paystack.transfer.success` |
| [zero_charge_authorization.failed](https://hookdeck.com/webhooks/paystack/events#zero_charge_authorization.failed) | `paystack.zero_charge_authorization.failed` |
---

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)
