Refund Processed

Emitted when a refund has been successfully processed and funds are being returned to the customer

Event Domain Event

Overview

The RefundProcessed event indicates that a refund has been successfully initiated and funds are being returned to the customer’s original payment method.

Refund Types

  • Full Refund: Complete reversal of original payment
  • Partial Refund: Return of portion of payment amount
  • Chargeback: Customer-initiated dispute (separate event)

Event Schema

Schema Definition

{
  "eventId": "uuid",
  "eventType": "RefundProcessed",
  "timestamp": "2025-12-11T10:30:00Z",
  "version": "1.0.0",
  "data": {
    "refundId": "string",
    "originalPaymentId": "string",
    "transactionId": "string",
    "customerId": "string",
    "refundAmount": {
      "value": "number",
      "currency": "string"
    },
    "originalAmount": {
      "value": "number",
      "currency": "string"
    },
    "refundType": "full | partial",
    "reason": "string",
    "invoiceId": "string (optional)",
    "gatewayReference": "string",
    "processedAt": "timestamp",
    "estimatedArrival": "timestamp"
  }
}

Example Payload

{
  "eventId": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
  "eventType": "RefundProcessed",
  "timestamp": "2025-12-11T14:30:00Z",
  "version": "1.0.0",
  "data": {
    "refundId": "ref_abc123",
    "originalPaymentId": "pay_1234567890",
    "transactionId": "txn_refund_xyz",
    "customerId": "cus_johndoe",
    "refundAmount": {
      "value": 49.99,
      "currency": "USD"
    },
    "originalAmount": {
      "value": 99.99,
      "currency": "USD"
    },
    "refundType": "partial",
    "reason": "Product returned - damaged",
    "invoiceId": "INV-2025-000123",
    "gatewayReference": "re_stripe_def456",
    "processedAt": "2025-12-11T14:30:00Z",
    "estimatedArrival": "2025-12-16T00:00:00Z"
  }
}

Downstream Actions

  • Ledger Service: Creates reversing journal entries
  • Invoice Service: Creates credit note or adjusts invoice
  • Notification Service: Sends refund confirmation
  • AR Service: Updates customer balance
21 properties
eventIdstring<uuid>
required
eventTypestringconstant: RefundProcessed
required
timestampstring<date-time>
required
versionstring
required
Match pattern: ^\d+\.\d+\.\d+$
dataobject
required
Edit this page