Payout webhook (async notification)

POST

Configure a webhook URL in the Finix merchant dashboard (Settings) to receive the final status of payout orders.

Webhooks notify your server about transaction events in near real time. When processing completes, the webhook sends a payload with transaction details—including amount, references, type, and status.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

text/plain

SUCCESS

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'Configure a webhook URL in the Finix merchant dashboard (Settings) to receive the final status of payout orders.' \
--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"
}'

Response Example

Finix retries the webhook once per minute, up to 10 attempts, until your endpoint responds with SUCCESS.

Modified at 2026-04-07 17:04:45

Fetch payout status

Bank code