Paystack MCP events
Paystack's webhook events are available to agents as MCP events through Hookdeck Event Gateway.
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.
How to subscribe
- Connect your agent to Hookdeck's MCP server, the MCP Events bridge.
- Point your Paystack webhook at a Hookdeck source.
- Your agent lists the available events and subscribes to the ones it needs.
Events
| Webhook event | MCP event |
|---|---|
bank.transfer.rejected | paystack.bank.transfer.rejected |
charge.dispute.create | paystack.charge.dispute.create |
charge.dispute.remind | paystack.charge.dispute.remind |
charge.dispute.resolve | paystack.charge.dispute.resolve |
charge.failed | paystack.charge.failed |
charge.success | paystack.charge.success |
customeridentification.failed | paystack.customeridentification.failed |
customeridentification.success | paystack.customeridentification.success |
dedicatedaccount.assign.failed | paystack.dedicatedaccount.assign.failed |
dedicatedaccount.assign.success | paystack.dedicatedaccount.assign.success |
direct_debit.authorization.active | paystack.direct_debit.authorization.active |
direct_debit.authorization.created | paystack.direct_debit.authorization.created |
invoice.create | paystack.invoice.create |
invoice.payment_failed | paystack.invoice.payment_failed |
invoice.update | paystack.invoice.update |
paymentrequest.pending | paystack.paymentrequest.pending |
paymentrequest.success | paystack.paymentrequest.success |
preauthorization.capture.failed | paystack.preauthorization.capture.failed |
preauthorization.capture.success | paystack.preauthorization.capture.success |
preauthorization.release.failed | paystack.preauthorization.release.failed |
preauthorization.release.success | paystack.preauthorization.release.success |
preauthorization.reserve.success | paystack.preauthorization.reserve.success |
refund.failed | paystack.refund.failed |
refund.needs-attention | paystack.refund.needs-attention |
refund.pending | paystack.refund.pending |
refund.processed | paystack.refund.processed |
refund.processing | paystack.refund.processing |
subscription.create | paystack.subscription.create |
subscription.disable | paystack.subscription.disable |
subscription.expiring_cards | paystack.subscription.expiring_cards |
subscription.not_renew | paystack.subscription.not_renew |
transfer.failed | paystack.transfer.failed |
transfer.reversed | paystack.transfer.reversed |
transfer.success | paystack.transfer.success |
zero_charge_authorization.failed | paystack.zero_charge_authorization.failed |
Subscribe your agent to Paystack events.
Point your Paystack webhook at Event Gateway and run the MCP Events bridge. Event Gateway delivers each event to the agents whose subscription filters it matches, and retries failures.