REFUND STATUS UPDATE

Event Overview

Event Type: REFUND_STATUS_UPDATE
Category: Payment
Description: Refund status has changed This webhook is triggered whenever a refund transitions to a new status (for example, while it is being processed) through EximPe.

Payload Schema

{
    "event_type": "REFUND_STATUS_UPDATE",
    "event_time": "2026-05-27T14:30:01.359434",
    "version": "3.0.0",
    "sequence_number": "9e15c8b0-46d2-4af7-8130-72c5e9a4f6d8",
    "data": {
        "refunds": [
            {
                "refund_id": "RF7405286913",
                "refund_reference_id": "RF-2026-0043",
                "order_id": "OD2683049175",
                "order_reference_id": "S2SICR1QPK",
                "payment_id": "PR1938472605",
                "refund_amount": 1180,
                "refund_status": "PROCESSING",
                "comments": "Refund is in progress",
                "bank_arn": null,
                "refund_completed_at": null
            }
        ]
    }
}

Field Specifications

Root Level Fields
Data Object Fields

string

required

Always "REFUND_STATUS_UPDATE" for this webhook event

string

required

UTC, no timezone suffix, e.g. "2026-05-27T14:30:01.359434". 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: "9e15c8b0-46d2-4af7-8130-72c5e9a4f6d8"

object

required

Event-specific data payload containing refund details

array

required

Array of refund objects containing the refund information

string

required

Order ID associated with the refundExample: "OD2683049175"

string

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

string

required

Unique refund identifierExample: "RF7405286913"

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-0043"

string

required

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

number

required

Refund amountExample: 1180

string

required

Current status of the refund. One of PROCESSING, REVERSED, ON_HOLD or BANK_REJECTED_REFUND. Interim status; the final outcome arrives as PAYMENT_REFUNDED or REFUND_FAILED.Example: "PROCESSING"

string

Human-readable note describing the current refund statusExample: "Refund is in progress"

string

Bank ARN (Acquirer Reference Number) - null until the refund reaches the bankExample: null

string

Timestamp when the refund completed - null while the refund is still in progressExample: 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