{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Paystack.",
  "vendor": "paystack",
  "name": "Paystack",
  "official_docs": "https://paystack.com/docs/payments/webhooks/",
  "docs_checked": "2026-07-29",
  "url": "https://hookdeck.com/webhooks/paystack",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/paystack"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/paystack/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/paystack/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/paystack/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/paystack/guide-duplicates-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/paystack/skill"
    }
  ],
  "summary": "Paystack signs every webhook with x-paystack-signature (HMAC-SHA512).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "x-paystack-signature",
      "detail": "Format: <128 lowercase hex characters>",
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://raw.githubusercontent.com/PaystackHQ/plugin-magento-2/master/marketplace/src/reference-manual.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA512",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://raw.githubusercontent.com/PaystackHQ/plugin-magento-2/master/marketplace/src/reference-manual.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The request body exactly as sent, with no timestamp. Re-serialised JSON can fail.",
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://raw.githubusercontent.com/PaystackHQ/plugin-magento-2/master/marketplace/src/reference-manual.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "event field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://raw.githubusercontent.com/PaystackOSS/doc-code-snippets/main/src/doc/payments/webhooks/events/customer-id-failed.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://raw.githubusercontent.com/PaystackOSS/doc-code-snippets/main/src/doc/payments/webhooks/verifying-signature/index.js"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "event, data",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Paystack docs",
        "href": "https://paystack.com/docs/payments/webhooks/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill paystack-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/paystack/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://github.com/PaystackOSS/doc-code-snippets/tree/main/src/doc/payments",
    "checked": "2026-11-04"
  },
  "counts": {
    "events": 35,
    "with_payload": 33,
    "captured": 0,
    "with_description": 35,
    "resources": 7,
    "confidence": {
      "verified": 0,
      "documented": 35,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Paystack event"
  },
  "events": [
    {
      "name": "bank.transfer.rejected",
      "resource": "bank",
      "description": "Customer's bank transfer is rejected, for example for a wrong amount",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#bank.transfer.rejected",
      "json": "https://hookdeck.com/webhooks/paystack/events/bank-transfer-rejected.json"
    },
    {
      "name": "charge.dispute.create",
      "resource": "charge",
      "description": "Customer opens a dispute against your business",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#charge.dispute.create",
      "json": "https://hookdeck.com/webhooks/paystack/events/charge-dispute-create.json"
    },
    {
      "name": "charge.dispute.remind",
      "resource": "charge",
      "description": "Open dispute still hasn't been resolved",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#charge.dispute.remind",
      "json": "https://hookdeck.com/webhooks/paystack/events/charge-dispute-remind.json"
    },
    {
      "name": "charge.dispute.resolve",
      "resource": "charge",
      "description": "Dispute reaches a resolution",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#charge.dispute.resolve",
      "json": "https://hookdeck.com/webhooks/paystack/events/charge-dispute-resolve.json"
    },
    {
      "name": "charge.failed",
      "resource": "charge",
      "description": "Charge attempt fails",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/paystack/events#charge.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/charge-failed.json"
    },
    {
      "name": "charge.success",
      "resource": "charge",
      "description": "Charge completes successfully",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#charge.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/charge-success.json"
    },
    {
      "name": "customeridentification.failed",
      "resource": "customeridentification",
      "description": "Customer identity validation fails",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#customeridentification.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/customeridentification-failed.json"
    },
    {
      "name": "customeridentification.success",
      "resource": "customeridentification",
      "description": "Customer identity validation passes",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#customeridentification.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/customeridentification-success.json"
    },
    {
      "name": "dedicatedaccount.assign.failed",
      "resource": "dedicatedaccount",
      "description": "Dedicated virtual account can't be assigned to a customer",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#dedicatedaccount.assign.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-failed.json"
    },
    {
      "name": "dedicatedaccount.assign.success",
      "resource": "dedicatedaccount",
      "description": "Dedicated virtual account is assigned to a customer",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#dedicatedaccount.assign.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/dedicatedaccount-assign-success.json"
    },
    {
      "name": "direct_debit.authorization.active",
      "resource": "direct_debit",
      "description": "Direct debit authorization becomes chargeable",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#direct_debit.authorization.active",
      "json": "https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-active.json"
    },
    {
      "name": "direct_debit.authorization.created",
      "resource": "direct_debit",
      "description": "Customer approves a direct debit authorization request",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#direct_debit.authorization.created",
      "json": "https://hookdeck.com/webhooks/paystack/events/direct-debit-authorization-created.json"
    },
    {
      "name": "invoice.create",
      "resource": "invoice",
      "description": "Subscription invoice is raised, usually three days before the charge",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#invoice.create",
      "json": "https://hookdeck.com/webhooks/paystack/events/invoice-create.json"
    },
    {
      "name": "invoice.payment_failed",
      "resource": "invoice",
      "description": "Payment attempt on an invoice fails",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#invoice.payment_failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/invoice-payment-failed.json"
    },
    {
      "name": "invoice.update",
      "resource": "invoice",
      "description": "Invoice changes, usually after a successful charge",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#invoice.update",
      "json": "https://hookdeck.com/webhooks/paystack/events/invoice-update.json"
    },
    {
      "name": "paymentrequest.pending",
      "resource": "paymentrequest",
      "description": "Payment request goes out to a customer",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#paymentrequest.pending",
      "json": "https://hookdeck.com/webhooks/paystack/events/paymentrequest-pending.json"
    },
    {
      "name": "paymentrequest.success",
      "resource": "paymentrequest",
      "description": "Customer pays a payment request",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#paymentrequest.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/paymentrequest-success.json"
    },
    {
      "name": "preauthorization.capture.failed",
      "resource": "preauthorization",
      "description": "Capturing a preauthorized amount fails",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#preauthorization.capture.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-failed.json"
    },
    {
      "name": "preauthorization.capture.success",
      "resource": "preauthorization",
      "description": "Preauthorized amount is captured",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#preauthorization.capture.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/preauthorization-capture-success.json"
    },
    {
      "name": "preauthorization.release.failed",
      "resource": "preauthorization",
      "description": "Releasing a preauthorization hold fails",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#preauthorization.release.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/preauthorization-release-failed.json"
    },
    {
      "name": "preauthorization.release.success",
      "resource": "preauthorization",
      "description": "Preauthorization hold is released",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#preauthorization.release.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/preauthorization-release-success.json"
    },
    {
      "name": "preauthorization.reserve.success",
      "resource": "preauthorization",
      "description": "Preauthorization hold is placed on a card",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#preauthorization.reserve.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/preauthorization-reserve-success.json"
    },
    {
      "name": "refund.failed",
      "resource": "refund",
      "description": "Refund can't be processed, and the amount returns to your balance",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#refund.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/refund-failed.json"
    },
    {
      "name": "refund.needs-attention",
      "resource": "refund",
      "description": "Refund reaches the needs-attention status",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#refund.needs-attention",
      "json": "https://hookdeck.com/webhooks/paystack/events/refund-needs-attention.json"
    },
    {
      "name": "refund.pending",
      "resource": "refund",
      "description": "Refund starts and waits on the processor",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#refund.pending",
      "json": "https://hookdeck.com/webhooks/paystack/events/refund-pending.json"
    },
    {
      "name": "refund.processed",
      "resource": "refund",
      "description": "Processor completes a refund",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#refund.processed",
      "json": "https://hookdeck.com/webhooks/paystack/events/refund-processed.json"
    },
    {
      "name": "refund.processing",
      "resource": "refund",
      "description": "Processor receives a refund",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#refund.processing",
      "json": "https://hookdeck.com/webhooks/paystack/events/refund-processing.json"
    },
    {
      "name": "subscription.create",
      "resource": "subscription",
      "description": "New subscription is created",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#subscription.create",
      "json": "https://hookdeck.com/webhooks/paystack/events/subscription-create.json"
    },
    {
      "name": "subscription.disable",
      "resource": "subscription",
      "description": "Subscription is disabled",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#subscription.disable",
      "json": "https://hookdeck.com/webhooks/paystack/events/subscription-disable.json"
    },
    {
      "name": "subscription.expiring_cards",
      "resource": "subscription",
      "description": "Monthly list of subscriptions whose cards expire that month",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#subscription.expiring_cards",
      "json": "https://hookdeck.com/webhooks/paystack/events/subscription-expiring-cards.json"
    },
    {
      "name": "subscription.not_renew",
      "resource": "subscription",
      "description": "Subscription turns non-renewing, so its next charge won't run",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#subscription.not_renew",
      "json": "https://hookdeck.com/webhooks/paystack/events/subscription-not-renew.json"
    },
    {
      "name": "transfer.failed",
      "resource": "transfer",
      "description": "Outgoing transfer fails",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#transfer.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/transfer-failed.json"
    },
    {
      "name": "transfer.reversed",
      "resource": "transfer",
      "description": "Outgoing transfer is reversed",
      "confidence": "documented",
      "schema_source": "from Paystack docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#transfer.reversed",
      "json": "https://hookdeck.com/webhooks/paystack/events/transfer-reversed.json"
    },
    {
      "name": "transfer.success",
      "resource": "transfer",
      "description": "Outgoing transfer completes",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/paystack/events#transfer.success",
      "json": "https://hookdeck.com/webhooks/paystack/events/transfer-success.json"
    },
    {
      "name": "zero_charge_authorization.failed",
      "resource": "zero_charge_authorization",
      "description": "Zero-amount card authorization fails",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/paystack/events#zero_charge_authorization.failed",
      "json": "https://hookdeck.com/webhooks/paystack/events/zero-charge-authorization-failed.json"
    }
  ]
}