Webhook Types

Charge Webhooks

• Received upon creating a transaction and each time that transaction’s status is updated.

Sample Charge Webhook

{
  "id":"f946edfa-40e4-48bb-b4a2-30d2ecffc023",
  "charge_id":"436a6507-a82f-4c43-9918-b0da0f84c144",
  "short_id":"EWxl_IJIAON-mkHp",
  "timestamp":1695610390926,
  "order_id":"4609fb7c-f8be-44b7-b058-03affcf5be7d",
  "service_id":"9b8b84f7-1bd0-4270-a701-56f734496e78",
  "amount":1000,
  "charge_status":{
    "status":"not_validated",
    "timestamp":"2023-09-25T02:53:10Z"
  },
  "payment_instrument_id":"087d43ff-ed16-4192-aa7c-e190bd923143",
  "currency_code":"INR2",
  "object_type":"webhook"
}

Charge Webhook Events

State	Description
Pending Creation	A request to create the charge is pending a response.
Created	The charge is created, and relevant informaiton has been securly stored. This is the first state of the charge.
Not Created	A request to create the charge failed due to a technical issue.
Pending Validation	A request to validate the charge is pending a response.
Validated	The charge's validation has been completed successfully.
Not Validated	A validation attempt failed due to missing or incorrect information.
Pending Authorisation	A request to authorise the charge is pending a response.
Authorised	Funds have been authorised and held on the payment instrument. A request to fund the charge is pending a response.
Not Authorised	Funds have not been authorised and held on the payment instrument and sufficient funds have not been held
Pending Completion	A request to complete the charge, partially or in full, is pending a response.
Completed	The charge is complete. Payment has been made for the order total.
Not Completed	There is missing information, or the total payment doesn't equal the order total due to an exception or partial capture.

Retry Policy

We will attempt to send a Webhook 7 times, with the first retry attempted immediately and subsequent retries attempted at increasing intervals.

The customer's endpoint has 20 seconds to respond to the Webhook HTTP Post request before the request is timed out and the webhook will be marked as failed and send the first retry.

Webhook delivery failure conditions:

• Customer endpoint does not respond within 20 seconds
• Customer endpoint responds with HTTP Status code != 200

Webhook send attempt	Seconds delay before sending
1	0
2	0
3	9
4	28
5	90
6	297
7	900