Payment webhook

POST

Configure a webhook URL in the Finix merchant dashboard (Settings) to receive asynchronous payment notifications.

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": "EGP",
    "method": "FAWRY_RN",
    "amount": "100",
    "paidAmount": "100",
    "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 asynchronous payment notifications.' \
--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": "EGP",
    "method": "FAWRY_RN",
    "amount": "100",
    "paidAmount": "100",
    "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-05-21 15:58:54

Fetch payment status

Initiate payout