REFUND FAILED

Event Overview

Event Type: REFUND_FAILED
Category: Payment
Description: Refund could not be completed This webhook is triggered when a refund fails to process or its final status could not be confirmed through EximPe.

Payload Schema

{
    "event_type": "REFUND_FAILED",
    "event_time": "2026-06-03T14:30:02.854654",
    "version": "3.0.0",
    "sequence_number": "f8b260a7-31c4-49de-90af-6b52d7e1aa39",
    "data": {
        "refunds": [
            {
                "refund_id": "RF2859613470",
                "refund_reference_id": "RF-2026-0042",
                "order_id": "OD7104928365",
                "order_reference_id": "S2SICR1QPJ",
                "payment_id": "PR3947261085",
                "refund_amount": 799,
                "comments": "Refund failed or status unknown",
                "bank_arn": null,
                "refund_completed_at": null
            }
        ]
    }
}

Field Specifications

Root Level Fields
Data Object Fields

string

required

Always "REFUND_FAILED" for this webhook event

string

required

UTC, no timezone suffix, e.g. "2026-06-03T14:30:02.854654". Parse tolerantly — fractional seconds can be absent.

string

required

API version of your account, e.g. "3.0.0"

string

required

Unique ID of this event (a UUID, not an ordering counter). A retry resends the same value; use it to de-duplicate.Example: "f8b260a7-31c4-49de-90af-6b52d7e1aa39"

object

required

Event-specific data payload containing refund details

array

required

Array of refund objects containing the failed refund information

string

required

Order ID associated with the refundExample: "OD7104928365"

string

Your reference ID for the order, as sent when it was created. null when the order has none.Example: "S2SICR1QPJ"

string

required

Unique refund identifierExample: "RF2859613470"

string

Your reference for the refund — the reference_id sent when it was created, or the one we generated when none was sent. null when the refund has none.Example: "RF-2026-0042"

string

required

Original payment ID that the refund was attempted againstExample: "PR3947261085"

number

required

Refund amount that failed to processExample: 799

string

Human-readable reason describing why the refund failed or could not be confirmedExample: "Refund failed or status unknown"

string

Bank ARN (Acquirer Reference Number) - null when the refund did not reach the bankExample: null

string

Timestamp when the refund completed - null for a failed refundExample: null

Order

Payment

Merchant

Settlement

Refund

Subscriptions

Payment Links

Virtual Bank Accounts

LRS

B2B Services

Webhooks

Event Overview

Payload Schema

Field Specifications

​Event Overview

​Payload Schema

​Field Specifications

Event Overview

Payload Schema

Field Specifications