Dispute Events

Manage and track post-purchase disputes, such as refunds and chargebacks, which may not involve direct player interaction.

order_refunded

timestamp

Number

The time when the event occurred.

Example 1632345000

appChargePaymentId

String

The Appcharge payment ID for the event.

Example pay_12345

appChargeOrderId

String

The Appcharge order ID for the event.

Example order_12345

playerId

String

The unique identifier of the player involved in the order.

Example player_12345

sessionMetadata

Object (Optional)

Additional session data sent during Authentication or Data Sync.

Example {"device": "mobile", "region": "US"}

paymentMethod

String (Optional)

The payment method used for the transaction.

Example credit_card

reason

String (Optional)

Error reason in case of a failure.

Example insufficient_funds

offer

Object

Details about the offer associated with the order.

Offer Details

offerName

String

The name of the offer.

Example Special Bundle

offerInternalId

String

The Appcharge offer ID.

Example offer_12345

offerExternalId

String

The publisher's offer ID.

Example ext_offer_12345

originalPriceInDollar

Number

The base price of the offer in USD.

Example 10.00

country

String

The ISO 3166-1 alpha-2 country code of the player.

Example US

currency

String

The ISO 4217 currency code used for the payment.

Example USD

priceInDollar

Number

The paid price without taxes, converted to USD in real-time.

Example 8.00

priceInCents

Number

The paid price in local currency (in cents).

Example 800

subtotal

Number

The price paid by the player in local currency, excluding taxes.

Example 750

tax

Number

The tax amount paid by the player (in cents of local currency).

Example 50

promoCodeName

String

The name of the promo code being applied.

Example PROMO10

discount

Float

The discount amount in the currency the order was placed in.

Example 1.00

discountRatePoints

String

The rate of the discount as a percentage.

Example 10%

products

Array

A list of products included in the offer.

Product Details

name

String

The name of the product.

Example Deluxe Skin

sku

String

The publisher's product ID.

Example prod_12345

amount

Number

The quantity of the purchased product.

Example 1

Example Payload

Here is an example of what the payload might look like:


{
    "timestamp": 1632345000,
    "appChargePaymentId": "pay_12345",
    "appChargeOrderId": "order_12345",
    "playerId": "player_12345",
    "sessionMetadata": {"device": "mobile", "region": "US"},
    "paymentMethod": "credit_card",
    "reason": "insufficient_funds",
    "offer": {
        "offerName": "Special Bundle",
        "offerInternalId": "offer_12345",
        "offerExternalId": "ext_offer_12345",
        "originalPriceInDollar": 10.00,
        "country": "US",
        "currency": "USD",
        "priceInDollar": 8.00,
        "priceInCents": 800,
        "subtotal": 750,
        "tax": 50,
        "promoCodeName": "PROMO10",
        "discount": 1.00,
        "discountRatePoints": "10%",
        "products": [
            {
                "name": "Deluxe Skin",
                "sku": "prod_12345",
                "amount": 1
            }
        ]
    }
}

order_dispute_open

timestamp

Number

The time when the event occurred.

Example 1632345000

appChargePaymentId

String

The Appcharge payment ID for the event.

Example pay_12345

appChargeOrderId

String

The Appcharge order ID for the event.

Example order_12345

playerId

String

The unique identifier of the player involved in the order.

Example player_12345

sessionMetadata

Object (Optional)

Additional session data sent during Authentication or Data Sync.

Example {"device": "mobile", "region": "US"}

paymentMethod

String (Optional)

The payment method used for the transaction.

Example credit_card

reason

String (Optional)

Error reason in case of a failure.

Example insufficient_funds

offer

Object

Details about the offer associated with the order.

Offer Details

offerName

String

The name of the offer.

Example Special Bundle

offerInternalId

String

The Appcharge offer ID.

Example offer_12345

offerExternalId

String

The publisher's offer ID.

Example ext_offer_12345

originalPriceInDollar

Number

The base price of the offer in USD.

Example 10.00

country

String

The ISO 3166-1 alpha-2 country code of the player.

Example US

currency

String

The ISO 4217 currency code used for the payment.

Example USD

priceInDollar

Number

The paid price without taxes, converted to USD in real-time.

Example 8.00

priceInCents

Number

The paid price in local currency (in cents).

Example 800

subtotal

Number

The price paid by the player in local currency, excluding taxes.

Example 750

