Notification Reference

Base Notification Content

These fields are present in all notification payloads, regardless of type.

Name	Description	R / O
subject	Event entity type (order, subscription, endUser, etc.)	R
type	Notification event type (e.g. completed, deleted)	R
objectId	Entity identifier (orderId, subscriptionId, endUserId, etc.)	R
eventDate	ISO 8601 date of the event	R

Notifications list

Name	Payload	Subject	Type
Cart Abandoned	ABANDONED_CART	cart	abandoned
Consent Created	CONSENT_CREATED	consent	created
Consent Updated	CONSENT_UPDATED	consent	updated
EndUser Deleted	END_USER_DELETED	endUser	deleted
Credit Card Added	PAYMENT_METHOD_ADDED	endUser	paymentMethodAddedToWallet
Payment Method Deleted	PAYMENT_METHOD_ADDED	endUser	paymentMethodAddedToWallet
Recurring Payment Method Added	PAYMENT_METHOD_ADDED	endUser	paymentMethodAddedToWallet
SEPA Payment Method Added	PAYMENT_METHOD_ADDED	endUser	paymentMethodAddedToWallet
Subscription Payment Method Updated	PAYMENT_METHOD_UPDATED	endUser	subscriptionPaymentMethodUpdated
Reseller Request Approved	RESELLER	endUser	completed
Reseller Request Declined	RESELLER	endUser	declined
Reseller Request OnBoarding	RESELLER	endUser	onBoardingRequest
Identity created	IDENTITY	identity	created
Identity deleted	IDENTITY	identity	deleted
Identity updated	IDENTITY	identity	updated
Package Threshold Reached	LICENSE_KEY_PACKAGE	licenseKeyPackage	thresholdReached
Permission - profile created	META_ROLE	metarole	created
Permission - profile deleted	META_ROLE	metarole	deleted
Permission - profile updated	META_ROLE	metarole	updated
Offer Prebilling Started	ORDER_AND_SUBSCRIPTION	order	prebillingStarted
Order Canceled With Content Including Subscription Data	ORDER_AND_SUBSCRIPTION	order	canceled
Order Completed With Content Including Subscription Data	ORDER_AND_SUBSCRIPTION	order	completed
Prebilling Order Created	ORDER_AND_SUBSCRIPTION	order	prebillingStarted
Subscription Order Renew Completed	ORDER_AND_SUBSCRIPTION	order	renewCompleted
Subscription Order Renew Completed (offer)	ORDER_AND_SUBSCRIPTION	order	renewCompleted
Offer Order Aborted	ORDER	order	aborted
Offer Order Created	ORDER	order	created
Order Aborted	ORDER	order	aborted
Order Canceled	ORDER	order	canceled
Order Completed	ORDER	order	completed
Order Completed With Error	ORDER	order	partiallyCompleted
Order Created	ORDER	order	created
Order Fulfillment Failed	ORDER	order	fulfillmentFailed
Order Partial Completed	ORDER	order	partialCompleted
Order Payment Failed	ORDER	order	paymentFailed
Order Payment Refused	ORDER	order	paymentRefused
Order payment refused with last error code	ORDER	order	paymentRefusedWithLastErrorCode
Partial refund completed successfully	ORDER	order	partialRefundCompleted
Partial refund completed with errors	ORDER	order	partialRefundFailed
Skeepers Purchase Event	SKEEPERS_PURCHASE_EVENT	order	completed
Permission - privilege created	PRIVILEGE	privilege	created
Permission - privilege deleted	PRIVILEGE	privilege	deleted
Permission - privilege updated	PRIVILEGE	privilege	updated
Permission - role created	ROLE	role	created
Permission - role deleted	ROLE	role	deleted
Permission - role updated	ROLE	role	updated
Subscription Discount Plan Updated	DISCOUNT_PLAN_UPDATED	subscription	discountPlanUpdated
Check payment method replayability on updated subscription	SUBSCRIPTION_PAYMENT_METHOD_REPLAYABILITY_CHANGED	subscription	subscriptionPaymentMethodReplayabilityChanged
Subscription Canceled	SUBSCRIPTION	subscription	canceled
Subscription Expiration Date Updated	SUBSCRIPTION	subscription	expirationDateUpdated
Subscription Expired	SUBSCRIPTION	subscription	expired
Subscription Reactivated	SUBSCRIPTION	subscription	reactivated
Subscription Suspended	SUBSCRIPTION	subscription	suspended
Subscription Unpaid	SUBSCRIPTION	subscription	unpaid
Scheduled Tax Rate Change Created	SCHEDULED_TAX_RATE	tax-management	scheduled_tax_rate
Scheduled Tax Rate Change Failed	SCHEDULED_TAX_RATE	tax-management	scheduled_tax_rate
Scheduled Tax Rate Change Updated	SCHEDULED_TAX_RATE	tax-management	scheduled_tax_rate
Tax Rate Created	TAX_RATE	tax-management	tax_rate
Tax Rate Deleted	TAX_RATE	tax-management	tax_rate
Tax Rate Failed	TAX_RATE	tax-management	tax_rate
Tax Rate Updated	TAX_RATE	tax-management	tax_rate

