Fetch payout status

POST

https://secure.finixpayment.com/v1/api/payout/fetch

We strongly recommend that, upon receiving a notification, you verify the transaction with Finix using transactionRef to confirm its actual status before updating your database records.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://secure.finixpayment.com/v1/api/payout/fetch' \
--header 'MerchantID: FX100001' \
--header 'Signature: paLAc7iNnnFhOYaKIgukzKXNPHIMES47pFnrnHtZ9LZjRyeqehMeKnb7alAdvB8xkUwOJ7y4V1tMSIDXh2otHi2NAxpOMZBrE4D9JWqhEPWQQMJrjrqousC9pfibDXP0I6lhSFoaV0iAQjTcrpfz2ONSpswz3pvYy27UJtldai6gBx1eI2PztrWiotsMojx7TcERibfXjP0wY8mScGePSUxjWThkKK5FggBvkKOXyvQe27nZ7isHUEAdAhdbgeRV' \
--header 'Timestamp: 1750554703' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionRef": "2c4d9ff6-dc9a-4bee-a751-18071257685c"
}'

Response Example

200 - SUCCESS

{
    "code": "200",
    "message": "SUCCESS",
    "data": {
        "transactionRef": "dfce0d4d-0bdb-47b3-9cc9-b2e0f7905dac",
        "merchantRef": "de76d2c9-b4e7-4122-a066-d52fe2b5842e",
        "currency": "NGN",
        "method": "TRANSFER",
        "amount": 100.01,
        "fee": 5.5,
        "status": "Initiated"
    }
}

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

Initiate payout

Payout webhook (async notification)