Flutterwave Webhook

POST

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

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

Maintainer:Not configured

Flutterwave webhook receiver. Called by Flutterwave on charge.completed events. Requires verif-hash header matching FLUTTERWAVE_SECRET_HASH — mismatch returns 401. Amount is already in 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/flutterwave' \
--header 'verif-hash: <your-flutterwave-secret-hash>' \
--header 'Content-Type: application/json' \
--data '{
    "event": "charge.completed",
    "data": {
        "tx_ref": "FLW_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "successful",
        "amount": 1500,
        "currency": "NGN"
    }
}'

Response Example

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

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

Paystack Webhook

Payout Webhook (Payouts)