API v1FiatPe Home
FiatPeDocs

Create Webhook

POSThttps://api.fiatpe.com/v1/webhooks//v1/webhooks/
Copy

Use the Create Webhook API to register a callback URL for receiving real-time event notifications from FiatPe. While creating a webhook, you can define the webhook name, callback URL, and subscribed events. FiatPe will trigger webhook notifications to the configured URL whenever any selected event occurs, helping your system automatically update payment, order, refund, or transaction statuses.

Headers

Sent as Authorization: Basic base64(Api Key:Salt Key)

Body Parameters

namestring

The name of the webhook. This helps you identify the webhook configuration, especially when multiple webhook endpoints are created for different use cases.

emailemail

The email address used to send webhook-related notifications, alerts, and updates. Returns null if no email address is configured.

callback_url*url

The HTTPS endpoint on your server where FiatPe will send webhook notifications for the subscribed events. Your system should receive the webhook payload at this URL, process the event, and return a successful HTTP response.

secretstring

The webhook secret used to verify the authenticity and integrity of webhook notifications sent by FiatPe. Your system should use this secret to validate incoming webhook payloads before processing the event. Keep this value confidential and do not expose it publicly.

events*list

Each value is sent as a string inside the events array.

The list of events for which the webhook is subscribed. Whenever any selected event occurs, FiatPe sends the corresponding webhook notification to the configured callback URL.