# Paystack Webhooks

**Canonical:** https://apis.io/apis/paystack/paystack-webhooks/  
**Provider:** Paystack — https://apis.io/providers/paystack/  
**Documentation:** https://paystack.com/docs/payments/webhooks/

Paystack Webhooks is one of 21 APIs that [Paystack](https://apis.io/providers/paystack/) publishes on the [APIs.io](https://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.

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.

## Machine-readable artifacts (28)

- **Documentation** — https://paystack.com/docs/payments/webhooks/
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/asyncapi/paystack-webhooks-asyncapi.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/apis.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-add-subaccount-to-split-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-blacklist-customer-after-dispute-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-bulk-recipients-and-bulk-transfer-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-charge-and-refund-transaction-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-charge-and-submit-otp-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-charge-and-submit-pin-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-check-authorization-and-partial-debit-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-customer-and-charge-authorization-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-customer-and-payment-request-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-customer-dedicated-virtual-account-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-customer-plan-and-subscription-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-product-and-payment-page-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-recipient-and-initiate-transfer-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-create-subaccount-and-split-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-disable-and-reenable-subscription-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-dispute-evidence-and-resolve-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-finalize-and-archive-payment-request-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-initialize-and-verify-transaction-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-initiate-and-finalize-transfer-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-initiate-and-monitor-bulk-charge-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-resolve-account-and-create-recipient-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-resolve-card-bin-and-charge-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-settlement-reconciliation-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-subscribe-and-generate-manage-link-workflow.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/paystack/refs/heads/main/arazzo/paystack-validate-customer-kyc-workflow.yml

## Other Paystack APIs (12)

- [Paystack Balance API](https://apis.io/apis/paystack/paystack-balance-api/)
- [Paystack Bulk Charge API](https://apis.io/apis/paystack/paystack-bulk-charge-api/)
- [Paystack Charge API](https://apis.io/apis/paystack/paystack-charge-api/)
- [Paystack Customer API](https://apis.io/apis/paystack/paystack-customer-api/)
- [Paystack Dedicated Virtual Account API](https://apis.io/apis/paystack/paystack-dedicated-virtual-account-api/)
- [Paystack Dispute API](https://apis.io/apis/paystack/paystack-dispute-api/)
- [Paystack Integration API](https://apis.io/apis/paystack/paystack-integration-api/)
- [Paystack Page API](https://apis.io/apis/paystack/paystack-page-api/)
- [Paystack Payment Request API](https://apis.io/apis/paystack/paystack-payment-request-api/)
- [Paystack Plan API](https://apis.io/apis/paystack/paystack-plan-api/)
- [Paystack Product API](https://apis.io/apis/paystack/paystack-product-api/)
- [Paystack Refund API](https://apis.io/apis/paystack/paystack-refund-api/)

## Tags

Webhook, Event, AsyncAPI, HMAC

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/paystack/paystack-webhooks/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/paystack/.