Transaction Events

When subscribed to the Transaction events webhook, the following event data will be received:

event object

Field nameDescriptionJSON TypeData Type
idThe unique ID of the event. May be used to ensure that an event is not processed twice in the case of a webhook that is re-tried due to an error or timeout.string
createdDateA timestamp signifying when the event was generated.
Format: YYYY-MM-DDThh:mm:ss[.SSS]Z
Note: millisecond is denoted as optional [.SSS]
stringdatetime
typeEvent type:
transaction
string
actionEvent action:
created
string
payloadThe payload of the event. The contents of this object depend on the type of event.objectpayload

payload object

Field nameDescriptionJSON TypeData Type
transactionDateThe date/time that the transaction occurred at:
Format: YYYY-MM-DDThh:mm:ss[.SSS]Z
Note: millisecond is denoted as optional [.SSS]
stringdatetime
businessIdThe business Id of the transactionstring
businessAliasThe alias (nickname) of the businessstring
transactionIdMatches deposit report transaction id. Records only have this column populated if was done using a Vagaro merchant accountstring
userPaymentIdThe unique identifier for the transaction item.string
userPaymentsMstIdDefines unique transactionstring
brandNameThe brand name of the item sold.string
itemSoldThe description of the item sold. Shows services and productsstring
purchaseTypePurchase type:
Class
Class Add-Ons
Fees
Gift Certificate
IOU Cleared
Membership
Package
Product
Refund
Rent & Fees
Service
Service Add-Ons
Invoice
Contactless Checkout
Cancellation Fee
No-Show Fee
Vagaro Pay Later
string
quantityThe quantity of items soldnumericlong
ccAmountAmount paid with credit cardnumericcurrency
cashAmountAmount paid with cashnumericcurrency
checkAmountAmount paid with checknumericcurrency
achAmountAmount paid with ACHnumericcurrency
packageRedemptionAmount redemption by package.numericcurrency
bankAccountAmountAmount paid by bank amount (VPL)numeric currency
vagaroPayLaterAmountAmount paid with Vagaro Pay Laternumericcurrency
otherAmountAmount paid by other payment method.numericcurrency
pointsAmount paid by pointsnumericlong
gcRedemptionAmount redemption by gift certificate.numericcurrency
taxTax amount numericcurrency
tipTip amount givennumericcurrency
discountDiscount given for transaction:numericcurrency
memberShipAmountThe membership discount amountnumericcurrency
productDiscountAny discount given to a productnumericcurrency
ccTypeCredit card type used:
Visa
Master-Card
Discover
American Express
Vagaro Pay Later
Other
string
ccModeCredit card mode used:
C: Chip
E: ACH
I: Interac
N: Tap/NFC
P: Tap to Pay
S: Swiped
T: Typed
string
customerIdThe customer Id associated with this transactionstring
serviceProviderIdThe service provider Id string
businessGroupIdA unique identifier for a multilocation group.string
amountDueAmount due after transaction paid.numericcurrency
appointmentIdThe appointment Id associated with the transactionstring
serviceCategoryThe service category string
createdByUser that created the transactionstring

Example

{
	"id": "254FA623-D2B0-4785-A07D-A1A7059C74FF",
	"createdDate": "2024-02-15T00:00:00Z",
	"type": "transaction",
	"action": "created",
	"payload": {
		"transactionDate": "2024-02-12T14:37:43.5Z",
		"businessId": "U2FsdGVkX18zRbwyUxRZaHNTYGwjKCpDdAkKP4eUDsE=",
		"transactionId": "a--PdjdyYWJSkudXA2BFK0TkRV7gN2yxC=",
		"userPaymentId": "ZOpfSwCHhVSl1UZJ2p3Pfw==",
		"userPaymentMstId": "ZOpfSwCHhVSl1UZJ2p3Pfw==",
		"brandName": "",
		"itemSold": "Color & Haircut",
		"purchaseType": "Service",
		"quantity": 1,
		"ccAmount": 0.0,
		"cashAmount": 0.0,
		"checkAmount": 0.0,
		"achAmount": 0.0,
		"bankAccountAmount": 0.0,
		"vagaroPayLaterAmount": 0.0,
		"otherAmount": 0.0,
		"pointsAmount": 0,
		"packageRedemption": 0.0,
		"gcRedemption": 0.0,
		"tax": 0.0,
		"tip": 0.0,
		"discount": 0.0,
		"memberShipAmount": 0.0,
		"productDiscount": 0.0,
		"ccType": "",
		"ccMode": "",
		"customerId": "681550E7A9CDA57700B419E351D50D80",
		"serviceProviderId": "D5532D70624D433AD5EA6B5B7A2E5D31",
		"businessGroupId": "tYKEZF-L445YEDnCx0TIfA==",
		"amountDue": 0.0,
		"appointmentId": "2dwfErtmMAFxe6hoCnQStw==",
		"serviceCategory": "Hair Care",
		"createdBy": "GVkX18zRbwyUxRZaHNTYGwjK"
	}
}

What’s Next