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

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '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 '{
    "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
    "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
    "currency": "IDR",
    "method": "TRANSFER",
    "amount": "10000",
    "fee": "5.5",
    "status": "Success"
}'

Responses

🟢200Success

text/plain

SUCCESS

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