PAYMENT FAILED

Technical reference for the PAYMENT_FAILED webhook event, including payload schema, field specifications, and implementation details.

---

Event Overview

Event Type: PAYMENT_FAILED
Category: Payment
Description: Payment transaction has failed

This webhook is triggered when a customer’s payment attempt fails through EximPe.

---

Payload Schema

Example Payload

{
    "event_type": "PAYMENT_FAILED",
    "event_time": "2024-02-15 16:53:15Z",
    "version": "1.0",
    "sequence_number": "e40552bf-ed12-4f35-9a97-162d97e6fa34",
    "data": {
        "status": "FAILED",
        "message": "Cancelled by user",
        "mop_type": "UPI",
        "order_id": "OD3376378679",
        "payment_id": "PR6938527534",
        "bank_ref_num": "OD3376378679-PR6938527534",
        "payment_completed_at": "2025-06-24T12:30:44.000000Z"
    }
}

---

Field Specifications

Root Level Fields

event_type · string · required

Always "PAYMENT_FAILED" for this webhook event

event_time · string · required

Timestamp when the event occurred in ISO 8601 format

Example: "2024-02-15 16:53:15Z"

version · string · required

Webhook payload version (currently “1.0”)

sequence_number · string · required

Unique identifier for the event instance

Example: "e40552bf-ed12-4f35-9a97-162d97e6fa34"

data · object · required

Event-specific data payload containing failed payment transaction details

Data Object Fields

data.status · string · required

Payment status (FAILED for failed payments)

Example: "FAILED"

data.message · string · required

Failure reason or message

Example: "Cancelled by user"

data.mop_type · string · required

Method of payment type

Example: "UPI"

data.order_id · string · required

Order ID

Example: "OD3376378679"

data.payment_id · string · required

Payment ID

Example: "PR6938527534"

data.bank_ref_num · string · required

Bank reference number

Example: "OD3376378679-PR6938527534"

data.payment_completed_at · string · required

ISO 8601 payment completion timestamp

Example: "2025-06-24T12:30:44.000000Z"

---