A rule has two main parts: conditions and a fee. When Calculate Service Fees is called, it assesses each rule in relation to the specified order. When a rule is assessed, if the conditions are met, the fee is included in the API's response.
Conditions can be either a single condition or a condition tree.
A single condition evaluates a specific field in the order. For example, it could check if the value of the field is greater than a certain number.
A condition tree contains two conditions and an operator. The conditions can each be either a single condition or a condition tree. There are two operator values:
"AND"
: Both conditions must be met for the condition tree to be considered met."OR"
: At least one of the conditions must be met for the condition tree to be considered met.For the service fee to be applied, we would need to satisfy these conditions:
50
"DELIVERY"
We have the following values:
70
"DELIVERY"
"WEBSITE"
In this case, the conditions are met, because the subtotal is greater than 50
and the delivery type is "DELIVERY"
. It doesn't matter that the platform isn't "MOBILE_APP"
because we only need that OR delivery type to be "DELIVERY"
.
We have the following values:
30
"DELIVERY"
"MOBILE_APP"
In this case, the conditions are not met, because even though the delivery type is "DELIVERY"
and the platform is "MOBILE_APP"
, the subtotal is not greater than 50
.
A fee is either a fixed amount or a percentage of the order's subtotal. It can also include tax.
If the conditions are met, the fee is calculated and applied when Calculate Service Fees is called.
The following table shows field support for filters and sorting for the rules object:
Field | Supported Filters | Sortable |
---|---|---|
id | $eq , $ne , $lt , $lte , $gt , $gte , $in , $hasSome , $hasAll , $startsWith , $contains | Sortable |
Related content: API Query Language, Query Rules
A rule defines the fee that is applied when specific conditions (also defined by the rule) are met. You can use a rule to apply a service fee to a restaurant order.
Rule ID.
ID of the restaurant’s location.
Rule name.
Date and time the rule was created.
Date and time the rule was updated.
Percentage value to apply as a custom tax rate. For example, 5
respresents a 5% fee applied to the order's total.
Min: '0'.
Max: 100
.
Specifies the type of condition.
Specifies the type of condition.
Whether the rule is enabled. If true
, the rule is evaluated when service fees are calculated. If false
, the rule will not be evaluated when service fees are calculated.
Revision number. Increments by 1 each time the rule is updated.
To prevent conflicting changes, the existing revision
must be used when updating a rule.
DEPRECATED. Defines the app that the rule is connected to.
Defines the app that the rule is connected to.
Rounding strategy to apply to fee and tax calculation.
HALF_UP
rounds up any number exactly halfway between two integers. For example, 2.5
rounds to 3
, and 3.5
and rounds to 4
.HALF_EVEN
rounds such numbers to the nearest even integer. For example, 2.5
rounds to 2
, but 3.5
rounds to 4
.Fixed fee. Must hold a positive value.
Percentage fee. For example, 5
represents a 5% fee applied to the order's total.
Fixed fee. Must hold a positive value.
Percentage fee. For example, 5
represents a 5% fee applied to the order's total.
Single condition that must be met for the rule to be applied to an order.
Binary tree of conditions. Use the operator to indicate whether only one or both conditions must be met in order for a service fee rule to be applied to an order.
Single condition that must be met for the rule to be applied to an order.
Binary tree of conditions. Use the operator to indicate whether only one or both conditions must be met in order for a service fee rule to be applied to an order.
Percentage value to apply as a custom tax rate. Range: [0-100].
Tax group ID. Internal only.
{
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Calculates service fees for an order.
The specified order information is evaluated against all rules created for the site. If the rule conditions are met, the service fee set in the rule is applied. Otherwise, no service fee is added.
Order information needed to evaluate the rules and calculate the relevant fees.
DEPRECATED. Defines the app that the rule is connected to.
Defines the app that the rule is connected to.
A list of calculated fees based on rules evaluation.
curl -X POST https://www.wixapis.com/service-fees-rules/v1/calculate \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"order": {
"shippingInfo": {
"logistics": {
"type": "PICKUP"
}
},
"platform": {
"value": "SITE"
},
"priceSummary": {
"subtotal": "10"
},
"currency": "USD"
}
}'
{
"calculatedFees": [
{
"ruleId": "a71ec83c-a705-4da4-8e70-237b7d7b838d",
"name": "Rule 1",
"fee": {
"value": "10.00",
"currency": "EUR",
"formattedValue": null
},
"tax": null,
"taxGroupId": null
},
{
"ruleId": "bedea267-4b42-4727-b74a-9a8db48fd6db",
"name": "2",
"fee": {
"value": "23.00",
"currency": "EUR",
"formattedValue": null
},
"tax": null,
"taxGroupId": null
},
{
"ruleId": "d84423ac-f73d-44a9-9ffb-f36fb163dc6b",
"name": "service fee 1",
"fee": {
"value": "11.00",
"currency": "EUR",
"formattedValue": null
},
"tax": null,
"taxGroupId": null
}
]
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Retrieves an array of all rules.
You can filter by location or app that the rules are associated with.
Retrieve only rule that apply at the location with this ID. If this field is null
, the rules will not be filtered by location.
DEPRECATED. Defines the app that the rule is connected to.
Defines the app that the rule is connected to.
Array containing the retrieved rules.
curl -X GET https://www.wixapis.com/service-fees-rules/v1/rules \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"locationId": "d84423ab-f73d-44a9-9ffb-f36fb163dc6b",
"appId": "d84429ab-f73d-44a9-9ffb-f36fb163dc6b"
}'
{
"rules": [
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
},
"locationId": "d84423ab-f73d-44a9-9ffb-f36fb163dc6b"
},
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9",
"locationId": "d84423ab-f73d-44a9-9ffb-f36fb163dc6b"
}
]
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Creates a rule.
To create multiple rules at once, use Bulk Create Rules.
Read more about constructing a rule.
You can only call this method when authenticated as a Wix app or Wix user identity.
Rule to create.
Created rule
curl -X POST https://www.wixapis.com/service-fees-rules/v1/rules \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"rule": {
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
}
}
}'
{
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
}
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Retrieves a rule.
ID of the rule to retrieve.
The retrieved rule.
curl -X GET https://www.wixapis.com/service-fees-rules/v1/rules/4aea505e-ac49-4f72-b4f1-b07c064a20cd \
-H 'Authorization: <AUTH>'
{
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
}
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Deletes a rule.
To delete mutiple rules at once, use Bulk Delete Rules.
You can only call this method when authenticated as a Wix app or Wix user identity.
ID of the rule to delete.
curl -X DELETE https://www.wixapis.com/service-fees-rules/v1/rules/4aea505e-ac49-4f72-b4f1-b07c064a20cd \
-H 'Authorization: <AUTH>'
{
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Updates a rule.
Each time the task is updated, revision
increments by 1. The existing revision
must be included when updating the task. This ensures you're working with the latest task and prevents unintended overwrites.
To update multiple rules at once, use Bulk Update Rules.
You can only call this method when authenticated as a Wix app or Wix user identity.
Rule ID.
Rule to update.
Updated rule.
curl -X PATCH https://www.wixapis.com/service-fees-rules/v1/rules/update \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"rule": {
"revision": "5",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
},
"mask": {
"paths": [
"name",
"taxRate",
"conditionType",
"enabled",
"roundingStrategy",
"customTaxRate",
"conditionOptions",
"percentageFee"
]
}
}'
{
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "6",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Retrieves a list of rules, given the provided paging, filtering, and sorting.
For field support for filters and sorting, see Service Fees: Supported Filters and Sorting.
Query Rules runs with these defaults, which you can override:
cursorPaging.limit
is 50
To learn about working with Query endpoints, see API Query Language, Sorting and Paging, and Field Projection.
Query options.
The retrieved rules.
Paging metadata.
curl -X GET https://www.wixapis.com/service-fees-rules/v1/rules \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"query": {
"sort": [
{
"fieldName": "enabled",
"order": "ASC"
}
],
"filter": {
"name": "rule_name"
}
}
}'
{
"rules": [
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
},
"locationId": "d84423ab-f73d-44a9-9ffb-f36fb163dc6b"
},
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9",
"locationId": "d84423ab-f73d-44a9-9ffb-f36fb163dc6b"
}
]
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
You can only call this method when authenticated as a Wix app or Wix user identity.
Rules to create.
Whether the full rule entity is returned.
Default: false
.
The created rules. Omitted if returnFullEntity
is set to false.
Bulk Create Rule metadata.
curl -X POST https://www.wixapis.com/service-fees-rules/v1/rules/create \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"rules": [
{
"name": "rule_name",
"tax_rate": "21.9",
"condition_type": "CONDITION",
"enabled": true,
"rounding_strategy": "HALF_UP",
"custom_tax_rate": "20",
"condition_options": {
"order_field_path": "priceSummary.subtotal",
"expected_field_type": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixed_fee": {
"value": "21.3",
"currency": "USD"
}
},
{
"name": "rule_name",
"tax_rate": "12.9",
"condition_type": "CONDITION",
"enabled": false,
"rounding_strategy": "HALF_EVEN",
"custom_tax_rate": "11",
"condition_options": {
"order_field_path": "priceSummary.subtotal",
"expected_field_type": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentage_fee": "11.9"
}
],
"return_full_entity": true
}'
{
"results": [
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "21.9",
"conditionType": "CONDITION",
"enabled": true,
"roundingStrategy": "HALF_UP",
"customTaxRate": "20",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "5.9",
"operation": "GT"
}
},
"fixedFee": {
"value": "21.3",
"currency": "USD"
}
},
{
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "1",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
}
],
"bulkActionMetadata": {
"totalSuccesses": 2,
"totalFailures": 0,
"undetailedFailures": 0
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Bulk updates rules.
Each time the task is updated, revision
increments by 1. The existing revision
must be included when updating the task. This ensures you're working with the latest task and prevents unintended overwrites.
To update a single rule, use Update Rule.
You can only call this method when authenticated as a Wix app or Wix user identity.
Masked rules to update.
Whether the full rule entity is returned.
Default: false
.
The updated rules. Omitted if returnFullEntity
is set to false.
Bulk Update Rule metadata.
curl -X PATCH https://www.wixapis.com/service-fees-rules/v1/rules/4aea505e-ac49-4f72-b4f1-b07c064a20cd \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"return_full_entity": true,
"rules":[
{
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "5",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
},
"mask": {
"paths": [
"name",
"taxRate",
"conditionType",
"enabled",
"roundingStrategy",
"customTaxRate",
"conditionOptions",
"percentageFee"
]
}
}
]
}'
{
"results": [
{
"itemMetadata": {
"itemId": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"itemType": "RULE"
},
"rule": {
"id": "4aea505e-ac49-4f72-b4f1-b07c064a20cd",
"revision": "6",
"createdDate": "2023-12-10T07:06:39.306Z",
"updatedDate": "2023-12-10T07:06:39.306Z",
"name": "rule_name",
"taxRate": "12.9",
"conditionType": "CONDITION",
"enabled": false,
"roundingStrategy": "HALF_EVEN",
"customTaxRate": "11",
"conditionOptions": {
"orderFieldPath": "priceSummary.subtotal",
"expectedFieldType": "NUMBER",
"number": {
"value": "10",
"operation": "EQ"
}
},
"percentageFee": "11.9"
}
}
],
"bulkActionMetadata": {
"totalSuccesses": 1,
"totalFailures": 0,
"undetailedFailures": 0
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Bulk deletes rules.
To delete a single rule, use Delete Rule.
You can only call this method when authenticated as a Wix app or Wix user identity.
IDs of the rules to delete.
Information about the deleted rules.
Bulk Delete Rule metadata.
curl -X DELETE https://www.wixapis.com/service-fees-rules/v1/rules/delete \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'Authorization: <AUTH>' \
--data-raw '{
"rule_ids": [
"8f6dc28a-a915-446b-ae75-d201f9f462a9"
]'
}'
{
"results": [
{
"itemMetadata": {
"id": "8f6dc28a-a915-446b-ae75-d201f9f462a9",
"originalIndex": 0,
"success": true,
"error": null
},
"rule": null
}
],
"bulkActionMetadata": {
"totalSuccesses": 1,
"totalFailures": 0,
"undetailedFailures": 0
}
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Unique event ID. Allows clients to ignore duplicate webhooks.
Fully qualified domain name of the entity associated with the event. Expected wix.service.fees.v1.rule
.
Event name. Expected created
.
ID of the entity associated with the event.
Event timestamp.
Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
If present, indicates the action that triggered the event.
Event information.
The data payload will include the following as an encoded JWT:
{
"data": {
"eventType": "wix.service.fees.v1.rule_created",
"instanceId": "<app-instance-id>",
"data": "<stringified-JSON>",
// The identity field is sent as a stringified JSON
"identity": {
"identityType": "<identityType>", // ANONYMOUS_VISITOR, MEMBER, WIX_USER, APP
"anonymousVisitorId": "<anonymousVisitorId>", // in case of ANONYMOUS_VISITOR
"memberId": "<memberId>", // in case of MEMBER
"wixUserId": "<wixUserId>", // in case of WIX_USER
"appId": "<appId>" // in case of APP
}
}
}
{
"id": "123a9562-0ef1-433e-864d-9e62454d4971",
"entityFqdn": "wix.service.fees.v1.rule",
"slug": "created",
"entityId": "3799059d-260f-4f7f-b515-4fe3988a5540",
"createdEvent": {
"entity": "{\"id\":\"3799059d-260f-4f7f-b515-4fe3988a5540\",\"name\":\"Rule Name\",\"createdDate\":\"2024-01-28T14:16:28.525Z\",\"updatedDate\":\"2024-01-28T14:16:28.525Z\",\"amount\":{\"value\":\"10\",\"currency\":\"EUR\"},\"fixedFee\":{\"value\":\"10\",\"currency\":\"EUR\"},\"condition\":{\"path\":\"shippingInfo.logistics.type\",\"orderFieldPath\":\"shippingInfo.logistics.type\",\"expectedType\":{\"value\":\"STRING\"},\"expectedFieldType\":\"STRING\",\"list\":{\"values\":[\"DELIVERY\"]}},\"conditionsType\":\"CONDITION\",\"conditionType\":\"CONDITION\",\"conditionOptions\":{\"path\":\"shippingInfo.logistics.type\",\"orderFieldPath\":\"shippingInfo.logistics.type\",\"expectedType\":{\"value\":\"STRING\"},\"expectedFieldType\":\"STRING\",\"list\":{\"values\":[\"DELIVERY\"]}},\"enabled\":true,\"revision\":\"1\",\"appId\":\"9a5d83fd-8570-482e-81ab-cfa88942ee60\",\"roundingStrategy\":\"UNKNOWN_ROUNDING_STRATEGY\"}"
},
"eventTime": "2024-01-28T14:16:28.535118309Z",
"triggeredByAnonymizeRequest": false,
"entityEventSequence": "1"
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Unique event ID. Allows clients to ignore duplicate webhooks.
Fully qualified domain name of the entity associated with the event. Expected wix.service.fees.v1.rule
.
Event name. Expected deleted
.
ID of the entity associated with the event.
Event timestamp.
Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
If present, indicates the action that triggered the event.
Event information.
The data payload will include the following as an encoded JWT:
{
"data": {
"eventType": "wix.service.fees.v1.rule_deleted",
"instanceId": "<app-instance-id>",
"data": "<stringified-JSON>",
// The identity field is sent as a stringified JSON
"identity": {
"identityType": "<identityType>", // ANONYMOUS_VISITOR, MEMBER, WIX_USER, APP
"anonymousVisitorId": "<anonymousVisitorId>", // in case of ANONYMOUS_VISITOR
"memberId": "<memberId>", // in case of MEMBER
"wixUserId": "<wixUserId>", // in case of WIX_USER
"appId": "<appId>" // in case of APP
}
}
}
{
"id": "784867e9-9168-4781-b804-db19450837e8",
"entityFqdn": "wix.service.fees.v1.rule",
"slug": "deleted",
"entityId": "3799059d-260f-4f7f-b515-4fe3988a5540",
"deletedEvent": {
"movedToTrash": true
},
"eventTime": "2024-01-28T14:27:42.514939826Z",
"triggeredByAnonymizeRequest": false,
"entityEventSequence": "3"
}
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Unique event ID. Allows clients to ignore duplicate webhooks.
Fully qualified domain name of the entity associated with the event. Expected wix.service.fees.v1.rule
.
Event name. Expected updated
.
ID of the entity associated with the event.
Event timestamp.
Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
If present, indicates the action that triggered the event.
Event information.
The data payload will include the following as an encoded JWT:
{
"data": {
"eventType": "wix.service.fees.v1.rule_updated",
"instanceId": "<app-instance-id>",
"data": "<stringified-JSON>",
// The identity field is sent as a stringified JSON
"identity": {
"identityType": "<identityType>", // ANONYMOUS_VISITOR, MEMBER, WIX_USER, APP
"anonymousVisitorId": "<anonymousVisitorId>", // in case of ANONYMOUS_VISITOR
"memberId": "<memberId>", // in case of MEMBER
"wixUserId": "<wixUserId>", // in case of WIX_USER
"appId": "<appId>" // in case of APP
}
}
}
{
"id": "88ff68de-2ad5-47c8-8872-c2479408bc5d",
"entityFqdn": "wix.service.fees.v1.rule",
"slug": "updated",
"entityId": "3799059d-260f-4f7f-b515-4fe3988a5540",
"updatedEvent": {
"currentEntity": "{\"id\":\"3799059d-260f-4f7f-b515-4fe3988a5540\",\"name\":\"Rule Name 2\",\"createdDate\":\"2024-01-28T14:16:28.525Z\",\"updatedDate\":\"2024-01-28T14:25:47.220Z\",\"amount\":{\"value\":\"10\",\"currency\":\"EUR\"},\"fixedFee\":{\"value\":\"10\",\"currency\":\"EUR\"},\"condition\":{\"path\":\"shippingInfo.logistics.type\",\"orderFieldPath\":\"shippingInfo.logistics.type\",\"expectedType\":{\"value\":\"STRING\"},\"expectedFieldType\":\"STRING\",\"list\":{\"values\":[\"DELIVERY\"]}},\"conditionsType\":\"CONDITION\",\"conditionType\":\"CONDITION\",\"conditionOptions\":{\"path\":\"shippingInfo.logistics.type\",\"orderFieldPath\":\"shippingInfo.logistics.type\",\"expectedType\":{\"value\":\"STRING\"},\"expectedFieldType\":\"STRING\",\"list\":{\"values\":[\"DELIVERY\"]}},\"enabled\":true,\"revision\":\"2\",\"appId\":\"9a5d83fd-8570-482e-81ab-cfa88942ee60\",\"roundingStrategy\":\"UNKNOWN_ROUNDING_STRATEGY\"}"
},
"eventTime": "2024-01-28T14:25:47.328707384Z",
"triggeredByAnonymizeRequest": false,
"entityEventSequence": "2"
}