Page History

Events

Name

Parameters

Supported Platforms

Description

PRODUCT_PURCHASED

packageName (String)
productId (String)
transactionId (String)
deviceId or accountId

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

Triggered for a new one-time product purchase (single purchase). NOTE: A purchase is considered new, if the receipt was uploaded within 10 minutes of purchasing.

PRODUCT_CANCELLED

packageName (String)
productId (String)
transactionId (String)
deviceId or accountId

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

Triggered when a one-time product purchase (single purchase) was cancelled, e.g. due to a refund by

customer

Apple support / the developer.

SUBSCRIPTION_PURCHASED

Name	Type	Description
packageName

(

String

)


productId

(

String

)


transactionId

(String)

deviceId or accountId (String)

trialPeriod (Boolean)

	String
originalTransactionId	String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId
trialPeriod	Boolean
introOfferPeriod	Boolean

introOfferPeriod (Boolean)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

Triggered for new subscription purchases. NOTE: A purchase is considered new, if the receipt was uploaded within 10 minutes of purchasing.

SUBSCRIPTION_UPGRADED

packageName (String)
previousProductId (String)
nextProductId (String)
transactionId (String)
deviceId or accountId (String)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The subscripton has been upgraded by the user.

For iOS: The current subscription will end immediately and then the new one will start.

For Android: A subscription has been changed to a different product and the new subscription has a higher price. The start of the new subscription depends on the selected proration mode during purchase.

SUBSCRIPTION_DOWNGRADED

packageName (String)
previousProductId (String)
nextProductId (String)
transactionId (String)
deviceId or accountId (String)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The subscripton has been downgraded by the user.

For iOS: The current subscription will end normally and then the new one will start.

For Android: A subscription has been changed to a different product and the new subscription has a lower price. The start of the new subscription depends on the selected proration mode during purchase.

SUBSCRIPTION_RESUBSCRIBED

Name	Type	Description
packageName

(

String

)


productId

(

String

)


transactionId

(String)

deviceId or accountId (

String

)

status

Status

subtle	true
colour	Yellow
title	iOS

originalTransactionId

subtletruecolourGreentitleAndroid

String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

A previously expired subscription has ben restarted/resubscribed by the user.

SUBSCRIPTION_RESUBSCRIBED_OTHER

packageName (String)
previousProductId (String)
nextProductId (String)
transactionId (String)
deviceId or accountId (String)

Status

subtle	true
colour	Yellow
title	iOS

A subscription has expired; user resubscribed to another SKU (upgrade or downgrade)

SUBSCRIPTION_CANCELLED

packageName (String)

Name	Type	Description
packageName	String
productId

(

String

)


transactionId

(String)

deviceId or accountId (

String

)

status

Status

subtle	true
colour	Yellow
title	iOS

originalTransactionId

subtletruecolourGreentitleAndroid

String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

Triggered when the renewal of a subscription has been cancelled by the user. The subscription will continue until the expiration date is reached.

SUBSCRIPTION_CANCELLED_INVOLUNTARY

packageName (String)

Name	Type	Description
packageName	String
productId

(

String

)


transactionId

(String)

deviceId or accountId (

String

)

status

Status

subtle	true
colour	Yellow
title	iOS

originalTransactionId

subtletruecolourGreentitleAndroid

String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

A subscription has been cancelled after it failed to renew the subscription due to billing problems.

SUBSCRIPTION_RENEWED

packageName (String)

Name	Type	Description
packageName	String
productId

(

String

)


transactionId

(String)

	String
originalTransactionId	String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

deviceId or accountId (String)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The subscription has been renewed for another period.

SUBSCRIPTION_RENEWAL_FAILED

Name	Type	Description
packageName

(

String

)


productId

(

String

)


transactionId

(String)

	String
originalTransactionId	String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

deviceId or accountId (String)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The subscription could not be renewed due to billing issues. It is still active and the system will retry to renew it.

When it succeeds it will result in a SUBSCRIPTION_RECOVERED event or if it fails in a SUBSCRIPTION_CANCELLED_INVOLUNTARY event,

SUBSCRIPTION_RECOVERED

Name	Type	Description
packageName

(

String

)


productId

(

String

)


transactionId

(String)

deviceId or accountId (

String

)

status

Status

subtle	true
colour	Yellow
title	iOS

originalTransactionId

subtletruecolourGreentitleAndroid

String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

A subscription that previously failed to renew has been renewed / recovered.

SUBSCRIPTION_EXPIRED

Name	Type	Description
packageName

(

String

)


productId

(

String

)


transactionId

(String)

	String
originalTransactionId	String	An identifier that stays the same across all events for this subscription
deviceId	String	mutually exclusive with accountId
accountId	String	mutually exclusive with deviceId

deviceId or accountId (String)

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The subscription reached its expiration date and is now considered expired.

ACCOUNT_ASSIGNMENTS_CHANGED

Name	Type	Description
appId	String
accountId	String

Status


subtle	true
colour	Green
title	Android

Status

subtle	true
colour	Yellow
title	iOS

The assignments of an account changed

Event format

Code Block

language	js
title	Example

{
  "version": "1.0",
  "type": "SUBSCRIPTION_CANCELEDCANCELLED",
  "properties": {
    "deviceId": "1122334455",
	"productId": "com.example.product1"
  },
  "eventTimeMillis": 11223344L
}

Code Block

language	js
title	JSON Schema

{
  "$schema": "https://json-schema.org/draft-07/schema#",
  "contentMediaType": "application/vnd+sprylab.purple.aeb.event+json",
  "title": "Event",
  "properties": {
    "version": {
      "type": "string",
      "const": "1.0"
    },
    "type": {
      "type": "string"
    },
    "eventTimeMillis": {
      "type": "number"
    },
    "properties": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "type",
    "properties",
    "eventTimeMillis"
  ]
}

Page tree

Versions Compared

Old Version 4

New Version Current

Key

Events

Event format