Payload schemas

AbandonedCartNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
checkoutUrl	string		O
companyName	string		O
customerId	string		O
firstName	string		O
lastName	string		O
locale	string		O
newsletterOptin	boolean		O
storeHostname	string		O
userEmailAddress	string		O

BaseNotificationContent

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R

ConsentNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
consent	consent.Consent		O
→ consents	consent.ConsentItem[]		O
— → type	string		O
— → lastLegalActionTimestamp	integer (int64)		O
— → lastUpdateReason	string		O
— → status	boolean		O
→ source	string		O
→ updateDate	string (date-time)		O
→ userEmail	string		O

MetaRoleNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
metaRole	permission.MetaRole		O
→ id	string		O
→ name	string		O
userName	string		O

OrderNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
order	order.Order		R
→ cancellationDate	string (date-time)	Cancellation timestamp in ISO 8601 format	O
→ cancellationReason	string	Reason for order cancellation	O
→ cartId	string	Associated cart identifier	O
→ consentFlags	order.ConsentFlags		R
— → newsletterOptin	boolean	Marketing newsletter consent indicator	R
→ creationDate	string (date-time)	Order creation date in ISO 8601 format	R
→ currency	string	Currency code, e.g. EUR, USD	R
→ customer	order.Customer		R
— → customerAccount	string	Realm/account name	R
— → id	string	Customer identifier	R
— → name	string		O
— → serveur	string		O
→ decodedExternalContext	object	Decoded cart parameters	O
→ externalContext	string	Base64 encoded string of cart parameters	O
→ id	string	Order identifier	R
→ items	order.LineItem[]	Order line items	R
— → activationCode	string	Product activation code	O
— → discountPlan	order.DiscountPlan		O
— — → discountStep	integer (int32)	Step in the discount plan	R
— — → ignorePurchaseDiscount	boolean	Whether to ignore discount on the initial purchase	O
— — → tag	string	Plan designation tag	R
— → discountRate	number (double)	Discount rate applied	O
— → expirationDate	string (date-time)	Product expiration timestamp in ISO 8601 format	O
— → externalContext	string	External context data	R
— → fulfillmentId	string	Fulfillment process identifier	O
— → id	string	Unique line item identifier	R
— → isUpsell	boolean	Upsell status marker	O
— → lineItemId	string	Line item identifier	R
— → pricing	order.Pricing		R
— — → allDiscountsApplied	com.nx.notification.externalapi.DiscountApplied[]	All discounts applied to this item	O
— — — → discountAmount	number (double)	Discount value	R
— — — → discountCode	string	Customer-facing discount code	O
— — — → discountId	string	Monetize discount identifier	R
— — — → discountRate	number (double)	Discount percentage, e.g. 0.2 for 20%	O
— — → cumulatedDiscountRate	number (double)	Total cumulated discount percentage	O
— — → unitPriceExclVAT	number (double)	Pre-tax unit cost	R
— — → unitPriceIncVAT	number (double)	Post-tax unit cost	R
— — → vatAmount	number (double)	Tax amount	O
— — → VATRate	number (double)	Tax rate percentage	R
— → priority	integer (int32)	Line item priority	O
— → product	order.Product		R
— — → name	string	Product name	R
— — → publisherReference	string	Publisher's internal product identifier	O
— — → uniqueReference	string	Unique product identifier on the Nexway Monetize platform	R
— → publisherFulfillmentId	string	Publisher fulfillment identifier	O
— → quantity	integer (int32)	Product quantity	R
— → subItems	order.SubItem[]	Nested line items	O
— — → activationCode	string		O
— — → externalContext	string		O
— — → fulfillmentId	string		O
— — → id	string		O
— — → product	order.Product		O
— — — → name	string	Product name	R
— — — → publisherReference	string	Publisher's internal product identifier	O
— — — → uniqueReference	string	Unique product identifier on the Nexway Monetize platform	R
— — → publisherFulfillmentId	string		O
— → subscription	subscription.Subscription		O
— — → createDate	string (date-time)	Creation date in ISO 8601 format	R
— — → discountPlan	subscription.DiscountPlan		O
— — — → nextDiscountStep	integer (int32)	Calculated next discount step value	R
— — — → startingStep	integer (int32)	Starting step	O
— — — → tag	string	Plan identifier	R
— — → enduserId	string	End-user UUID	R
— — → id	string	Subscription UUID	R
— — → lifecycle	subscription.LifeCycle		R
— — — → anniversaryDate	string (date-time)	Renewal/expiration date in ISO 8601 format	R
— — — → generation	integer (int32)	Renewal generation (term number)	R
— — — → id	string	Back-office subscription identifier (deprecated)	O
— — — → status	string	Status: Active, Suspended, Dunning, Canceled, Expired	R
— — → modelId	string	Model identifier, e.g. NEXWAY_1Y	R
— — → name	string	Product name	O
— — → paymentMethodIsNoLongerReplayable	boolean	Whether the payment method is no longer replayable	O
— — → paymentMethodIsNoLongerReplayableReason	string	Reason why the payment method is no longer replayable	O
— — → products	subscription.Product[]	Associated products	R
— — — → id	string	Product UUID	R
— — — → licenseId	string	License identifier	O
— — — → lineItemId	string	Order line item UUID	R
— — → source	string	Subscription source	O
— — → storeId	string	Store UUID	R
— → subscriptionId	string	Associated subscription identifier	O
— → trial	boolean	Trial status indicator	R
— → trialDuration	integer (int32)	Trial duration in days	O
— → unitPriceExclVAT	number (double)	Unit price excluding tax	R
— → unitPriceIncVAT	number (double)	Unit price including tax	R
— → VATRate	number (double)	Applied sales tax rate	R
→ offerSubSource	string	Sub-source designation, e.g. SUSPEND, RESUME	O
→ payment	order.Payment		O
— → amount	number (double)	Payment amount	O
— → automaticBilling	boolean	Whether the payment was automatically charged	R
— → externalContext	string	External context data	O
— → id	string	Payment identifier	R
— → lastError	order.LastPaymentError		O
— — → code	string	Error code	R
— — → message	string	Error description	O
— → method	string	Payment method, e.g. visa, mastercard, sepa, pix, boleto	O
— → silentOnFailure	boolean	Whether to suppress failure notifications	O
— → status	string	Payment status: COMPLETED, FAILED	R
— → transitionPaymentDate	string (date-time)	Transaction timestamp in ISO 8601 format	R
→ payments	order.Payment[]	All payment attempts	O
— → amount	number (double)	Payment amount	O
— → automaticBilling	boolean	Whether the payment was automatically charged	R
— → externalContext	string	External context data	O
— → id	string	Payment identifier	R
— → lastError	order.LastPaymentError		O
— — → code	string	Error code	R
— — → message	string	Error description	O
— → method	string	Payment method, e.g. visa, mastercard, sepa, pix, boleto	O
— → silentOnFailure	boolean	Whether to suppress failure notifications	O
— → status	string	Payment status: COMPLETED, FAILED	R
— → transitionPaymentDate	string (date-time)	Transaction timestamp in ISO 8601 format	R
→ refund	order.Refund		O
— → lineItems	order.RefundDetails[]		O
— — → initialAmount	number (double)		O
— — → productId	string		O
— — → productName	string		O
— — → ratio	number (double)		O
— — → refundAmount	number (double)		O
— — → refundMethod	string		O
— → totalAmountRefunded	number (double)		O
→ salesFlag	string[]	Sales flags	O
→ source	string	Order origin: PURCHASE, SUBSCRIPTION, OFFER, MANUAL_RENEWAL	R
→ status	string	Current order status	R
→ store	order.Store		R
— → id	string	Store identifier	R
→ totalPriceExclVAT	number (double)	Total price excluding sales tax	R
→ totalPriceIncVAT	number (double)	Total price including sales tax	R
→ user	order.EndUser		R
— → city	string	City	O
— → companyName	string	Company name	O
— → companyRegistrationNumber	string	Company registration number	O
— → country	string	Alpha-3 country code	R
— → email	string	Buyer email address	R
— → firstName	string	First name	O
— → id	string	Buyer identifier	R
— → language	string	Alpha-2 language code	O
— → lastName	string	Last name	O
— → region	string	Region	O
— → street	string	Street address	O
— → zipcode	string	Postal code	O

PackageThresholdReachedNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
customerName	string		O
licenseKeyPackage	lkp.Package		O
→ id	string		O
→ name	string		O
threshold	integer (int32)		O

PaymentMethodAddedNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
addedPaymentMethods	enduser.PaymentMethod[]	List of added payment instruments	R
→ type	string	Specific variant, e.g. visa, mastercard	R
→ _id	string	Unique payment method identifier	R
→ expirationDate	string	Expiration date	O
→ id	string	Payment method identifier	R
→ paymentMethodType	string	Broad classification, e.g. CreditCard	R
→ status	string	Activation state, e.g. ACTIVATED	R

PrivilegeNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
privilege	permission.Privilege		O
→ id	string		O
→ serviceName	string		O
userName	string		O

ResellerNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
reseller	enduser.EndUser		O
→ type	string		O
→ city	string		O
→ company	enduser.Company		O
— → name	string		O
— → vatNumber	string		O
→ country	string		O
→ creationDate	string (date-time)		O
→ email	string		O
→ firstName	string		O
→ id	string		O
→ lastName	string		O
→ phone	string		O
→ status	string		O
→ streetAddress	string		O
→ zipCode	string		O

RoleNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
role	permission.Role		O
→ id	string		O
→ name	string		O
userName	string		O

SubscriptionNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
subscription	subscription.Subscription		R
→ createDate	string (date-time)	Creation date in ISO 8601 format	R
→ discountPlan	subscription.DiscountPlan		O
— → nextDiscountStep	integer (int32)	Calculated next discount step value	R
— → startingStep	integer (int32)	Starting step	O
— → tag	string	Plan identifier	R
→ enduserId	string	End-user UUID	R
→ id	string	Subscription UUID	R
→ lifecycle	subscription.LifeCycle		R
— → anniversaryDate	string (date-time)	Renewal/expiration date in ISO 8601 format	R
— → generation	integer (int32)	Renewal generation (term number)	R
— → id	string	Back-office subscription identifier (deprecated)	O
— → status	string	Status: Active, Suspended, Dunning, Canceled, Expired	R
→ modelId	string	Model identifier, e.g. NEXWAY_1Y	R
→ name	string	Product name	O
→ paymentMethodIsNoLongerReplayable	boolean	Whether the payment method is no longer replayable	O
→ paymentMethodIsNoLongerReplayableReason	string	Reason why the payment method is no longer replayable	O
→ products	subscription.Product[]	Associated products	R
— → id	string	Product UUID	R
— → licenseId	string	License identifier	O
— → lineItemId	string	Order line item UUID	R
→ source	string	Subscription source	O
→ storeId	string	Store UUID	R

TaxRateNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
vatRate	taxManager.VatRate		O
→ failed	boolean		O
→ iso2CountryCode	string		O
→ newTaxRates	taxManager.TaxRate[]		O
— → taxCategory	string		O
— → taxName	string		O
— → value	number (double)		O
→ operation	string		O
→ regionCode	string		O
→ startDate	string (date-time)		O

TextNotification

Field	Type	Description	R/O
text	string		O

skeepers.SkeepersPurchaseEvent

Field	Type	Description	R/O
consumer	skeepers.Consumer		O
→ email	string		O
→ first_name	string		O
→ last_name	string		O
purchase_date	string		O
purchase_reference	string		O
sales_channel	skeepers.SalesChannel		O
→ channel	string		O
→ website_id	string		O
solicitation_parameters	skeepers.SolicitationParameters		O
→ delay	integer (int32)		O
→ purchase_event_type	string		O

subscription.PaymentMethodReplayabilityChangedNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
paymentMethod	subscription.PaymentMethod		O
→ type	string	Specific variant, e.g. visa, mastercard	R
→ expirationDate	string	The expiration date of the payment method mm/YY	O
paymentMethodNonReplayable	boolean		O
reasonDescription	string		O
warningReason	string		O

subscription.PaymentMethodUpdatedNotification

Field	Type	Description	R/O
subject	string	Notification subject, e.g. order, subscription, endUser	R
type	string	Event type, e.g. created, completed, paymentFailed	R
objectId	string	Unique identifier of the object that triggered the event	R
eventDate	string (date-time)	Timestamp of the event in ISO 8601 format	R
endUser	subscription.EndUser		R
→ expirationDate	string	The expiration date of the payment method mm/YY	O
→ id	string	The end user id	R
→ paymentMethod	string	Broad classification, e.g. CreditCard	O
→ paymentMethodName	string	Specific variant, e.g. visa, mastercard	O
→ subscriptionId	string	The subscription Id	R

Auto-generated from OpenAPI extension file by scripts/generateNotificationDocs.js