Paystack Webhook

POST

https://stageapi.partake.ng/api/v2/payments/webhook/paystack

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Paystack webhook receiver. Called by Paystack on charge.success / charge.failed events. Requires a valid x-paystack-signature header — invalid signature returns 401. Amount is in kobo (divide by 100 for NGN). Always returns 200 to prevent gateway retries.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

text/plain

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/payments/webhook/paystack' \
--header 'x-paystack-signature: <hmac-sha512-of-raw-body>' \
--header 'Content-Type: application/json' \
--data '{
    "event": "charge.success",
    "data": {
        "reference": "PAY_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "success",
        "amount": 150000,
        "currency": "NGN"
    }
}'

Response Example

{
  "success": false,
  "error": {
    "code": "WEBHOOK_SIGNATURE_INVALID",
    "message": "Invalid Paystack webhook signature.",
    "details": {}
  },
  "statusCode": 401
}

Modified at 2026-07-10 13:15:30

Webhooks

Flutterwave Webhook