Dispute Opened

An event triggered when a payment dispute is opened, for example, a chargeback is initiated by the player with their payment provider. Event Data

eventName

string

Event name: order.dispute.opened.

eventId

string

Event ID.

timestamp

number

Event timestamp in Epoch time, represented in milliseconds. Example: 1754307361396.

sessionId

string

The 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

Not in use.

reason

string

Reason for the event result. Example: invalid_credentials.

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.

Show properties

string

Customer ID.

string

Player’s email address.

name

string

Currently null. Reserved for the player’s name in future versions.

offer

object

List of offers.

Show 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

Currently null. Reserved for the index to collect in future versions.

tab

string

Currently null. 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.

currencyCode

string

Currency code of the offer in ISO_4217 format.

products

[object]

List of products in an offer.

Show 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

Show properties

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

Show properties

offersSequenceIndex

number

Index of the sub-offer within an offer.

offerType

string

Offer type.

coupon

object

Information about the coupon.

Show properties

name

string

Coupon name.

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.

geolocation

object

Information about the player’s geolocation.

Show properties

countryCode2

enum

Two-letter country code in ISO-3166 alpha-2 format. Example: US

region

string

Region or state.

ipAddress

string

IP address in IPv4 format. Example: 80.178.249.122.

zipCode

string

Zip code.

transactions

[object]

Information about each transaction.

Show properties

purchaseId

string

Purchase ID.

type

string

Transaction type.

timestamp

number

Transaction timestamp in Epoch time. 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.

{
  "eventName": "order.dispute.opened",
  "eventId": "3f5bffbc-369e-4599-8c4d-abfe0ae0ef96",
  "timestamp": 1754307361396,
  "sessionId": "345397c6-d963-4aa4-a0ba-2aaca6c3ee05",
  "requestId": "23539478-c744-566a-c78c-c4cc7763ff62",
  "result": null,
  "reason": "invalid_credentials",
  "attributes": {
    "persona": "non_payer",
    "blackFridayTest": "Base_group"
  },
  "customer": {
    "id": "671e81bb-55ef-428b-97ba-f67783971e0d",
    "email": "john.doe@gmail.com",
    "name": "John Doe"
  },
  "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
  },
  "geolocation": {
    "countryCode2": "US",
    "region": "NY",
    "ipAddress": "185.199.103.227",
    "zipCode": "10118"
  },
  "transactions": [
    {
      "purchaseId": "pr_abbd0d529dea49f9a7adde2c3827c576",
      "type": "paid",
      "timestamp": 1767600954414,
      "amount": 76136,
      "amountUsd": 2506,
      "totalTaxAmount": 6206,
      "totalTaxAmountUsd": 6206,
      "currencyExchangeCostUsd": 0,
      "chargeBackFeeUsd": 0
    },
    {
      "purchaseId": "pr_abbd0d529dea49f9a7adde2c3827c576",
      "type": "dispute_funds_withdrawn",
      "timestamp": 1771186042504,
      "amount": -76136,
      "amountUsd": -2506,
      "totalTaxAmount": -6206,
      "totalTaxAmountUsd": -6206,
      "currencyExchangeCostUsd": 0,
      "chargeBackFeeUsd": 1500
    }
  ],
  "sessionMetadata": { "abTest": "group1", "locale": "en-US" }
}

Overview

What's New

Web Store

Checkout

Game Portal

Media

Events Center

Translations