Webhooks

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

Configure Webhook
  1. Add your webhook through the merchant dashboard for the first time. Write to techsupport@OQPay.center 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 collected.
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 of 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": "XXXXXXXXXX",
  "amount": 400,
  "ref_id": "REF-OQP101XXXXXXX",
  "status": "SUCCESS",
  "txn_id": "TPAYXXXXXXXXXXXXXXX",
  "message": "SUCCESS",
  "payeeVpa": "vegaaH.GRXXXX@kotak",
  "timestamp": "2026-03-02T08:01:33.439Z"
}

Callback Response

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

Did this page help you?     Yes    No