Skip to content

The Transaction event type has one action, TransactionProcessed. Nexus sends it when it processes a transaction attributed to a creator in your program. The payload below is the event field of the standard notification envelope (eventId, createdAt, eventType, eventAction, event) documented in the webhooks guide.

Only program Admins can manage webhooks.

  1. In the Publisher Dashboard, open your program and select Webhooks.
  2. Select Add webhook.
  3. Enter your Endpoint URL, choose Transaction under Event, and select Add webhook.
  4. Copy the Signing secret to your server. Use it to verify each notification.
The Add webhook dialog with an endpoint URL entered and the Transaction event selected.The Add webhook dialog with an endpoint URL entered and the Transaction event selected.

Each program has one endpoint per event type. Nexus sends a transaction to the endpoint configured when it processes that transaction, and does not send it later to an endpoint you add afterward.

Nexus creates one TransactionProcessed event for each transaction it processes, whether you recorded the transaction with the API or it came from a webshop, a storefront, or Xsolla. Nexus processes only transactions with the Normal or Preorder status, so a transaction you record with status Test sends no event. A pre-order sends its event when you record it, with transactionStatus Preorder. A later change to the transaction, such as a refund or fulfilling a pre-order, does not send a second event.

Retries can deliver the same event more than once, with the same eventId. Handle duplicates before you act on an event, so a retry never credits a creator twice.

{
"attributionGroupId": "Q7mXwP2rLs9dTk4vBn8Zc",
"attributionGroupName": "Great Game Creator Program",
"transaction": {
"id": "T5vRk2NwQ8xLm3Pz7HcYa",
"code": "juniperjolt",
"memberId": "J3nPq8wLx2Vr6TzKa9mYd",
"memberPlayerId": "player_7f3a91c2",
"memberPlayerMetadata": {
"displayName": "JuniperJolt"
},
"transactionId": "4b8e1f2a-6c3d-4e5f-9a7b-1c2d3e4f5a6b",
"transactionDate": "2026-06-03T21:03:18.000Z",
"transactionStatus": "Normal",
"origin": "API",
"description": "Gold Pack 5",
"skuId": "Gold_Pack_5",
"platform": "Android",
"playerId": "player_d56a467b7a3c145c",
"playerName": "",
"currency": "USD",
"subtotal": 1999,
"total": 1999,
"totalCurrency": "USD",
"memberSharePercent": 20,
"memberShareAmount": 2.7986,
"creatorPaid": false,
"metrics": {
"joinDate": "2023-12-05T06:15:23.578Z",
"conversion": {
"lastPurchase": {
"date": "2024-12-06T03:44:57.881Z",
"platform": "Apple"
},
"totalSpendToDate": {
"total": 15992,
"currency": "USD"
}
}
}
}
}
FieldTypeNotes
attributionGroupIdstringThe ID of the Creator Group the transaction belongs to.
attributionGroupNamestringThe name of that Creator Group.
transactionobjectThe processed transaction, described below.

These fields are always present.

FieldTypeNotes
idstringThe Nexus ID for this transaction.
memberIdstringThe Nexus ID of the creator credited with the transaction.
transactionIdstringYour ID for the transaction, as you sent it.
transactionDateRFC3339 stringWhen the purchase happened.
transactionStatusenumNormal, or Preorder for a purchase you recorded as a pre-order.
originenumWhere the transaction came from: API, WebshopCode, StorefrontCode, or Xsolla.
descriptionstringThe product description.
playerNamestringThe player name you sent, or an empty string.
currencyenumThe ISO currency code of subtotal, such as USD or JPY.
subtotalintegerThe purchase subtotal in the smallest unit of currency (USD 19.99 → 1999).
creatorPaidbooleanWhether Nexus has paid the creator their share. Nexus sends this event when it processes the transaction, before the creator is paid, so this is normally false.

These fields can be absent or null.

FieldTypeNotes
codestringThe creator code used for the purchase.
memberPlayerIdstringThe player ID you linked to this creator’s membership in your program. Absent if the creator has not linked their Nexus account.
memberPlayerMetadataobjectDetails stored with that link. Contains displayName.
skuIdstringThe SKU ID you sent.
platformstringThe platform you sent.
playerIdstringYour ID for the player who made the purchase, or an empty string if you did not send one.
totalintegerThe purchase total in the smallest unit of totalCurrency.
totalCurrencyenumThe ISO currency code of total.
memberSharePercentnumberThe creator’s revenue share rate for this transaction, as a percentage before fees (20 means 20%).
memberShareAmountnumberThe creator’s share of this transaction in US dollars, after fees and any agency share, whatever the transaction’s currency (2.7986 means $2.7986).
metricsobjectThe player metrics you sent. See Performance metrics.
playerJoinDateRFC3339 stringPresent only if your request used the legacy top-level playerJoinDate field. If your request did not set metrics.joinDate, Nexus copies this value there.
playerLastPurchaseRFC3339 stringPresent only if your request used the legacy top-level playerLastPurchase field. If your request did not set metrics.conversion.lastPurchase.date, Nexus copies this value there.