Webhooks

Webhooks are server callbacks to your server from FivePay. Webhooks are event-based and are sent when specific events related to the transaction success.

Configure Webhook
  1. Add your webhook through the merchant dashboard for the first time. Write to support@fivepayglobal.com to edit your Webhook endpoint.
  2. Ensure you do not process duplicate events.
  3. Below is the list of events for which we will be notifying on your webhook and a list of parameters being sent.

We support webhooks in both encoded and JSON formats.

Webhook parameters and descriptions are available below:
Parameter Description
utr The Invoice Id of the order.
amount Specifies the amount.
ref_id Specifies the reference id of the request.
status Specifies the status of the request.
txn_id Specifies the transaction id of the request.
message Specifies the message received from the request.
payeeVpa Specifies the vpa of the payee.
timestamp The time of the request.

Transfer Rejected

It notifies that the transfer request was received, but has been rejected due to some reason.

Webhook Response

{
  "utr": "XXXXXXX86764",
  "amount": 500,
  "ref_id": "FVPXXXXV3499180",
  "status": "paid",
  "txn_id": "64XX34120770",
  "message": "Payment Successful",
  "payeeVpa": "vegaaH.GRXXXX@kotak",
  "timestamp": "2026-03-27 13:32:27"
}

Callback Response

{
  "status": "1",
  "message": "Transaction completed successfully"
}

Note: We do not send response for failed or pending transaction, if no response means its failed or pending transaction

Did this page help you?     Yes    No