Webhook

POST

Merchants are required to provide a webhook URL to receive final status notifications for payout orders. Please configure this URL in the Settings menu of the Finix Merchant Portal.

Our webhook provides real-time notifications to merchants about transaction events. Once the payment is processed, the webhook will send a payload containing transaction details, including the amount, transaction reference number, type, and status.

Request

Header Params

Body Params application/json

Example

{
    "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
    "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
    "currency": "NGN",
    "method": "BANK",
    "amount": "100",
    "fee": "5.5",
    "status": "Success"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'Merchants are required to provide a webhook URL to receive final status notifications for payout orders. Please configure this URL in the Settings menu of the Finix Merchant Portal.' \
--header 'Signature: 61MNVRXa9k3tNwWCtLXYDmXPlIMenBNuVtBGzrAXEt76uh9wgpYTOb4tIU1v0sN7qZaaUAbFvv2eXra1an1vu00B2E5uWwbublyz4bs6xw2sWks6auFGfYtL9cGI1oHnIxAjjQXwK4RV2ewsmNVfXABDyd2ns4ybIML4MUuwnUCV7o14NqFoMxUb2YMfRkkYJ11MNgs6aP6IbVRh48Wp6uVCY1LsMXGvMtsv3ts2GX5GnsC4KQutuvoJq0vUY5UU' \
--header 'Timestamp: 1750554890' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
    "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
    "currency": "NGN",
    "method": "BANK",
    "amount": "100",
    "fee": "5.5",
    "status": "Success"
}'

Responses

🟢200Success

text/plain

SUCCESS

Body

Example

Finix will notify you every minute up to 10 consecutive times until a SUCCESS response is received.

Fetch

Bank Code