An event that triggers when an order is purchased.
The onOrderPurchased()
event handler runs when an order is purchased.
The received OrderPurchasedEvent
object contains information about the order that was purchased.
An order is considered purchased if:
Note: Backend events don't work when previewing your site.
function onOrderPurchased(event: OrderPurchasedEvent): void;
Information about the order that was purchased and metadata for the event.
// Place this code in the events.js file
// of your site's Backend section.
// Add the file if it doesn't exist.
export function wixPricingPlans_onOrderPurchased(event) {
const orderId = event.data.order._id;
const eventId = event.metadata.id;
const eventTime = event.metadata.eventTime;
}
/* Full event object:
* {
* "metadata": {
* "id":"f2e01b16-48c3-4365-89c7-1e3710639f50",
* "entityId":"938ca26d-41e0-4aae-81a2-286ae9afd6ef",
* "eventTime":"2022-07-26T14:59:49.951623Z",
* "triggeredByAnonymizeRequest":false
* },
* "data": {
* "order": {
* "_id":"938ca26d-41e0-4aae-81a2-286ae9afd6ef",
* "planId":"099e2c86-3b7e-4477-8c27-f77402b8cceb",
* "subscriptionId":"1b879750-b4c3-4b17-9687-1f18f6b0ea19",
* "wixPayOrderId":"3eb01dc8-45c7-426f-a910-13d8c6008532",
* "buyer": {
* "memberId":"ea3d74df-b7dc-4ca1-a7c9-c416b9017a86",
* "contactId":"ea3d74df-b7dc-4ca1-a7c9-c416b9017a86"
* },
* "priceDetails": {
* "subtotal":"74.99",
* "discount":"0",
* "total":"74.99",
* "planPrice":"74.99",
* "currency":"EUR",
* "subscription": {
* "cycleDuration": {
* "count":1,
* "unit":"MONTH"
* },
* "cycleCount":3
* }},
* "pricing": {
* "subscription": {
* "cycleDuration": {
* "count":1,
* "unit":"MONTH"
* },
* "cycleCount":3
* },
* "prices": [{
* "duration": {
* "cycleFrom":1,
* "numberOfCycles":3
* },
* "price": {
* "subtotal":"74.99",
* "discount":"0",
* "total":"74.99",
* "currency":"EUR"
* }
* }]},
* "type":"OFFLINE",
* "orderMethod":"UNKNOWN",
* "status":"ACTIVE",
* "autoRenewCanceled":false,
* "lastPaymentStatus":"PAID",
* "startDate":"2022-01-25T16:23:00.000Z",
* "endDate":"2022-04-25T16:23:00.000Z",
* "pausePeriods":[],
* "earliestEndDate":"2022-04-25T16:23:00.000Z",
* "currentCycle": {
* "index":3,
* "startedDate":"2022-03-25T16:23:00.000Z",
* "endedDate":"2022-04-25T16:23:00.000Z"
* },
* "planName":"Platinum Pro",
* "planDescription":"",
* "planPrice":"74.99",
* "_createdDate":"2022-07-26T14:59:49.314Z",
* "_updatedDate":"2022-07-26T14:59:49.314Z"
* }
* }
* }
*/
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.