Outbound webhook surface that notifies a single merchant-configured POST endpoint of transaction, dispute, refund, transfer, subscription, invoice, payment request, customer identification, and dedicated virtual account events. Every delivery is signed with an HMAC-SHA512 x-paystack-signature header keyed by the merchant secret key, and Paystack retries non-200 responses for up to 72 hours.
Paystack Webhooks is one of 21 APIs that Paystack publishes on the APIs.io network, described by an AsyncAPI event-driven specification.
Tagged areas include Webhook, Event, AsyncAPI, and HMAC. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.
This event API exposes
1 operation
across 1 channel,
and defines 50 schemas.
It is described by AsyncAPI 2.6.0, at version 1.0.0.
The API connects through a single server, {webhookUrl} (https).
1 operations1 channels50 schemas
Metadata
The identity and technical contract details declared by the specification.
Across 1 channel, the API surfaces 1 operation. Each is listed below with its action, channel, parameters, and response codes.
Channels 1
PUB
paystack/events
Receive a Paystack webhook event
receivePaystackEventbody
Messages & Schemas 50
The contract defines 50 schemas that model the data carried by its messages. The most detailed are PaystackIdentification (5 properties), EventEnvelope (2 properties). Each schema is shown below with its type and property counts.
ChargeSuccess
message
A successful transaction (charge) was completed.
ChargeDisputeCreate
message
A dispute was logged against your business.
ChargeDisputeRemind
message
A logged dispute has not yet been resolved.
ChargeDisputeResolve
message
A dispute has been resolved.
CustomerIdentificationSuccess
message
Customer identity validation succeeded.
CustomerIdentificationFailed
message
Customer identity validation failed.
DedicatedAccountAssignSuccess
message
A Dedicated Virtual Account was assigned to a customer.
DedicatedAccountAssignFailed
message
Dedicated Virtual Account assignment failed.
InvoiceCreate
message
A subscription invoice has been created.
InvoiceUpdate
message
A subscription invoice was updated (typically a successful charge).
InvoicePaymentFailed
message
A subscription invoice payment failed.
PaymentRequestSuccess
message
A payment request was paid.
PaymentRequestPending
message
A payment request has been sent to a customer.
RefundFailed
message
A refund could not be processed.
RefundPending
message
A refund was initiated and is awaiting processor response.
RefundProcessed
message
A refund has been successfully processed.
RefundProcessing
message
A refund has been received by the processor.
SubscriptionCreate
message
A subscription has been created.
SubscriptionDisable
message
A subscription has been disabled.
SubscriptionNotRenew
message
A subscription has been flagged as non-renewing.
SubscriptionExpiringCards
message
Monthly report of subscriptions whose cards are expiring.
TransferSuccess
message
A transfer has completed successfully.
TransferFailed
message
A transfer attempt failed.
TransferReversed
message
A transfer was reversed.
EventEnvelope
object
Base shape of every Paystack webhook delivery. Concrete event payloads narrow event to a literal string and refine data to the matching resource shape. Field s…
2 properties2 required
PaystackIdentification
object
Identification block included on customeridentification. events. Shape taken from the Paystack webhooks documentation example.
5 properties
ChargeSuccessEvent
object
ChargeDisputeCreateEvent
object
ChargeDisputeRemindEvent
object
ChargeDisputeResolveEvent
object
CustomerIdentificationSuccessEvent
object
CustomerIdentificationFailedEvent
object
DedicatedAccountAssignSuccessEvent
object
DedicatedAccountAssignFailedEvent
object
InvoiceCreateEvent
object
InvoiceUpdateEvent
object
InvoicePaymentFailedEvent
object
PaymentRequestSuccessEvent
object
PaymentRequestPendingEvent
object
RefundFailedEvent
object
RefundPendingEvent
object
RefundProcessedEvent
object
RefundProcessingEvent
object
SubscriptionCreateEvent
object
SubscriptionDisableEvent
object
SubscriptionNotRenewEvent
object
SubscriptionExpiringCardsEvent
object
TransferSuccessEvent
object
TransferFailedEvent
object
TransferReversedEvent
object
Specification
The full machine-readable AsyncAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Paystack Webhooks, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