tax

Number

The tax amount paid by the player (in cents of local currency).

Example 50

promoCodeName

String

The name of the promo code being applied.

Example PROMO10

discount

Float

The discount amount in the currency the order was placed in.

Example 1.00

discountRatePoints

String

The rate of the discount as a percentage.

Example 10%

products

Array

A list of products included in the offer.

Product Details

name

String

The name of the product.

Example Deluxe Skin

sku

String

The publisher's product ID.

Example prod_12345

amount

Number

The quantity of the purchased product.

Example 1

Example Payload

Here is an example of what the payload might look like:


{
    "timestamp": 1632345000,
    "appChargePaymentId": "pay_12345",
    "appChargeOrderId": "order_12345",
    "playerId": "player_12345",
    "sessionMetadata": {"device": "mobile", "region": "US"},
    "paymentMethod": "credit_card",
    "reason": "insufficient_funds",
    "offer": {
        "offerName": "Special Bundle",
        "offerInternalId": "offer_12345",
        "offerExternalId": "ext_offer_12345",
        "originalPriceInDollar": 10.00,
        "country": "US",
        "currency": "USD",
        "priceInDollar": 8.00,
        "priceInCents": 800,
        "subtotal": 750,
        "tax": 50,
        "promoCodeName": "PROMO10",
        "discount": 1.00,
        "discountRatePoints": "10%",
        "products": [
            {
                "name": "Deluxe Skin",
                "sku": "prod_12345",
                "amount": 1
            }
        ]
    }
}

order_dispute_won

timestamp

Number

The time when the event occurred.

Example 1632345000

appChargePaymentId

String

The Appcharge payment ID for the event.

Example pay_12345

appChargeOrderId

String

The Appcharge order ID for the event.

Example order_12345

playerId

String

The unique identifier of the player involved in the order.

Example player_12345

sessionMetadata

Object (Optional)

Additional session data sent during Authentication or Data Sync.

Example {"device": "mobile", "region": "US"}

paymentMethod

String (Optional)

The payment method used for the transaction.

Example credit_card

reason

String (Optional)

Error reason in case of a failure.

Example dispute_won

offer

Object

Details about the offer associated with the order.

Offer Details

offerName

String

The name of the offer.

Example Special Bundle

offerInternalId

String

The Appcharge offer ID.

Example offer_12345

offerExternalId

String

The publisher's offer ID.

Example ext_offer_12345

originalPriceInDollar

Number

The base price of the offer in USD.

Example 10.00

country

String

The ISO 3166-1 alpha-2 country code of the player.

Example US

currency

String

The ISO 4217 currency code used for the payment.

Example USD

priceInDollar

Number

The paid price without taxes, converted to USD in real-time.

Example 8.00

priceInCents

Number

The paid price in local currency (in cents).

Example 800

subtotal

Number

The price paid by the player in local currency, excluding taxes.

Example 750

tax

Number

The tax amount paid by the player (in cents of local currency).

Example 50

promoCodeName

String

The name of the promo code being applied.

Example PROMO10

discount

Float

The discount amount in the currency the order was placed in.

Example 1.00

discountRatePoints

String

The rate of the discount as a percentage.

Example 10%

products

Array

A list of products included in the offer.

Product Details

name

String

The name of the product.

Example Deluxe Skin

sku

String

The publisher's product ID.

Example prod_12345

amount

Number

The quantity of the purchased product.

Example 1

Example Payload

Here is an example of what the payload might look like:


{
    "timestamp": 1632345000,
    "appChargePaymentId": "pay_12345",
    "appChargeOrderId": "order_12345",
    "playerId": "player_12345",
    "sessionMetadata": {"device": "mobile", "region": "US"},
    "paymentMethod": "credit_card",
    "reason": "dispute_won",
    "offer": {
        "offerName": "Special Bundle",
        "offerInternalId": "offer_12345",
        "offerExternalId": "ext_offer_12345",
        "originalPriceInDollar": 10.00,
        "country": "US",
        "currency": "USD",
        "priceInDollar": 8.00,
        "priceInCents": 800,
        "subtotal": 750,
        "tax": 50,
        "promoCodeName": "PROMO10",
        "discount": 1.00,
        "discountRatePoints": "10%",
        "products": [
            {
                "name": "Deluxe Skin",
                "sku": "prod_12345",
                "amount": 1
            }
        ]
    }
}