> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appcharge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order Refunded

An event triggered when an order is refunded, either manually or automatically.

**Event Data**

**eventName** `string`

Event name: `order.refunded`.

**eventId** `string`

Event ID. Use this ID to deduplicate re-delivered events.

**timestamp** `number`

Event timestamp in [Epoch time](https://www.epoch101.com/), represented in milliseconds. Example: `1754307361396`.

**sessionId** `string`

The [session ID](https://docs.appcharge.com/api-reference/events/v2/introduction.md#session-id) of the player’s current session. Example: `345397c6-d963-4aa4-a0ba-2aaca6c3ee05`.

**requestId** `string`

ID assigned by Appcharge to each request sent to the publisher. Helps the publisher identify and debug failed requests.

**result** `string`

Event result. Supported values: `success`, `failed`.

**reason** `string`

Reason for the event result. When `result` is `success`, this field returns `null`. When `result` is `failed`, this field returns a free-form failure message from the payment or refund provider.

**attributes** `map\<any,any\>`

A key-value map used to label events for tracking personas or tests. Example: `{ "persona":"non_payer", "blackFridayTest":"Base_group" }`

**customer** `object`

Information about the player.

**properties**

**id** `string`

Customer ID.

**email** `string`

**Deprecated.** Player's email address.

**name** `string`

**Deprecated.** Reserved for the player's name in future versions.

**offer** `object`

Information about the offer.

**properties**

**externalId** `string`

External ID of the offer as configured in the Publisher Dashboard.

**type** `string`

Offer type.

**subType** `string`

Offer subtype.

**name** `string`

Offer name.

**offerIndex** `number`

The index of the offer.

**indexToCollect** `number`

**Deprecated.** Reserved for the index to collect in future versions.

**tab** `string`

**Deprecated.** Reserved for the Publisher Dashboard tab name in future versions.

**pricePoint** `number`

Price point of the offer in USD cents.

**price** `number`

Price in lowest currency unit. For example, cents for USD, and whole yen for JPY. For a list of of supported currencies, their minor unit types, and applicable pricing limitations, see [Supported Currencies](https://docs.appcharge.com/../../merchant-of-record/finance/supported-currencies#supported-currencies).

**currencyCode** `string`

Currency code of the offer in [ISO\_4217](https://en.wikipedia.org/wiki/ISO_4217) format.

**products** `[object]`

List of products in an offer.

**properties**

**displayName** `string`

Display name of the product.

**productExternalId** `string`

External ID of the product as configured in the Publisher Dashboard.

**productQuantity** `string`

The quantity of the product. Must be a minimum 0 and equal to or less than 24 digits long.

**order** `object`

**properties**

**id** `string`

Order ID.

**orderType** `string`

Order type. Example: `Paid`.

**subtotal** `int`

Total order amount in the player's local currency, excluding taxes and discounts.

**discountAmount** `int`

Discount amount calculated on the tax-exclusive price, in USD cents. Always negative, representing a reduction. Example: `-7770`

**totalPayment** `int`

Total amount paid by the player, including discounts and taxes in the player's local currency.

**taxAmount** `int`

Tax amount in the player's local currency.

**currencyCode** `string`

Currency code in [ISO\_4217](https://en.wikipedia.org/wiki/ISO_4217) format.

**currencySymbol** `string`

Currency symbol.

**paymentMethod** `string`

Payment method used for the order.

**pricePointMetadata** `number`

The price point in USD cents. Example: `77700`.

**isSavedPaymentMethodUsed** `boolean`

Whether a player attempted to pay using a saved payment method.

**isNewPaymentMethodSaved** `boolean`

Whether a player attempted to save a new payment method in the checkout.

**storeMetadata** `object`

**properties**

**offersSequenceIndex** `number`

Index of the sub-offer within an offer.

**offerType** `string`

Offer type.

**coupon** `object`

Information about the coupon.

**properties**

**name** `string`

Coupon name.

**promoCodeName** `string`

Promo code name.

**discount** `float`

Discount amount calculated on the tax-exclusive price, in USD cents. Always negative, representing a reduction. Example: `-7770`

**discountPercentage** `float`

Discount percentage.

**device** `object`

Information about the player's device.

**properties**

**platform** `string`

Device platform. Currently returns `null`.

**deviceModel** `string`

Device model. Currently returns `null`.

**osType** `string`

Operating system type. Example: `Android`.

**osVersion** `string`

Operating system version. Example: `18`.

**browserType** `string`

Browser type. Example: `Google Chrome`.

**browserVersion** `string`

Browser version. Example: `138`.

**geolocation** `object`

Information about the player's geolocation.

**properties**

**countryCode2** `enum`

Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. Example: `US`

**region** `string`

**Deprecated.** Region or state.

**ipAddress** `string`

**Deprecated.** IP address in [IPv4](https://en.wikipedia.org/wiki/IPv4) format. Example: `80.178.249.122`.

**zipCode** `string`

**Deprecated.** Zip code.

**transactions** `[object]`

Information about each transaction.

**properties**

**purchaseId** `string`

Purchase ID.

**type** `string`

Transaction type.

**timestamp** `number`

Transaction timestamp in [Epoch time](https://www.epoch101.com/). Example: `1754307361396`.

**amount** `number`

Transaction amount in the player's local currency.

**amountUsd** `number`

Transaction amount in USD cents. Example: `76136`.

**totalTaxAmount** `number`

Tax amount in the player's local currency.

**totalTaxAmountUsd** `number`

Tax amount in USD cents. Example: `6206`.

**currencyExchangeCostUsd** `number`

Currency exchange fee in USD cents.

**chargeBackFeeUsd** `number`

Chargeback fee in USD cents. Example: `20`.

**sessionMetadata** `any`

Session metadata for passing data to Appcharge to be returned later.

```json Event Payload theme={"system"}
{
  "eventName": "order.refunded",
  "eventId": "3f5bffbc-369e-4599-8c4d-abfe0ae0ef96",
  "timestamp": 1754307361396,
  "sessionId": "345397c6-d963-4aa4-a0ba-2aaca6c3ee05",
  "requestId": "23539478-c744-566a-c78c-c4cc7763ff62",
  "result": "success",
  "reason": null,
  "attributes": {
    "persona": "non_payer",
    "blackFridayTest": "Base_group"
  },
  "customer": {
    "id": "671e81bb-55ef-428b-97ba-f67783971e0d",
    "name": null,
    "email": null
  },
  "offer": {
    "externalId": "22ae81bb-55ef-428b-97ba-f67783971e4a",
    "type": "PopUp",
    "subType": "DailyBonus",
    "name": "Spring Is Here",
    "offerIndex": 1,
    "indexToCollect": 1,
    "tab": "Tab 1",
    "pricePoint": 800,
    "price": 800,
    "currencyCode": "USD",
    "products": [
      {
        "displayName": "Gold Coins",
        "productExternalId": "31ae81bb-55ef-428b-97ba-f67783971e553",
        "productQuantity": "1000"
      },
      {
        "displayName": "Silver Shield",
        "productExternalId": "9af1abb-55ef-428b-97ba-f677839716ac9",
        "productQuantity": "40"
      }
    ]
  },
  "order": {
    "id": "695b72ff0e34d3a514b6eda0",
    "orderType": "Paid",
    "subtotal": 77700,
    "discountAmount": -7770,
    "totalPayment": 76136,
    "taxAmount": 6206,
    "currencyCode": "USD",
    "currencySymbol": "$",
    "paymentMethod": "Credit Card",
    "isSavedPaymentMethodUsed": true,
    "isNewPaymentMethodSaved": true,
    "pricePointMetadata": 77700
  },
  "coupon": {
    "name": "Birthday Promo",
    "promoCodeName": "BIRTHDAY10",
    "discount": -7770,
    "discountPercentage": 10
  },
  "storeMetadata": {
    "offerType": "Bundle",
    "offersSequenceIndex": 1
  },
  "device": {
    "platform": null,
    "deviceModel": null,
    "osType": "Apple",
    "osVersion": "18",
    "browserType": "Google Chrome",
    "browserVersion": "138"
  },
  "geolocation": {
    "countryCode2": "US",
    "region": null,
    "ipAddress": null,
    "zipCode": null
  },
  "transactions": [
    {
      "purchaseId": "pr_abbd0d529dea49f9a7adde2c3827c576",
      "type": "paid",
      "timestamp": 1767600954414,
      "amount": 76136,
      "amountUsd": 2506,
      "totalTaxAmount": 6206,
      "totalTaxAmountUsd": 6206,
      "currencyExchangeCostUsd": 0,
      "chargeBackFeeUsd": 20
    },
    {
      "purchaseId": "pr_abbd0d529dea49f9a7adde2c3827c576",
      "type": "refund",
      "timestamp": 1771180700780,
      "amount": -76136,
      "amountUsd": -2506,
      "totalTaxAmount": -6206,
      "totalTaxAmountUsd": -6206,
      "currencyExchangeCostUsd": 0,
      "chargeBackFeeUsd": 0
    }
  ],
  "sessionMetadata": { "abTest": "group1", "locale": "en-US" }
}
```
