interface Order { /** * Order ID. * @readonly */ _id?: string | null; /** * Order number displayed in the site owner's dashboard (auto-generated). * @readonly */ number?: string; /** * Date and time the order was created. * @readonly */ _createdDate?: Date | null; /** * Date and time the order was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * @readonly */ _updatedDate?: Date | null; /** * Order line items. * @readonly */ lineItems?: OrderLineItem[]; /** Buyer information. */ buyerInfo?: BuyerInfo; /** Order payment status. */ paymentStatus?: PaymentStatus; /** * Order fulfillment status. * @readonly */ fulfillmentStatus?: FulfillmentStatus; /** * Language for communication with the buyer. Defaults to the site language. * For a site that supports multiple languages, this is the language the buyer selected. */ buyerLanguage?: string | null; /** Weight measurement unit - defaults to site's weight unit. */ weightUnit?: WeightUnit; /** Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. */ currency?: string | null; /** Whether tax is included in line item prices. */ taxIncludedInPrices?: boolean; /** * Site language in which original values are shown. * @readonly */ siteLanguage?: string | null; /** * Order price summary. * @readonly */ priceSummary?: PriceSummary; /** Billing address and contact details. */ billingInfo?: AddressWithContact; /** Shipping info and selected shipping option details. */ shippingInfo?: V1ShippingInformation; /** [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer. */ buyerNote?: string | null; /** Order status. */ status?: OrderStatus; /** Whether order is archived. */ archived?: boolean | null; /** * Tax summary. * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * @deprecated Tax summary. * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxSummary?: TaxSummary; /** Tax information. */ taxInfo?: OrderTaxInfo; /** Applied discounts. */ appliedDiscounts?: AppliedDiscount[]; /** * Order activities. * @readonly */ activities?: Activity[]; /** Order attribution source. */ attributionSource?: AttributionSource; /** * ID of the order's initiator. * @readonly */ createdBy?: CreatedBy; /** Information about the sales channel that submitted this order. */ channelInfo?: ChannelInfo; /** Whether a human has seen the order. Set when an order is clicked on in the dashboard. */ seenByAHuman?: boolean | null; /** Checkout ID. */ checkoutId?: string | null; /** Custom fields. */ customFields?: CustomField[]; /** * Balance summary. * @readonly */ balanceSummary?: BalanceSummary; /** Additional fees applied to the order. */ additionalFees?: AdditionalFee[]; /** * Custom field data for the order object. * * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls. */ extendedFields?: ExtendedFields; /** Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order. */ purchaseFlowId?: string | null; /** * Order recipient address and contact details. * * This field may differ from the address in `shippingInfo.logistics` when: * + The chosen shipping option is pickup point or store pickup. * + No shipping option is selected. */ recipientInfo?: AddressWithContact; /** * Date and time the order was originally purchased in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * Used for migration from external systems. */ purchasedDate?: Date | null; /** Order Location */ businessLocation?: Location; /** * Pay after free trial price summary. Price summary that should be paid for subscriptions after free trial period. * @internal * @readonly */ payAfterFreeTrial?: PriceSummary; } interface OrderLineItem { /** Line item ID. */ _id?: string; /** * Item name. * + Stores - `product.name` * + Bookings - `service.info.name` * + Events - `ticket.name` */ productName?: ProductName; /** Catalog and item reference. Holds IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */ catalogReference?: CatalogReference; /** Line item quantity. */ quantity?: number; /** * Total discount for this line item's entire quantity. * @readonly */ totalDiscount?: Price; /** Line item description lines. Used for display purposes for the cart, checkout and order. */ descriptionLines?: DescriptionLine[]; /** Line item image. */ image?: string; /** Physical properties of the item. When relevant, contains information such as SKU and item weight. */ physicalProperties?: PhysicalProperties; /** Item type. Either a preset type or custom. */ itemType?: ItemType; /** * Fulfiller ID. Field is empty when the line item is self-fulfilled. * * To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://www.wix.com/velo/reference/wix-ecom-backend/orderfulfillments/listfulfillmentsforsingleorder). */ fulfillerId?: string | null; /** Number of items that were refunded. */ refundQuantity?: number | null; /** Number of items restocked. */ restockQuantity?: number | null; /** Line item price after line item discounts for display purposes. */ price?: Price; /** * Line item price before line item discounts for display purposes. Defaults to `price` when not provided. * @readonly */ priceBeforeDiscounts?: Price; /** * Total price after discounts, and before tax. * @readonly */ totalPriceBeforeTax?: Price; /** * Total price after all discounts and tax. * @readonly */ totalPriceAfterTax?: Price; /** * Type of selected payment option for current item. * * Default: `FULL_PAYMENT_ONLINE` */ paymentOption?: PaymentOptionType; /** * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @deprecated Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxDetails?: ItemTaxFullDetails; /** Represents all the relevant tax details for a specific line item. */ taxInfo?: LineItemTaxInfo; /** Digital file identifier, relevant only for items with type DIGITAL. */ digitalFile?: DigitalFile; /** Subscription info. */ subscriptionInfo?: SubscriptionInfo; /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */ priceDescription?: PriceDescription; /** * Item's price amount to be charged during checkout. Relevant for items with a `paymentOption` value of `"DEPOSIT_ONLINE"`. * @readonly */ depositAmount?: Price; /** * Address used for tax calculation. * @internal */ taxableAddress?: TaxableAddress; /** * ID of the app managing the inventory. * @internal */ inventoryAppId?: string | null; /** * Custom extended fields for the line item object. * * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls. */ extendedFields?: ExtendedFields; } interface ProductName { /** * __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). * * Min: 1 character. * Max: 200 characters. */ original?: string; /** * Item name translated into the buyer's language. * * Min: 1 character. * Max: 400 characters. * Default: Same as `original`. */ translated?: string | null; } /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */ interface CatalogReference { /** ID of the item within the catalog it belongs to. */ catalogItemId?: string; /** * ID of the app providing the catalog. * * You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). * * For items from Wix catalogs, the following values always apply: * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"` */ appId?: string; /** * Additional item details in key:value pairs. * * Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. * * For products and variants from your Wix Stores catalog, learn more about [eCommerce integration](https://www.wix.com/velo/reference/wix-stores-backend/ecommerce-integration). */ options?: Record | null; } interface Price { /** Amount. */ amount?: string; /** * Amount formatted with currency symbol. * @readonly */ formattedAmount?: string; } interface DescriptionLine extends DescriptionLineValueOneOf, DescriptionLineDescriptionLineValueOneOf { /** Description line plain text value. */ plainText?: PlainTextValue; /** Description line color value. */ colorInfo?: Color; /** Description line name. */ name?: DescriptionLineName; } /** @oneof */ interface DescriptionLineValueOneOf { /** Description line plain text value. */ plainText?: PlainTextValue; /** Description line color value. */ colorInfo?: Color; } /** @oneof */ interface DescriptionLineDescriptionLineValueOneOf { } interface DescriptionLineName { /** Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). */ original?: string; /** * Description line name translated into the buyer's language. * * Default: Same as `original`. */ translated?: string | null; } interface PlainTextValue { /** Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). */ original?: string; /** * Description line plain text value translated into the buyer's language. * * Default: Same as `original`. */ translated?: string | null; } interface Color { /** Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). */ original?: string; /** * Description line color name translated into the buyer's language. * * Default: Same as `original`. */ translated?: string | null; /** HEX or RGB color code for display. */ code?: string | null; } declare enum DescriptionLineType { /** Unrecognized type. */ UNRECOGNISED = "UNRECOGNISED", /** Plain text type. */ PLAIN_TEXT = "PLAIN_TEXT", /** Color type. */ COLOR = "COLOR" } interface FocalPoint { /** X-coordinate of the focal point. */ x?: number; /** Y-coordinate of the focal point. */ y?: number; /** crop by height */ height?: number | null; /** crop by width */ width?: number | null; } interface PhysicalProperties { /** Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request. */ weight?: number | null; /** Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku). */ sku?: string | null; /** Whether this line item is shippable. */ shippable?: boolean; } interface ItemType extends ItemTypeItemTypeDataOneOf { /** Preset item type. */ preset?: ItemTypeItemType; /** Custom item type. When none of the preset types are suitable, specifies the custom type. */ custom?: string; } /** @oneof */ interface ItemTypeItemTypeDataOneOf { /** Preset item type. */ preset?: ItemTypeItemType; /** Custom item type. When none of the preset types are suitable, specifies the custom type. */ custom?: string; } declare enum ItemTypeItemType { UNRECOGNISED = "UNRECOGNISED", PHYSICAL = "PHYSICAL", DIGITAL = "DIGITAL", GIFT_CARD = "GIFT_CARD", SERVICE = "SERVICE" } /** Type of selected payment option for catalog item */ declare enum PaymentOptionType { /** The entire payment for this item happens as part of the checkout. */ FULL_PAYMENT_ONLINE = "FULL_PAYMENT_ONLINE", /** The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods. */ FULL_PAYMENT_OFFLINE = "FULL_PAYMENT_OFFLINE", /** Payment for this item is done by charging a membership. When selected, `price` is `0`. */ MEMBERSHIP = "MEMBERSHIP", /** Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`. */ DEPOSIT_ONLINE = "DEPOSIT_ONLINE", /** Payment for this item can only be done by charging a membership and must be manually redeemed in the dashboard by the site admin. When selected, `price` is `0`. */ MEMBERSHIP_OFFLINE = "MEMBERSHIP_OFFLINE" } interface ItemTaxFullDetails { /** Taxable amount of this line item. */ taxableAmount?: Price; /** Tax rate percentage, as a decimal numeral between 0 and 1. For example, `"0.13"`. */ taxRate?: string; /** The calculated tax, based on the `taxableAmount` and `taxRate`. */ totalTax?: Price; } interface LineItemTaxInfo { /** Calculated tax, based on `taxable_amount` and `tax_rate`. */ taxAmount?: Price; /** Amount for which tax is calculated. */ taxableAmount?: Price; /** Tax rate %, as a decimal point. */ taxRate?: string | null; /** * Tax group ID. * Learn more about [Tax Groups](https://dev.wix.com/docs/rest/business-management/payments/tax/tax-groups/introduction). */ taxGroupId?: string | null; /** Indicates whether the price already includes tax. */ taxIncludedInPrice?: boolean; /** Tax information for a line item. */ taxBreakdown?: LineItemTaxBreakdown[]; } /** * TaxBreakdown represents tax information for a line item. * It holds the tax amount and the tax rate for each tax authority that apply on the line item. */ interface LineItemTaxBreakdown { /** Jurisdiction that taxes were calculated for. For example, "New York", or "Quebec". */ jurisdiction?: string | null; /** Tax rate used for this jurisdiction, as a decimal. For example, 10% tax is 0.1000. */ rate?: string | null; /** Amount of tax calculated for this line item. */ taxAmount?: Price; /** The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc. */ taxType?: string | null; /** * The name of the tax against which this tax amount was calculated. For example, "NY State Sales Tax", "Quebec GST", etc. * This name should be explicit enough to allow the merchant to understand what tax was calculated. */ taxName?: string | null; /** Type of jurisdiction that taxes were calculated for. */ jurisdictionType?: JurisdictionType; /** Non-taxable amount of the line item price. */ nonTaxableAmount?: Price; /** Taxable amount of the line item price. */ taxableAmount?: Price; } /** JurisdictionType represents the type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */ declare enum JurisdictionType { UNDEFINED = "UNDEFINED", COUNTRY = "COUNTRY", STATE = "STATE", COUNTY = "COUNTY", CITY = "CITY", SPECIAL = "SPECIAL" } interface DigitalFile { /** ID of the secure file in media. */ fileId?: string; /** Link will exist after the digital links have been generated on the order. */ link?: string | null; /** * Link expiration time and date. * @readonly */ expirationDate?: Date | null; } interface SubscriptionInfo { /** Subscription ID. */ _id?: string | null; /** Subscription cycle. For example, if this order is for the 3rd cycle of a subscription, value will be `3`. */ cycleNumber?: number; /** Subscription option title. For example, `"Monthly coffee Subscription"`. */ subscriptionOptionTitle?: string; /** Subscription option description. For example, `"1kg of selected coffee, once a month"`. */ subscriptionOptionDescription?: string | null; /** Subscription detailed information. */ subscriptionSettings?: SubscriptionSettings; /** * Description of the charges that will be applied for subscription. * @internal */ chargesDescription?: string | null; } interface SubscriptionSettings { /** Frequency of recurring payment. */ frequency?: SubscriptionFrequency; /** Interval of recurring payment. */ interval?: number | null; /** Whether subscription is renewed automatically at the end of each period. */ autoRenewal?: boolean; /** Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`. */ billingCycles?: number | null; /** * Whether to allow the customer to cancel the subscription. * @internal */ enableCustomerCancellation?: boolean; /** * Period until first cycle starts. If None => no free trial * @internal */ freeTrialPeriod?: FreeTrialPeriod; /** * The date the subscription will start. The subscription will be charged either now or according to freeTrialDays. * @internal */ startDate?: Date | null; } /** Frequency unit of recurring payment */ declare enum SubscriptionFrequency { UNDEFINED = "UNDEFINED", DAY = "DAY", WEEK = "WEEK", MONTH = "MONTH", YEAR = "YEAR" } interface FreeTrialPeriod { /** Frequency of priod. Values: DAY, WEEK, MONTH, YEAR */ frequency?: SubscriptionFrequency; /** interval of period */ interval?: number; } interface PriceDescription { /** __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). */ original?: string; /** * Price description translated into the buyer's language. * * Default: Same as `original`. */ translated?: string | null; } interface LocationAndQuantity { /** Location id in the associated owner app. */ _id?: string; /** * Location owner app, if not provided then the site business info locations will be used. * @deprecated Location owner app, if not provided then the site business info locations will be used. * @targetRemovalDate 2025-03-01 */ appId?: string | null; /** Quantity for specific location. */ quantity?: number; /** * Location name. * @internal * @readonly */ name?: string | null; } interface TaxableAddress extends TaxableAddressTaxableAddressDataOneOf { /** taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly. */ addressType?: TaxableAddressType; } /** @oneof */ interface TaxableAddressTaxableAddressDataOneOf { /** taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly. */ addressType?: TaxableAddressType; } declare enum TaxableAddressType { UNKNOWN_TAXABLE_ADDRESS = "UNKNOWN_TAXABLE_ADDRESS", BUSINESS = "BUSINESS", BILLING = "BILLING", SHIPPING = "SHIPPING" } interface ExtendedFields { /** * Extended field data. Each key corresponds to the namespace of the app that created the extended fields. * The value of each key is structured according to the schema defined when the extended fields were configured. * * You can only access fields for which you have the appropriate permissions. * * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields). */ namespaces?: Record>; } /** Buyer Info */ interface BuyerInfo extends BuyerInfoIdOneOf { /** Visitor ID (if site visitor is not a member). */ visitorId?: string; /** Member ID (if site visitor is a site member). */ memberId?: string; /** Contact ID. Auto-created if one does not yet exist. For more information, see [Contacts API](https://www.wix.com/velo/reference/wix-crm-backend/contacts/introduction). */ contactId?: string | null; /** Buyer email address. */ email?: string | null; } /** @oneof */ interface BuyerInfoIdOneOf { /** Visitor ID (if site visitor is not a member). */ visitorId?: string; /** Member ID (if site visitor is a site member). */ memberId?: string; } declare enum PaymentStatus { UNSPECIFIED = "UNSPECIFIED", /** * `NOT_PAID` can apply to an order made online, but not yet paid. In such cases `order.status` will be `INITIALIZED`. * This status also applies when an offline order needs to be manually marked as paid. In such cases `order.status` will be `APPROVED`. */ NOT_PAID = "NOT_PAID", /** All required payments associated with this order are paid. */ PAID = "PAID", /** Order partially refunded, but the refunded amount is less than the order's total price. See `order.balanceSummary` for more details. */ PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED", /** Order fully refunded. Refund amount equals total price. See `order.balanceSummary` for more details. */ FULLY_REFUNDED = "FULLY_REFUNDED", /** * All payments pending. * * This can happen with two-step payments, when a payment requires manual review, or when a payment is in progress and will be concluded shortly. * Learn more about [pending orders](https://support.wix.com/en/article/pending-orders). */ PENDING = "PENDING", /** At least one payment received and approved, but it covers less than the order's total price. See `order.balanceSummary` for more details. */ PARTIALLY_PAID = "PARTIALLY_PAID", /** * Payment received, but not yet confirmed by the payment provider. * * In most cases, when a payment provider is holding payment it's because setup hasn't been successfully completed by the merchant/site owner. * To solve this, the merchant/site owner should log in to the payment provider's dashboard and make sure their account is set up correctly, or contact their support for further assistance. * @documentationMaturity preview */ PENDING_MERCHANT = "PENDING_MERCHANT", /** * One or more payments canceled. * @documentationMaturity preview */ CANCELED = "CANCELED", /** * One or more payments declined. * @documentationMaturity preview */ DECLINED = "DECLINED" } declare enum FulfillmentStatus { /** None of the order items are fulfilled or the order was manually marked as unfulfilled. */ NOT_FULFILLED = "NOT_FULFILLED", /** * All of the order items are fulfilled or the order was manually marked as fulfilled. * Orders without shipping info are fulfilled automatically. */ FULFILLED = "FULFILLED", /** Some, but not all, of the order items are fulfilled. */ PARTIALLY_FULFILLED = "PARTIALLY_FULFILLED" } declare enum WeightUnit { /** Weight unit can't be classified, due to an error */ UNSPECIFIED_WEIGHT_UNIT = "UNSPECIFIED_WEIGHT_UNIT", /** Kilograms */ KG = "KG", /** Pounds */ LB = "LB" } interface PriceSummary { /** Subtotal of all the line items, before discounts and before tax. */ subtotal?: Price; /** Total shipping price, before discounts and before tax. */ shipping?: Price; /** Total tax on this order. */ tax?: Price; /** Total calculated discount value. */ discount?: Price; /** Order’s total price after discounts and tax. */ total?: Price; /** Total price of additional fees before tax. */ totalAdditionalFees?: Price; } /** Billing Info and shipping details */ interface AddressWithContact { /** Address. */ address?: Address; /** Contact details. */ contactDetails?: FullAddressContactDetails; } /** Physical address */ interface Address { /** Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. */ country?: string | null; /** Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. */ subdivision?: string | null; /** City name. */ city?: string | null; /** Postal or zip code. */ postalCode?: string | null; /** Street address. */ streetAddress?: StreetAddress; /** Main address line (usually street name and number). */ addressLine1?: string | null; /** Free text providing more detailed address info. Usually contains apt, suite, floor. */ addressLine2?: string | null; /** * Country's full name. * @readonly */ countryFullname?: string | null; /** * Subdivision full-name. * @readonly */ subdivisionFullname?: string | null; } interface StreetAddress { /** Street number. */ number?: string; /** Street name. */ name?: string; } interface AddressLocation { /** Address latitude. */ latitude?: number | null; /** Address longitude. */ longitude?: number | null; } /** Full contact details for an address */ interface FullAddressContactDetails { /** First name. */ firstName?: string | null; /** Last name. */ lastName?: string | null; /** Phone number. */ phone?: string | null; /** Company name. */ company?: string | null; /** Tax information (for Brazil only). If ID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed. */ vatId?: VatId; } interface VatId { /** Customer's tax ID. */ _id?: string; /** * Tax type. * * Supported values: * + `CPF`: for individual tax payers * + `CNPJ`: for corporations */ type?: VatType; } /** tax info types */ declare enum VatType { UNSPECIFIED = "UNSPECIFIED", /** CPF - for individual tax payers. */ CPF = "CPF", /** CNPJ - for corporations */ CNPJ = "CNPJ" } interface V1ShippingInformation { /** App Def Id of external provider which was a source of shipping info */ carrierId?: string | null; /** Unique code (or ID) of selected shipping option. For example, `"usps_std_overnight"`. */ code?: string | null; /** * Shipping option title. * For example, `"USPS Standard Overnight Delivery"`, `"Standard"` or `"First-Class Package International"`. */ title?: string; /** Shipping logistics. */ logistics?: DeliveryLogistics; /** Shipping costs. */ cost?: ShippingPrice; /** Shipping region. */ region?: ShippingRegion; } interface DeliveryLogistics extends DeliveryLogisticsAddressOneOf { /** Shipping address and contact details. */ shippingDestination?: AddressWithContact; /** Pickup details. */ pickupDetails?: PickupDetails; /** Expected delivery time in free text. For example, `"3-5 business days"`. */ deliveryTime?: string | null; /** Instructions for carrier. For example, `"Please knock on the door. If unanswered, please call contact number. Thanks."`. */ instructions?: string | null; /** * Deprecated - Latest expected delivery date and time in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * @deprecated */ deliverByDate?: Date | null; /** Expected delivery time. */ deliveryTimeSlot?: DeliveryTimeSlot; } /** @oneof */ interface DeliveryLogisticsAddressOneOf { /** Shipping address and contact details. */ shippingDestination?: AddressWithContact; /** Pickup details. */ pickupDetails?: PickupDetails; } interface PickupDetails { /** Pickup address. */ address?: PickupAddress; /** Pickup method */ pickupMethod?: PickupMethod; } /** Physical address */ interface PickupAddress { /** Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. */ country?: string | null; /** Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. */ subdivision?: string | null; /** City name. */ city?: string | null; /** Postal or zip code. */ postalCode?: string | null; /** Street address object, with number, name, and apartment number in separate fields. */ streetAddress?: StreetAddress; /** Main address line (usually street name and number). */ addressLine1?: string | null; /** Free text providing more detailed address info. Usually contains apt, suite, floor. */ addressLine2?: string | null; /** * Country's full name. * @readonly */ countryFullname?: string | null; /** * Subdivision full-name. * @readonly */ subdivisionFullname?: string | null; } declare enum PickupMethod { UNKNOWN_METHOD = "UNKNOWN_METHOD", STORE_PICKUP = "STORE_PICKUP", PICKUP_POINT = "PICKUP_POINT" } interface DeliveryTimeSlot { /** Delivery slot starting time. */ from?: Date | null; /** Delivery slot ending time. */ to?: Date | null; } interface ShippingPrice { /** Shipping price for display purposes. */ price?: Price; /** * Total price of shipping after discounts (when relevant), and before tax. * @readonly */ totalPriceBeforeTax?: Price; /** * Shipping price after all discounts (if any exist), and after tax. * @readonly */ totalPriceAfterTax?: Price; /** Tax details. */ taxDetails?: ItemTaxFullDetails; /** * Shipping discount before tax. * @readonly */ discount?: Price; } interface ShippingRegion { /** Name of shipping region. For example, `"Metropolitan London"`, or `"Outer Melbourne suburbs"`. */ name?: string | null; } declare enum OrderStatus { /** Order created, but not yet approved or canceled. */ INITIALIZED = "INITIALIZED", /** * Order approved. * * This happens when either an online payment is received **or** when `order.priceSummary.total = 0` (a zero-total order). * Offline orders (cash payment) are automatically approved. */ APPROVED = "APPROVED", /** Order canceled by the user. */ CANCELED = "CANCELED", /** * Order pending. * @documentationMaturity preview */ PENDING = "PENDING", /** * Order rejected. * * This happens when pending payments fail. * @documentationMaturity preview */ REJECTED = "REJECTED" } interface TaxSummary { /** * Total tax. * @readonly */ totalTax?: Price; } interface OrderTaxInfo { /** Calculated tax, added from line items. */ totalTax?: Price; /** The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate. */ taxBreakdown?: OrderTaxBreakdown[]; /** * Whether the order is exempt from tax calculations. * * Default: `false` * @readonly */ taxExempt?: boolean | null; } /** * The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate. * Tax breakdown is the tax amount split to the tax authorities that applied on the line item. */ interface OrderTaxBreakdown { /** The name of the tax against which this tax amount was calculated. */ taxName?: string; /** The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws. */ taxType?: string; /** The name of the jurisdiction in which this tax detail applies. */ jurisdiction?: string; /** The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */ jurisdictionType?: JurisdictionType; /** The rate at which this tax detail was calculated. */ rate?: string; /** The sum of all the tax from line items that calculated by the tax identifiers. */ aggregatedTaxAmount?: Price; } interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf { /** Applied coupon info. */ coupon?: Coupon; /** Merchant discount. */ merchantDiscount?: MerchantDiscount; /** Automatic Discount */ discountRule?: DiscountRule; /** * Discount type. * * `"GLOBAL"` - discount applies to entire order. * * `"SPECIFIC-ITEMS"` - discount applies to specific items. * * `"SHIPPING"` - discount applies to shipping. For example, free shipping. */ discountType?: DiscountType; /** * IDs of line items discount applies to. * Deprecated. Use `line_item_discounts` instead. * @deprecated IDs of line items discount applies to. * Deprecated. Use `line_item_discounts` instead. * @replacedBy line_item_discounts * @targetRemovalDate 2024-10-30 */ lineItemIds?: string[]; /** Discount id. */ _id?: string | null; /** * Number of subscription billing cycles the discount applies to. * If None and discount is linked to subscription line item, it applies to all cycles. * @internal */ subscriptionCycles?: number | null; } /** @oneof */ interface AppliedDiscountDiscountSourceOneOf { /** Applied coupon info. */ coupon?: Coupon; /** Merchant discount. */ merchantDiscount?: MerchantDiscount; /** Automatic Discount */ discountRule?: DiscountRule; } declare enum DiscountType { GLOBAL = "GLOBAL", SPECIFIC_ITEMS = "SPECIFIC_ITEMS", SHIPPING = "SHIPPING" } /** Coupon */ interface Coupon { /** Coupon ID. */ _id?: string; /** Coupon code. */ code?: string; /** Coupon name. */ name?: string; /** Coupon value. */ amount?: Price; } interface MerchantDiscount extends MerchantDiscountMerchantDiscountReasonOneOf { /** * Pre-defined discount reason (optional). * * `"ITEMS_EXCHANGE"` - exchange balance acquired as a result of items exchange. */ discountReason?: DiscountReason; /** Discount description as free text (optional). */ description?: string | null; /** Discount amount. */ amount?: Price; /** * Discount percentage. * @internal */ percentage?: string | null; } /** @oneof */ interface MerchantDiscountMerchantDiscountReasonOneOf { /** * Pre-defined discount reason (optional). * * `"ITEMS_EXCHANGE"` - exchange balance acquired as a result of items exchange. */ discountReason?: DiscountReason; /** Discount description as free text (optional). */ description?: string | null; } declare enum DiscountReason { UNSPECIFIED = "UNSPECIFIED", EXCHANGED_ITEMS = "EXCHANGED_ITEMS" } interface DiscountRule { /** Discount rule ID */ _id?: string; /** Discount rule name */ name?: DiscountRuleName; /** Discount value. */ amount?: Price; } interface DiscountRuleName { /** Original discount rule name (in site's default language). */ original?: string; /** Translated discount rule name according to buyer language. Defaults to `original` when not provided. */ translated?: string | null; } interface LineItemDiscount { /** ID of line item the discount applies to. */ _id?: string; /** Total discount for this line item. */ totalDiscount?: Price; } interface Activity extends ActivityContentOneOf { /** Custom activity details (optional). `activity.type` must be `CUSTOM_ACTIVITY`. */ customActivity?: CustomActivity; /** Merchant comment details (optional). `activity.type` must be `MERCHANT_COMMENT`. */ merchantComment?: MerchantComment; /** Additional info about order refunded activity (optional). `activity.type` must be `ORDER_REFUNDED`. */ orderRefunded?: OrderRefunded; /** * Details of an initiated refund process. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ refundInitiated?: RefundInitiated; /** * Details of a refunded payment. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefunded?: PaymentRefunded; /** * Details of a failed payment refund. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefundFailed?: PaymentRefundFailed; /** * Details of refund to store credit. * @internal */ refundedAsStoreCredit?: RefundedAsStoreCredit; /** * Details of a pending payment * @internal */ paymentPending?: PaymentPending; /** * Details of a canceled payment * @internal */ paymentCanceled?: PaymentCanceled; /** * Details of a declined payment * @internal */ paymentDeclined?: PaymentDeclined; /** * Receipt was added for associated payment * @internal */ receiptCreated?: ReceiptCreated; /** * Receipt sent to customer * @internal */ receiptSent?: ReceiptSent; /** * Activity ID. * @readonly */ _id?: string | null; /** * Activity author's email. * @readonly */ authorEmail?: string | null; /** * Activity creation date and time. * @readonly */ _createdDate?: Date | null; /** Activity type. */ type?: ActivityType; } /** @oneof */ interface ActivityContentOneOf { /** Custom activity details (optional). `activity.type` must be `CUSTOM_ACTIVITY`. */ customActivity?: CustomActivity; /** Merchant comment details (optional). `activity.type` must be `MERCHANT_COMMENT`. */ merchantComment?: MerchantComment; /** Additional info about order refunded activity (optional). `activity.type` must be `ORDER_REFUNDED`. */ orderRefunded?: OrderRefunded; /** * Details of an initiated refund process. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ refundInitiated?: RefundInitiated; /** * Details of a refunded payment. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefunded?: PaymentRefunded; /** * Details of a failed payment refund. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefundFailed?: PaymentRefundFailed; /** * Details of refund to store credit. * @internal */ refundedAsStoreCredit?: RefundedAsStoreCredit; /** * Details of a pending payment * @internal */ paymentPending?: PaymentPending; /** * Details of a canceled payment * @internal */ paymentCanceled?: PaymentCanceled; /** * Details of a declined payment * @internal */ paymentDeclined?: PaymentDeclined; /** * Receipt was added for associated payment * @internal */ receiptCreated?: ReceiptCreated; /** * Receipt sent to customer * @internal */ receiptSent?: ReceiptSent; } interface CustomActivity { /** ID of the app that created the custom activity. */ appId?: string; /** Custom activity type. For example, `"Ticket number set"`. */ type?: string; /** Additional data in key-value form. For example, `{ "Ticket number": "123456" }`. */ additionalData?: Record; } /** Store owner added a comment */ interface MerchantComment { /** Merchant comment message. */ message?: string; } interface OrderRefunded { /** Whether order was refunded manually. For example, via payment provider or using cash. */ manual?: boolean; /** Refund amount. */ amount?: Price; /** Reason for refund. */ reason?: string; } interface OrderCreatedFromExchange { /** ID of the original order for which the exchange happened. */ originalOrderId?: string; } interface NewExchangeOrderCreated { /** ID of the new order created as a result of an exchange of items. */ exchangeOrderId?: string; /** IDs of the items that were exchanged. */ lineItems?: LineItemExchangeData[]; } interface LineItemExchangeData { /** ID of the exchanged line item. */ lineItemId?: string; /** Line item quantity being exchanged. */ quantity?: number; } interface DraftOrderChangesApplied { /** Draft order id. */ draftOrderId?: string; /** Reason for edit, given by user (optional). */ reason?: string | null; /** Changes applied to order. */ changes?: OrderChange[]; } interface OrderChange extends OrderChangeValueOneOf { lineItemChanged?: LineItemChanges; lineItemAdded?: ManagedLineItem; lineItemRemoved?: ManagedLineItem; discountAdded?: ManagedDiscount; discountRemoved?: ManagedDiscount; additionalFeeAdded?: ManagedAdditionalFee; additionalFeeRemoved?: ManagedAdditionalFee; totalPriceChanged?: TotalPriceChange; shippingInformationChanged?: ShippingInformationChange; } /** @oneof */ interface OrderChangeValueOneOf { lineItemChanged?: LineItemChanges; lineItemAdded?: ManagedLineItem; lineItemRemoved?: ManagedLineItem; discountAdded?: ManagedDiscount; discountRemoved?: ManagedDiscount; additionalFeeAdded?: ManagedAdditionalFee; additionalFeeRemoved?: ManagedAdditionalFee; totalPriceChanged?: TotalPriceChange; shippingInformationChanged?: ShippingInformationChange; } interface LineItemChanges { /** Line item ID. */ _id?: string; /** Item name. */ name?: ProductName; /** Item quantity change. */ quantity?: LineItemQuantityChange; /** Item price change. */ price?: LineItemPriceChange; } interface LineItemQuantityChange { /** Item quantity before update. */ originalQuantity?: number; /** Item quantity after update. */ newQuantity?: number; /** Difference between original and new quantity. Absolute value. */ diff?: number; /** Type of quantity change: increase or decrease. */ deltaType?: LineItemQuantityChangeType; } declare enum LineItemQuantityChangeType { /** Quantity increased. */ QUANTITY_INCREASED = "QUANTITY_INCREASED", /** Quantity decreased. */ QUANTITY_DECREASED = "QUANTITY_DECREASED" } interface LineItemPriceChange { /** Item price before update. */ originalPrice?: Price; /** Item price after update. */ newPrice?: Price; } interface ManagedLineItem { /** Line item ID. */ _id?: string; /** Item name. */ name?: ProductName; /** Added or removed item quantity. */ quantity?: number; } interface ManagedDiscount { /** Discount id. */ _id?: string; /** Discount name: coupon name / discount rule name / merchant discount description. */ name?: TranslatedValue; /** Line items discount applies to. */ affectedLineItems?: LineItemAmount[]; /** Discount amount. */ totalAmount?: Price; } interface TranslatedValue { /** Value in site default language. */ original?: string; /** Translated value. */ translated?: string | null; } interface LineItemAmount { /** Order line item id */ _id?: string; /** Item name. */ name?: ProductName; /** Amount associated with this item. (Discount amount for item / additional fee amount for item) */ amount?: Price; } interface ManagedAdditionalFee { /** Additional fee id. */ _id?: string; /** Additional fee name. */ name?: TranslatedValue; /** Line items additional fee applies to. */ affectedLineItems?: LineItemAmount[]; /** Additional fee amount. */ totalAmount?: Price; } interface TotalPriceChange { /** Order’s total price after discounts and tax. Before update */ originalTotal?: Price; /** Order’s total price after discounts and tax. After update */ newTotal?: Price; } interface ShippingInformationChange { /** Order’s Shipping Information. Before update */ originalShippingInfo?: ShippingInformation; /** Order’s Shipping Information. After update */ newShippingInfo?: ShippingInformation; } interface ShippingInformation { /** Order’s shipping price. */ total?: Price; /** Order’s shipping title. */ shippingTitle?: string; } /** Payment method is saved for order */ interface SavedPaymentMethod { /** Payment method name */ name?: string; /** Payment method description */ description?: string | null; } interface AuthorizedPaymentCreated { /** Payment ID of payment associated with this activity */ paymentId?: string; /** Payment amount */ amount?: Price; /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface AuthorizedPaymentCaptured { /** Payment ID of payment associated with this activity */ paymentId?: string; /** Payment amount */ amount?: Price; /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface AuthorizedPaymentVoided { /** Payment ID of payment associated with this activity */ paymentId?: string; /** Payment amount */ amount?: Price; /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface RefundInitiated { /** Refund ID. */ refundId?: string; /** Refund amount. */ amount?: Price; /** Details about the payments being refunded. */ payments?: RefundedPayment[]; /** Reason for refund. */ reason?: string | null; } interface RefundedPayment extends RefundedPaymentKindOneOf { /** Regular payment refund. */ regular?: RegularPaymentRefund; /** Gift card payment refund. */ giftCard?: GiftCardPaymentRefund; /** Membership payment refund. */ membership?: MembershipPaymentRefund; /** Payment ID. */ paymentId?: string; /** Whether refund was made externally and manually on the payment provider's side. */ externalRefund?: boolean; } /** @oneof */ interface RefundedPaymentKindOneOf { /** Regular payment refund. */ regular?: RegularPaymentRefund; /** Gift card payment refund. */ giftCard?: GiftCardPaymentRefund; /** Membership payment refund. */ membership?: MembershipPaymentRefund; } interface RegularPaymentRefund { /** Refund amount */ amount?: Price; /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface GiftCardPaymentRefund { /** Gift card payment ID */ giftCardPaymentId?: string | null; /** Refund amount */ amount?: Price; } interface MembershipPaymentRefund { /** Membership ID */ membershipId?: string | null; } interface PaymentRefunded { /** Refund ID. */ refundId?: string; /** Details about the refunded payment. */ payment?: RefundedPayment; } interface PaymentRefundFailed { /** Refund ID. */ refundId?: string; /** Details about the failed payment refund. */ payment?: RefundedPayment; } interface RefundedAsStoreCredit { /** Refund amount */ amount?: Price; /** Reason for refund */ reason?: string | null; } interface PaymentPending extends PaymentPendingPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; /** Payment ID of payment associated with this activity */ paymentId?: string; } /** @oneof */ interface PaymentPendingPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; } interface RegularPayment extends RegularPaymentPaymentMethodDetailsOneOf { /** Whether regular card used */ creditCardDetails?: CreditCardDetails; /** Payment amount */ amount?: Price; } /** @oneof */ interface RegularPaymentPaymentMethodDetailsOneOf { /** Whether regular card used */ creditCardDetails?: CreditCardDetails; } interface CreditCardDetails { /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface PaymentCanceled extends PaymentCanceledPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; /** Payment ID of payment associated with this activity */ paymentId?: string; } /** @oneof */ interface PaymentCanceledPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; } interface PaymentDeclined extends PaymentDeclinedPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; /** Payment ID of payment associated with this activity */ paymentId?: string; } /** @oneof */ interface PaymentDeclinedPaymentDetailsOneOf { /** Regular payment. */ regular?: RegularPayment; } interface ReceiptCreated extends ReceiptCreatedReceiptInfoOneOf { /** Receipt created by Wix */ wixReceipt?: WixReceipt; /** Receipt created by an external system. */ externalReceipt?: ExternalReceipt; /** Payment ID of payment associated with this activity */ paymentId?: string; } /** @oneof */ interface ReceiptCreatedReceiptInfoOneOf { /** Receipt created by Wix */ wixReceipt?: WixReceipt; /** Receipt created by an external system. */ externalReceipt?: ExternalReceipt; } interface WixReceipt { /** Receipt ID */ receiptId?: string; /** Display number of receipt */ displayNumber?: string | null; } interface ExternalReceipt { /** Receipt ID */ receiptId?: string | null; /** Display number of receipt */ displayNumber?: string | null; } interface ReceiptSent extends ReceiptSentReceiptInfoOneOf { /** Receipt created by Wix */ wixReceipt?: WixReceipt; /** Receipt created by an external system. */ externalReceipt?: ExternalReceipt; /** Payment ID of payment associated with this activity */ paymentId?: string; } /** @oneof */ interface ReceiptSentReceiptInfoOneOf { /** Receipt created by Wix */ wixReceipt?: WixReceipt; /** Receipt created by an external system. */ externalReceipt?: ExternalReceipt; } declare enum ActivityType { ORDER_REFUNDED = "ORDER_REFUNDED", ORDER_PLACED = "ORDER_PLACED", ORDER_PAID = "ORDER_PAID", ORDER_FULFILLED = "ORDER_FULFILLED", ORDER_NOT_FULFILLED = "ORDER_NOT_FULFILLED", ORDER_CANCELED = "ORDER_CANCELED", DOWNLOAD_LINK_SENT = "DOWNLOAD_LINK_SENT", TRACKING_NUMBER_ADDED = "TRACKING_NUMBER_ADDED", TRACKING_NUMBER_EDITED = "TRACKING_NUMBER_EDITED", TRACKING_LINK_ADDED = "TRACKING_LINK_ADDED", SHIPPING_CONFIRMATION_EMAIL_SENT = "SHIPPING_CONFIRMATION_EMAIL_SENT", INVOICE_ADDED = "INVOICE_ADDED", INVOICE_REMOVED = "INVOICE_REMOVED", INVOICE_SENT = "INVOICE_SENT", FULFILLER_EMAIL_SENT = "FULFILLER_EMAIL_SENT", SHIPPING_ADDRESS_EDITED = "SHIPPING_ADDRESS_EDITED", EMAIL_EDITED = "EMAIL_EDITED", PICKUP_READY_EMAIL_SENT = "PICKUP_READY_EMAIL_SENT", CUSTOM_ACTIVITY = "CUSTOM_ACTIVITY", MERCHANT_COMMENT = "MERCHANT_COMMENT", ORDER_CREATED_FROM_EXCHANGE = "ORDER_CREATED_FROM_EXCHANGE", NEW_EXCHANGE_ORDER_CREATED = "NEW_EXCHANGE_ORDER_CREATED", ORDER_PARTIALLY_PAID = "ORDER_PARTIALLY_PAID", DRAFT_ORDER_CHANGES_APPLIED = "DRAFT_ORDER_CHANGES_APPLIED", SAVED_PAYMENT_METHOD = "SAVED_PAYMENT_METHOD", /** @documentationMaturity preview */ PAYMENT_PENDING = "PAYMENT_PENDING", /** @documentationMaturity preview */ PAYMENT_CANCELED = "PAYMENT_CANCELED", /** @documentationMaturity preview */ PAYMENT_DECLINED = "PAYMENT_DECLINED", /** @documentationMaturity preview */ ORDER_PENDING = "ORDER_PENDING", /** @documentationMaturity preview */ ORDER_REJECTED = "ORDER_REJECTED" } declare enum AttributionSource { UNSPECIFIED = "UNSPECIFIED", FACEBOOK_ADS = "FACEBOOK_ADS" } interface CreatedBy extends CreatedByStringOneOf { /** * User ID - when the order was created by a Wix user on behalf of a buyer. * For example, via POS (point of service). */ userId?: string; /** Member ID - when the order was created by a **logged in** site visitor. */ memberId?: string; /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */ visitorId?: string; /** App ID - when the order was created by an external application. */ appId?: string; } /** @oneof */ interface CreatedByStringOneOf { /** * User ID - when the order was created by a Wix user on behalf of a buyer. * For example, via POS (point of service). */ userId?: string; /** Member ID - when the order was created by a **logged in** site visitor. */ memberId?: string; /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */ visitorId?: string; /** App ID - when the order was created by an external application. */ appId?: string; } interface ChannelInfo { /** Sales channel that submitted the order. */ type?: ChannelType; /** Reference to an order ID from an external system. */ externalOrderId?: string | null; /** URL to the order in the external system. */ externalOrderUrl?: string | null; } declare enum ChannelType { /** Unspecified sales channel. This value is not supported. */ UNSPECIFIED = "UNSPECIFIED", /** A web client. */ WEB = "WEB", /** [Point of sale solutions](https://support.wix.com/en/wix-mobile-pos-2196395). */ POS = "POS", /** [eBay shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-ebay-shop). */ EBAY = "EBAY", /** [Amazon shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-amazon-shop). */ AMAZON = "AMAZON", /** Other sales platform. */ OTHER_PLATFORM = "OTHER_PLATFORM", /** [Wix Owner app](https://support.wix.com/article/wix-owner-app-an-overview). */ WIX_APP_STORE = "WIX_APP_STORE", /** Wix Invoices app in [your dashboard](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Finvoices/settings/general-settings) */ WIX_INVOICES = "WIX_INVOICES", /** Wix merchant backoffice. */ BACKOFFICE_MERCHANT = "BACKOFFICE_MERCHANT", /** Wish sales channel. */ WISH = "WISH", /** [ClassPass sales channel](https://support.wix.com/en/article/wix-bookings-letting-clients-book-your-services-with-classpass). */ CLASS_PASS = "CLASS_PASS", /** Global-E sales channel. */ GLOBAL_E = "GLOBAL_E", /** [Facebook shop](https://support.wix.com/en/article/wix-stores-changes-to-facebook-shops). */ FACEBOOK = "FACEBOOK", /** [Etsy sales channel](https://support.wix.com/en/article/wix-stores-request-adding-etsy-as-a-sales-channel). */ ETSY = "ETSY", /** [TikTok sales channel](https://support.wix.com/en/article/wix-stores-request-adding-tiktok-as-a-sales-channel). */ TIKTOK = "TIKTOK", /** [Faire marketplace integration](https://support.wix.com/en/article/wix-stores-creating-a-faire-store-using-the-faire-integration-app). */ FAIRE_COM = "FAIRE_COM" } interface CustomField { /** Custom field value. */ value?: any; /** Custom field title. */ title?: string; /** Translated custom field title. */ translatedTitle?: string | null; } interface BalanceSummary { /** * Current amount left to pay. * @readonly */ balance?: Balance; /** * Sum of all approved and successful payments. * * The value includes payments that have subsequently been fully or partially refunded. * @readonly */ paid?: Price; /** * Sum of all successfully refunded payments. * @readonly */ refunded?: Price; /** * Sum of all authorized payments. * @readonly */ authorized?: Price; /** * Sum of all pending refund transactions. * @internal * @readonly */ pendingRefund?: Price; /** * Sum of all pending transactions. * @readonly */ pending?: Price; } /** * Order balance. Reflects amount left to be paid on order and is calculated dynamically. Can be negative per balance definition. * `amount` field depends on order payment status: * + UNSPECIFIED, NOT_PAID: price_summary.total_price * + PARTIALLY_PAID : price_summary.total_price - pay_now.total_price * + PENDING, REFUNDED, PARTIALLY_REFUNDED, PAID : 0 */ interface Balance { /** * Balance amount. * * A negative `amount` represents the amount to be refunded. This can happen due to overcharging or the order being modified after a payment has been made. * @readonly */ amount?: string; /** * Amount formatted with currency symbol. * @readonly */ formattedAmount?: string; } interface AdditionalFee { /** Additional fee's unique code for future processing. */ code?: string | null; /** Name of additional fee. */ name?: string; /** Additional fee's price. */ price?: Price; /** Tax details. */ taxDetails?: ItemTaxFullDetails; /** SPI implementer's `appId`. */ providerAppId?: string | null; /** Additional fee's price before tax. */ priceBeforeTax?: Price; /** Additional fee's price after tax. */ priceAfterTax?: Price; /** Additional fee's id. */ _id?: string; /** * Optional - Line items associated with this additional fee. * If no `lineItemIds` are provided, the fee will be associated with the whole cart/checkout/order. */ lineItemIds?: string[]; /** * Number of subscription billing cycles the additional fee applies to. * If None and additional fee is linked to subscription line item, it applies to all cycles. * @internal */ subscriptionCycles?: number | null; } interface FulfillmentStatusesAggregate { /** Unique string values based on Fulfillment entities statuses */ statuses?: string[] | null; } /** * Common object for tags. * Should be use as in this example: * message Foo { * string id = 1; * ... * Tags tags = 5 * } * * example of taggable entity * { * id: "123" * tags: { * tags: { * tag_ids:["11","22"] * }, * private_tags: { * tag_ids: ["33", "44"] * } * } * } */ interface Tags { /** Tags that require an additional permission in order to access them, normally not given to site members or visitors. */ privateTags?: TagList; /** Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors. */ tags?: TagList; } interface TagList { /** List of tag IDs */ tagIds?: string[]; } interface Location { /** * Location ID. * Learn more about the [Wix Locations API](https://dev.wix.com/docs/rest/business-management/locations/introduction). */ _id?: string; /** * Location name. * @readonly */ name?: string; } interface TriggerReindexOrderRequest { metasiteId?: string; orderId?: string; } interface SnapshotMessage { _id?: string; opType?: number; } /** Triggered when the payment status of an order is updated */ interface PaymentStatusUpdated { /** The order that was updated */ order?: Order; /** The previous status (before the update) */ previousPaymentStatus?: PaymentStatus; } /** Triggered when the the order status changes to approved */ interface OrderApproved { /** The order that was updated */ order?: Order; } interface OrdersExperiments { epCommitTax?: boolean; moveMerchantEmailToEp?: boolean; moveBuyerOrderConfirmationEmailToEp?: boolean; producedByEpBridge?: boolean; enableRewrittenSideEffects?: boolean; } interface OrderRejectedEventOrderRejected { /** The order that was rejected */ order?: Order; } /** Triggered when order items are marked as restocked */ interface OrderItemsRestocked { /** The order which items were restocked */ order?: Order; /** Restocked items and quantities */ restockItems?: V1RestockItem[]; } interface V1RestockItem { /** ID of the line item being restocked. */ lineItemId?: string; /** Line item quantity being restocked. */ quantity?: number; } interface GetMetasiteDataRequest { /** meta site Id for data to retrieve */ metasiteId?: string; } interface GetMetasiteDataResponse { /** meta site data */ metasite?: MetaSite; /** is metasite added to new SDL population via population manager */ isInNewPopulation?: boolean; /** metasite url */ metasiteUrl?: string; /** owner data */ userDataResponse?: UserDataResponse; } /** * Represents Meta Site. * * Meta Site is a legacy concept, it aggregates data from several domains. Generally, it contains and manages * relations between different entities related to the site (or, as a new concept, to the container). * * We prefer to pronounce it as 2 separate words, therefore we use terms "meta site" or "metaSite" or "meta_site" in code. */ interface MetaSite { /** * Identifier of meta site. * @readonly */ metaSiteId?: string; /** * Internal version of meta site. Monotonically increasing number. * * If passed within update request, it will be used for optimistic locking. In this case, * StaleStateException will be thrown if current version doesn't match. * * In old MetaSiteDTO -- revision. * @readonly */ version?: string; /** * Identifier of account that owns this meta site. * @readonly */ ownerId?: string; /** * Date and time when meta site was created. * @readonly */ dateCreated?: Date | null; /** * Date and time when meta site was updated for the last time. * @readonly */ dateUpdated?: Date | null; /** * All "applications" of this meta site. * * In old MetaSiteDTO -- embeddedServices. */ apps?: App[]; /** Namespace of meta site. */ namespace?: Namespace; /** * Indicates whether https should be used for viewing a site. * * In old MetaSiteDTO -- flags.UseHttps. */ useHttps?: boolean; defaultSeoData?: SeoData; /** * Information about HTML application. * * In old MetaSiteDTO -- appplications.find(_.applicationType == HtmlWeb). */ htmlApp?: HtmlApplication; /** @deprecated */ externalUriMappings?: ExternalUriMapping[]; /** Indicates whether meta site was published. If true - site should be accessible for viewing. */ published?: boolean; /** * The name of meta site. * * Matches this regular expression: [a-z0-9_\-]{4,20} (but for some legacy sites might be shorted/longer). */ name?: string; /** * Indicates whether this site is managed by ADI editor * * Values: * None - not managed. * Some(false) - site was created via ADI editor, but later on user switched to regular editor. * Some(true) - site was created and still is managed by ADI editor. * * In old MetaSiteDTO: embeddedService[embeddedServiceType=Onboarding].attributes.isInUse. */ adi?: boolean | null; /** * Indicates whether this meta site is template. * * In old MetaSiteDTO: documentType == Template. * @readonly */ template?: boolean | null; /** * Identifier of a template (meta site) from which this site was created. * * If it's empty it either means that site wasn't created from a template OR it's very old, so we didn't store * it back then. * * For example, if "site" was created from "template", then "template"'s id will be in origin_template_id. * When "site" is cloned, clone will also have "template"'s id in origin_instance_id. * @readonly */ originTemplateId?: string | null; /** * Indicates meta site blocked from publishing and added additional filtering in listing API (MSS). READ_ONLY. * @readonly */ blocked?: boolean; /** * If true - default meta site routing (connected domains, free url, ML) is not used for this meta site. * * Meaning, that if `example.org` is connected to this meta site, `router-server` will return 404 for `example.org` * anyway. * * This flag is set for some sites that have custom mapping in Routes API / wix-pages-bo. */ dontUseDefaultRouting?: boolean; /** * Indicates the site is used as critical asset and as such is protected. You would be only able to provision applications to this meta site. READ_ONLY. * @readonly */ criticalAsset?: boolean; /** * Date and time when the account that owns this meta site was created. * @readonly */ accountCreatedDate?: Date | null; } interface App { /** * Identifier of application type (application definition id). * * Can be both UUID and non-UUID, for example: SiteMembers, Onboarding, CloudSiteExtension etc. */ appDefId?: string; /** * Identifier of the instance (concrete application, installed on a site). * * Mostly UUID, but for some specific legacy cases might be something else. */ instanceId?: string; /** * State of this app (see docs for state). * @readonly */ state?: State; /** * Identifier of the originating application. For example, if this app was part of a template, * then an app will get instance_id of that app as origin instance id. * * If application was provisioned not from some template, it should be empty. * * Note, it could be == to instance_id (for old sites). */ originInstanceId?: string; } /** * Represents the actual state of the application on site. Do not confuse with the State in the old MetaSiteDTO, * which has less values and doesn't have 1-to-1 correspondence with this one (this one is exact and correct!) */ declare enum State { UNKNOWN = "UNKNOWN", /** App is installed on a site. */ ENABLED = "ENABLED", /** App is removed from a site (but we preserve it just in case). */ DISABLED = "DISABLED", /** App is in "demo" mode, meaning that it's in read-only mode (it's in a template OR not installed yet). */ TEMPLATE = "TEMPLATE", /** App is not installed, there is a user intention for it only (user will see the pimpl in the editor). */ PENDING = "PENDING" } declare enum Namespace { UNKNOWN_NAMESPACE = "UNKNOWN_NAMESPACE", /** Default namespace for UGC sites. MetaSites with this namespace will be shown in a user's site list by default. */ WIX = "WIX", /** ShoutOut stand alone product. These are siteless (no actual Wix site, no HtmlWeb). MetaSites with this namespace will *not* be shown in a user's site list by default. */ SHOUT_OUT = "SHOUT_OUT", /** MetaSites created by the Albums product, they appear as part of the Albums app. MetaSites with this namespace will *not* be shown in a user's site list by default. */ ALBUMS = "ALBUMS", /** Part of the WixStores migration flow, a user tries to migrate and gets this site to view and if the user likes it then stores removes this namespace and deletes the old site with the old stores. MetaSites with this namespace will *not* be shown in a user's site list by default. */ WIX_STORES_TEST_DRIVE = "WIX_STORES_TEST_DRIVE", /** Hotels standalone (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */ HOTELS = "HOTELS", /** Clubs siteless MetaSites, a club without a wix website. MetaSites with this namespace will *not* be shown in a user's site list by default. */ CLUBS = "CLUBS", /** A partially created ADI website. MetaSites with this namespace will *not* be shown in a user's site list by default. */ ONBOARDING_DRAFT = "ONBOARDING_DRAFT", /** AppBuilder for AppStudio / shmite (c). MetaSites with this namespace will *not* be shown in a user's site list by default. */ DEV_SITE = "DEV_SITE", /** LogoMaker websites offered to the user after logo purchase. MetaSites with this namespace will *not* be shown in a user's site list by default. */ LOGOS = "LOGOS", /** VideoMaker websites offered to the user after video purchase. MetaSites with this namespace will *not* be shown in a user's site list by default. */ VIDEO_MAKER = "VIDEO_MAKER", /** MetaSites with this namespace will *not* be shown in a user's site list by default. */ PARTNER_DASHBOARD = "PARTNER_DASHBOARD", /** MetaSites with this namespace will *not* be shown in a user's site list by default. */ DEV_CENTER_COMPANY = "DEV_CENTER_COMPANY", /** * A draft created by HTML editor on open. Upon "first save" it will be moved to be of WIX domain. * * Meta site with this namespace will *not* be shown in a user's site list by default. */ HTML_DRAFT = "HTML_DRAFT", /** * the user-journey for Fitness users who want to start from managing their business instead of designing their website. * Will be accessible from Site List and will not have a website app. * Once the user attaches a site, the site will become a regular wixsite. */ SITELESS_BUSINESS = "SITELESS_BUSINESS", /** Belongs to "strategic products" company. Supports new product in the creator's economy space. */ CREATOR_ECONOMY = "CREATOR_ECONOMY", /** It is to be used in the Business First efforts. */ DASHBOARD_FIRST = "DASHBOARD_FIRST", /** Bookings business flow with no site. */ ANYWHERE = "ANYWHERE", /** Namespace for Headless Backoffice with no editor */ HEADLESS = "HEADLESS", /** * Namespace for master site that will exist in parent account that will be referenced by subaccounts * The site will be used for account level CSM feature for enterprise */ ACCOUNT_MASTER_CMS = "ACCOUNT_MASTER_CMS", /** Rise.ai Siteless account management for Gift Cards and Store Credit. */ RISE = "RISE", /** * As part of the branded app new funnel, users now can create a meta site that will be branded app first. * There's a blank site behind the scene but it's blank). * The Mobile company will be the owner of this namespace. */ BRANDED_FIRST = "BRANDED_FIRST", /** Nownia.com Siteless account management for Ai Scheduling Assistant. */ NOWNIA = "NOWNIA", /** * UGC Templates are templates that are created by users for personal use and to sale to other users. * The Partners company owns this namespace. */ UGC_TEMPLATE = "UGC_TEMPLATE", /** Codux Headless Sites */ CODUX = "CODUX", /** Bobb - AI Design Creator. */ MEDIA_DESIGN_CREATOR = "MEDIA_DESIGN_CREATOR", /** * Shared Blog Site is a unique single site across Enterprise account, * This site will hold all Blog posts related to the Marketing product. */ SHARED_BLOG_ENTERPRISE = "SHARED_BLOG_ENTERPRISE" } interface SeoData { /** A title. */ title?: string | null; /** Indicates whether the site should be indexable by bots. */ indexable?: boolean; /** TDB. */ suppressTrackingCookies?: boolean; /** TDB. */ ogImage?: string | null; /** A list of meta tags. */ metaTags?: MetaTag[]; /** A canonical URL for a site. */ canonicalUrl?: string | null; } interface MetaTag { /** A name. */ name?: string; /** A value. */ value?: string; /** Indicates whether should be rendered as property. */ property?: boolean; } /** Represents an HTML application (HTML site). */ interface HtmlApplication { /** Legacy, don't use it if you can. */ intId?: number; /** Identifier of the instance. */ instanceId?: string; seoData?: SeoData; /** Language of this site. */ languageCode?: string; /** File name for thumbnail. */ thumbnail?: string | null; /** Indicates whether this site is managed by EditorX. */ editorX?: boolean; /** Indicates whether this site is managed by Wix Studio. */ studio?: boolean; } interface ExternalUriMapping { /** Deprecated. */ fromExternalUri?: string; /** Deprecated. */ toWixUri?: string; /** Deprecated. */ oldToWixUri?: string | null; /** Deprecated. */ requireDomain?: boolean | null; } interface UserDataResponse { userEmail?: string; /** owner name */ userName?: string; /** owner status */ userStatus?: string; /** owner language */ userLanguage?: string; } interface QueryOrdersForMetasiteRequest { /** meta site Id for EP orders to retrieve */ metasiteId?: string; /** paginated internal orders query request */ internalQueryOrdersRequest?: InternalQueryOrdersRequest; } interface InternalQueryOrdersRequest { /** Query options. */ query?: PlatformQuery; } interface PlatformQuery extends PlatformQueryPagingMethodOneOf { /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */ paging?: PlatformPaging; /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */ cursorPaging?: CursorPaging; /** Filter object. */ filter?: Record | null; /** Sorting options. For example, `[{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]`. */ sort?: Sorting[]; } /** @oneof */ interface PlatformQueryPagingMethodOneOf { /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */ paging?: PlatformPaging; /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */ cursorPaging?: CursorPaging; } interface Sorting { /** Name of the field to sort by. */ fieldName?: string; /** Sort order. */ order?: SortOrder; } declare enum SortOrder { ASC = "ASC", DESC = "DESC" } interface PlatformPaging { /** Number of items to load. */ limit?: number | null; /** Number of items to skip in the current sort order. */ offset?: number | null; } interface CursorPaging { /** Maximum number of items to return in the results. */ limit?: number | null; /** * Pointer to the next or previous page in the list of results. * * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. * Not relevant for the first request. */ cursor?: string | null; } interface QueryOrdersForMetasiteResponse { /** found exisitng orders according to pagination and query provided. */ orders?: Order[]; /** Details on the paged set of results returned. */ pagingMetadata?: PlatformPagingMetadata; } interface PlatformPagingMetadata { /** The number of items returned in this response. */ count?: number | null; /** The offset which was requested. Returned if offset paging was used. */ offset?: number | null; /** The total number of items that match the query. Returned if offset paging was used. */ total?: number | null; /** Cursors to navigate through result pages. Returned if cursor paging was used. */ cursors?: Cursors; } interface Cursors { /** Cursor string pointing to the next page in the list of results. */ next?: string | null; /** Cursor pointing to the previous page in the list of results. */ prev?: string | null; } interface GetOrderForMetasiteRequest { /** meta site Id for EP order to retrieve */ metasiteId?: string; /** Order Id for EP order to retrieve */ orderId?: string; } interface GetOrderForMetasiteResponse { /** Existing EP order */ order?: Order; } interface ListOrderTransactionsForMetasiteRequest { /** meta site Id for EP order transactions to retrieve */ metasiteId?: string; /** Order Id for EP order transactions to retrieve */ orderId?: string; } interface ListOrderTransactionsForMetasiteResponse { /** Order ID and its associated transactions. */ orderTransactions?: OrderTransactions; } interface OrderTransactions { /** Order ID. */ orderId?: string; /** Record of payments made to the merchant. */ payments?: Payment[]; /** Record of refunds made to the buyer. */ refunds?: Refund[]; } interface Payment extends PaymentPaymentDetailsOneOf, PaymentReceiptInfoOneOf { /** Regular payment details. */ regularPaymentDetails?: RegularPaymentDetails; /** Gift card payment details. */ giftcardPaymentDetails?: GiftCardPaymentDetails; /** * Receipt created by Wix * @internal */ wixReceipt?: WixReceiptInfo; /** * Receipt created by an external system. * @internal */ externalReceipt?: ExternalReceiptInfo; /** * Payment ID. * @readonly */ _id?: string | null; /** Date and time the payment was created in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Defaults to current time when not provided. */ _createdDate?: Date | null; /** * Date and time the payment was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * @readonly */ _updatedDate?: Date | null; /** Payment amount. */ amount?: Price; /** * Whether refunds for this payment are disabled. * + `true`: This payment is not refundable. * + `false`: This payment may be refunded. However, this ultimately depends on the payment provider. */ refundDisabled?: boolean; /** * Whether receipt generation for this payment are allowed. * + `true`: This payment supports receipt generation. * + `false`: This payment not supports receipt generation, or receipt already generated * @internal * @readonly */ supportReceiptGeneration?: boolean; } /** @oneof */ interface PaymentPaymentDetailsOneOf { /** Regular payment details. */ regularPaymentDetails?: RegularPaymentDetails; /** Gift card payment details. */ giftcardPaymentDetails?: GiftCardPaymentDetails; } /** @oneof */ interface PaymentReceiptInfoOneOf { /** * Receipt created by Wix * @internal */ wixReceipt?: WixReceiptInfo; /** * Receipt created by an external system. * @internal */ externalReceipt?: ExternalReceiptInfo; } interface RegularPaymentDetails extends RegularPaymentDetailsPaymentMethodDetailsOneOf { /** Whether regular card used */ creditCardDetails?: CreditCardPaymentMethodDetails; /** Wix Payments order ID. */ paymentOrderId?: string | null; /** * Payment gateway's transaction ID. This ID can be used with the Wix Payments [Transactions API](https://dev.wix.com/docs/rest/api-reference/wix-payments/transactions/introduction). * This field is only returned when the value of `offline_payment` is `false`. */ gatewayTransactionId?: string | null; /** * Payment method. Non-exhaustive list of supported values: * + `CreditCard`, `Alipay`, `AstropayCash`, `AstropayDBT`, `AstropayMBT`, `Bitcoin`, `BitPay`, `Cash`, `ConvenienceStore`, `EPay`, `Fake`, `Giropay`, `IDeal`, `InPerson`, `Klarna`, `MercadoPago`, `Netpay`, `NordeaSolo`, `Offline`, `PagSeguro`, `PayEasy`, `PayPal`, `Paysafecard`, `Paysafecash`, `PointOfSale`, `Poli`, `Privat24`, `Przelewy24`, `RapidTransfer`, `Sepa`, `Skrill`, `Sofort`, `Trustly`, `Neteller`, `Unionpay`, `UniPay`, `Yandex` */ paymentMethod?: string | null; /** Transaction ID in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for offline payments. */ providerTransactionId?: string | null; /** Whether the payment was made offline. For example, when using cash or when marked as paid in the Business Manager. */ offlinePayment?: boolean; /** Payment status. */ status?: TransactionStatus; /** Whether there is a payment agreement that allows for future charges. */ savedPaymentMethod?: boolean; /** Authorization details. */ authorizationDetails?: AuthorizationDetails; /** * Payment service provider display name. Non-exhaustive list of supported values: Wix Payments, PayPal, Square, Stripe, etc. * @internal */ paymentProvider?: string | null; } /** @oneof */ interface RegularPaymentDetailsPaymentMethodDetailsOneOf { /** Whether regular card used */ creditCardDetails?: CreditCardPaymentMethodDetails; } declare enum TransactionStatus { UNDEFINED = "UNDEFINED", APPROVED = "APPROVED", PENDING = "PENDING", PENDING_MERCHANT = "PENDING_MERCHANT", CANCELED = "CANCELED", DECLINED = "DECLINED", REFUNDED = "REFUNDED", PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED", AUTHORIZED = "AUTHORIZED", VOIDED = "VOIDED" } interface CreditCardPaymentMethodDetails { /** The last 4 digits of the card number. */ lastFourDigits?: string | null; /** Card issuer's brand. */ brand?: string | null; } interface AuthorizationDetails { /** * Whether the authorized payment is of a delayed capture. * @readonly */ delayedCapture?: boolean; /** Date and time the payment was authorized in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */ authorizedDate?: Date | null; /** * List of captures associated with payment * In case of failed it can be replaced with new one with PENDING or SUCCESS statuses */ captures?: AuthorizationCapture[]; /** Void associated with payment */ void?: AuthorizationVoid; /** Scheduled action for this transaction */ scheduledAction?: V1ScheduledAction; } interface AuthorizationCapture { /** * Capture ID. * @readonly */ _id?: string | null; /** Status of this capture action */ status?: AuthorizationCaptureStatus; /** Amount of this capture */ amount?: Price; /** Date and time the capture was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */ _createdDate?: Date | null; /** In case of status is FAILED may contain failure details */ failureDetails?: AuthorizationActionFailureDetails; } declare enum AuthorizationCaptureStatus { UNKNOWN_STATUS = "UNKNOWN_STATUS", /** Capture operation still in progress. */ PENDING = "PENDING", /** Capture operation succeeded. */ SUCCEEDED = "SUCCEEDED", /** Capture operation failed. */ FAILED = "FAILED" } interface AuthorizationActionFailureDetails { failureCode?: string; } interface AuthorizationVoid { /** Status of this void action */ status?: AuthorizationVoidStatus; /** Date and time the void was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */ voidedDate?: Date | null; /** In case of status is FAILED may contain failure details */ failureDetails?: AuthorizationActionFailureDetails; /** Reason of void action */ reason?: Reason; } declare enum AuthorizationVoidStatus { UNKNOWN_STATUS = "UNKNOWN_STATUS", /** Void operation still in progress. */ PENDING = "PENDING", /** Void operation succeeded. */ SUCCEEDED = "SUCCEEDED", /** Void operation failed. */ FAILED = "FAILED" } /** Reason the authorization was voided. */ declare enum Reason { UNKNOWN_REASON = "UNKNOWN_REASON", /** Authorization was voided by user. */ MANUAL = "MANUAL", /** Authorization passed execution date. */ SCHEDULED = "SCHEDULED" } interface V1ScheduledAction { /** Type of the action. */ actionType?: ActionType; /** The date and time of the action. */ executionDate?: Date | null; } declare enum ActionType { UNKNOWN_ACTION_TYPE = "UNKNOWN_ACTION_TYPE", VOID = "VOID", CAPTURE = "CAPTURE" } interface GiftCardPaymentDetails { /** Gift card payment ID. */ giftCardPaymentId?: string; /** ID of the app that created the gift card. */ appId?: string; /** * Whether the gift card is voided. * @readonly */ voided?: boolean; /** * Gift card obfuscated code. * @internal */ obfuscatedCode?: string | null; } interface MembershipPaymentDetails { /** Membership ID. */ membershipId?: string; /** ID of the line item this membership applies to. */ lineItemId?: string; /** Payment status. */ status?: MembershipPaymentStatus; /** Membership name. */ name?: MembershipName; /** The transaction ID in the membership system. Can be used to void the transaction. */ externalTransactionId?: string | null; /** * Whether the membership is voided. * @readonly */ voided?: boolean; /** ID of the application providing this payment option. */ providerAppId?: string; } declare enum MembershipPaymentStatus { /** Payment was charged. */ CHARGED = "CHARGED", /** The attempt to charge the payment failed, for example, due to lack of credits. */ CHARGE_FAILED = "CHARGE_FAILED" } interface MembershipName { /** Membership name. */ original?: string; /** Translated membership name. Defaults to `original` when not provided. */ translated?: string | null; } interface WixReceiptInfo { /** Receipt ID */ receiptId?: string; /** Display number of receipt */ displayNumber?: string | null; } interface ExternalReceiptInfo { /** External receipt ID */ receiptId?: string | null; /** ID of the app providing the receipt */ appId?: string | null; /** Display number of receipt */ displayNumber?: string | null; } interface Refund { /** * Refund ID. * @readonly */ _id?: string; /** List of transactions. */ transactions?: RefundTransaction[]; /** Refund business details. */ details?: RefundDetails; /** * Date and time the refund was created in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Defaults to current time when not provided. * @readonly */ _createdDate?: Date | null; /** * Aggregated refund status * @internal * @readonly */ summary?: AggregatedRefundSummary; /** * ID of the app that initiated this refund. * @internal * @readonly */ requestingServiceAppId?: string | null; } interface RefundTransaction { /** ID of the payment associated with this refund. */ paymentId?: string; /** Refund amount. */ amount?: Price; /** Refund status. */ refundStatus?: RefundStatus; /** Optional details of current refund status. */ refundStatusInfo?: RefundStatusInfo; /** * Payment gateway's refund ID. This ID can be used with the Wix Payments [Transactions API](https://dev.wix.com/docs/rest/api-reference/wix-payments/transactions/introduction). * This field is only returned when the value of `external_refund` is `false`. */ gatewayRefundId?: string | null; /** ID of the refund in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for external refunds. */ providerRefundId?: string | null; /** Whether refund was made externally and manually on the payment provider's side. */ externalRefund?: boolean; } /** Refund transaction status. */ declare enum RefundStatus { /** Refund was initiated on payment provider side. PENDING status was assigned by provider. */ PENDING = "PENDING", /** Refund transaction succeeded. */ SUCCEEDED = "SUCCEEDED", /** Refund transaction failed. */ FAILED = "FAILED", /** Refund request acknowledged, and will be executed soon. */ SCHEDULED = "SCHEDULED", /** Refund was initiated on payment provider side. */ STARTED = "STARTED" } interface RefundStatusInfo { /** * Reason code for the refund's current status. * * Learn more about [reason codes](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/reason-codes). * @internal */ paymentGatewayReasonCode?: string | null; /** * Free text explanation of current refund status. * @internal */ description?: string | null; } /** Business model of a refund request */ interface RefundDetails { /** Order line item IDs and quantities that were refunded. */ items?: RefundItem[]; /** Whether the shipping fee was also refunded. */ shippingIncluded?: boolean; /** Reason for the refund, provided by customer (optional). */ reason?: string | null; /** * Line items that were refunded. * @internal */ lineItems?: LineItemRefund[]; /** * Additional fees that were refunded. * @internal */ additionalFees?: AdditionalFeeRefund[]; /** * Shipping amount that was refunded. * @internal */ shipping?: ShippingRefund; } interface RefundItem { /** Line item ID the refunded line item. */ lineItemId?: string; /** Line item quantity refunded. */ quantity?: number; } interface LineItemRefund { /** * Line item ID. * @internal */ lineItemId?: string; /** * Refund quantity. * @internal */ quantity?: number; } interface AdditionalFeeRefund { /** * Additional fee ID. * @internal */ additionalFeeId?: string; /** * Refund amount. * @internal */ amount?: Price; } interface ShippingRefund { /** * Refund amount. * @internal */ amount?: Price; } interface AggregatedRefundSummary { /** * Total refund amount requested * @internal */ requestedRefund?: Price; /** * Pending refund amount * @internal */ pendingRefund?: Price; /** * Refunded amount: portion of requested_refund_amount that succeeded * @internal */ refunded?: Price; /** * Failed refund amount: portion of requested_refund_amount that failed * @internal */ failedRefundAmount?: Price; /** * `true`: at least one refund transaction is still in PENDING status * @internal */ pending?: boolean; /** Breakdown of refunded items. Available only after refund is completed */ breakdown?: RefundItemsBreakdown; } interface RefundItemsBreakdown { /** Refunded line items and amount refunded for each of them. */ lineItems?: LineItemRefundSummary[]; } interface LineItemRefundSummary { /** Line item ID the refunded line item. */ lineItemId?: string; /** Total refunded amount for the line item. */ totalRefundedAmount?: Price; } interface UpsertRefundRequest { /** Meta site ID. */ metasiteId?: string; /** Order ID associated with refund. */ orderId?: string; /** Refund to upsert. */ refund?: Refund; } interface UpsertRefundResponse { /** Updated order transactions. */ orderTransactions?: OrderTransactions; } interface DomainEvent extends DomainEventBodyOneOf { createdEvent?: EntityCreatedEvent; updatedEvent?: EntityUpdatedEvent; deletedEvent?: EntityDeletedEvent; actionEvent?: ActionEvent; /** * Unique event ID. * Allows clients to ignore duplicate webhooks. */ _id?: string; /** * Assumes actions are also always typed to an entity_type * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction */ entityFqdn?: string; /** * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug) * This is although the created/updated/deleted notion is duplication of the oneof types * Example: created/updated/deleted/started/completed/email_opened */ slug?: string; /** ID of the entity associated with the event. */ entityId?: string; /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */ eventTime?: Date | null; /** * Whether the event was triggered as a result of a privacy regulation application * (for example, GDPR). */ triggeredByAnonymizeRequest?: boolean | null; /** If present, indicates the action that triggered the event. */ originatedFrom?: string | null; /** * A sequence number defining the order of updates to the underlying entity. * For example, given that some entity was updated at 16:00 and than again at 16:01, * it is guaranteed that the sequence number of the second update is strictly higher than the first. * As the consumer, you can use this value to ensure that you handle messages in the correct order. * To do so, you will need to persist this number on your end, and compare the sequence number from the * message against the one you have stored. Given that the stored number is higher, you should ignore the message. */ entityEventSequence?: string | null; } /** @oneof */ interface DomainEventBodyOneOf { createdEvent?: EntityCreatedEvent; updatedEvent?: EntityUpdatedEvent; deletedEvent?: EntityDeletedEvent; actionEvent?: ActionEvent; } interface EntityCreatedEvent { entity?: string; } interface RestoreInfo { deletedDate?: Date | null; } interface EntityUpdatedEvent { /** * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff. * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects. * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it. */ currentEntity?: string; } interface EntityDeletedEvent { /** Entity that was deleted */ deletedEntity?: string | null; } interface ActionEvent { body?: string; } interface MessageEnvelope { /** App instance ID. */ instanceId?: string | null; /** Event type. */ eventType?: string; /** The identification type and identity data. */ identity?: IdentificationData; /** Stringify payload. */ data?: string; } interface IdentificationData extends IdentificationDataIdOneOf { /** ID of a site visitor that has not logged in to the site. */ anonymousVisitorId?: string; /** ID of a site visitor that has logged in to the site. */ memberId?: string; /** ID of a Wix user (site owner, contributor, etc.). */ wixUserId?: string; /** ID of an app. */ appId?: string; /** @readonly */ identityType?: WebhookIdentityType; } /** @oneof */ interface IdentificationDataIdOneOf { /** ID of a site visitor that has not logged in to the site. */ anonymousVisitorId?: string; /** ID of a site visitor that has logged in to the site. */ memberId?: string; /** ID of a Wix user (site owner, contributor, etc.). */ wixUserId?: string; /** ID of an app. */ appId?: string; } declare enum WebhookIdentityType { UNKNOWN = "UNKNOWN", ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR", MEMBER = "MEMBER", WIX_USER = "WIX_USER", APP = "APP" } interface UpdateInternalDocumentsEvent extends UpdateInternalDocumentsEventOperationOneOf { /** insert/update documents */ update?: InternalDocumentUpdateOperation; /** delete by document ids */ deleteByIds?: DeleteByIdsOperation; /** delete documents matching filter */ deleteByFilter?: DeleteByFilterOperation; /** update internal documents matching filter */ updateByFilter?: InternalDocumentUpdateByFilterOperation; /** update only existing documents */ updateExisting?: InternalUpdateExistingOperation; /** insert/update documents with versioning */ versionedUpdate?: VersionedDocumentUpdateOperation; /** delete by document ids with versioning */ versionedDeleteByIds?: VersionedDeleteByIdsOperation; /** type of the documents */ documentType?: string; /** language of the documents (mandatory) */ language?: string | null; /** * one or more search documents * @deprecated */ addDocuments?: InternalDocument[]; /** * one or more ids of indexed documents to be removed. Removal will happen before addition (if both provided) * @deprecated */ removeDocumentIds?: string[]; /** id to pass to processing notification */ correlationId?: string | null; /** when event was created / issued */ issuedAt?: Date | null; } /** @oneof */ interface UpdateInternalDocumentsEventOperationOneOf { /** insert/update documents */ update?: InternalDocumentUpdateOperation; /** delete by document ids */ deleteByIds?: DeleteByIdsOperation; /** delete documents matching filter */ deleteByFilter?: DeleteByFilterOperation; /** update internal documents matching filter */ updateByFilter?: InternalDocumentUpdateByFilterOperation; /** update only existing documents */ updateExisting?: InternalUpdateExistingOperation; /** insert/update documents with versioning */ versionedUpdate?: VersionedDocumentUpdateOperation; /** delete by document ids with versioning */ versionedDeleteByIds?: VersionedDeleteByIdsOperation; } interface InternalDocument { /** document with mandatory fields (id) and with fields specific to the type of the document */ document?: Record | null; } interface InternalDocumentUpdateOperation { /** documents to index or update */ documents?: InternalDocument[]; } interface DeleteByIdsOperation { /** ids of the documents to delete */ documentIds?: string[]; } interface DeleteByFilterOperation { /** documents matching this filter wil be deleted. only filterable documents defined in document_type can be used for filtering */ filter?: Record | null; } interface InternalDocumentUpdateByFilterOperation { /** documents matching this filter will be updated */ filter?: Record | null; /** partial document to apply */ document?: InternalDocument; } interface InternalUpdateExistingOperation { /** documents to update */ documents?: InternalDocument[]; } interface VersionedDocumentUpdateOperation { /** documents to create or overwrite */ documents?: InternalDocument[]; /** versioning mode to use instead of default */ versioningMode?: VersioningMode; } declare enum VersioningMode { /** use default versioning mode agreed with search team */ DEFAULT = "DEFAULT", /** execute only if version is greater than existing */ GREATER_THAN = "GREATER_THAN", /** execute only if version is greater or equal to existing */ GREATER_OR_EQUAL = "GREATER_OR_EQUAL" } interface VersionedDeleteByIdsOperation { /** ids with version of the documents to delete */ documentIds?: VersionedDocumentId[]; } interface VersionedDocumentId { /** document id */ documentId?: string; /** document version */ version?: string; /** versioning mode to use instead of default */ versioningMode?: VersioningMode; } interface TriggerReindexRequest { metasiteId?: string; orderIds?: string[]; } interface TriggerReindexResponse { } interface Empty { } interface BatchOfTriggerReindexOrderRequest { requests?: TriggerReindexOrderRequest[]; } interface SendBuyerConfirmationEmailRequest { orderId?: string; } interface SendBuyerConfirmationEmailResponse { } interface SendBuyerPaymentsReceivedEmailRequest { orderId?: string; } interface SendBuyerPaymentsReceivedEmailResponse { } interface SendBuyerPickupConfirmationEmailRequest { orderId?: string; } interface SendBuyerPickupConfirmationEmailResponse { } interface BulkSendBuyerPickupConfirmationEmailsRequest { /** IDs of orders to send pickup emails for. */ orderIds?: string[]; } interface BulkSendBuyerPickupConfirmationEmailsResponse { } interface SendBuyerShippingConfirmationEmailRequest { orderId?: string; } interface SendBuyerShippingConfirmationEmailResponse { } interface BulkSendBuyerShippingConfirmationEmailsRequest { /** IDs of orders to send pickup emails for. */ orderIds?: string[]; } interface BulkSendBuyerShippingConfirmationEmailsResponse { } interface SendMerchantOrderReceivedNotificationRequest { orderId?: string; } interface SendMerchantOrderReceivedNotificationResponse { } interface SendCancelRefundEmailRequest { /** The ID of order that is canceled/refunded */ orderId?: string; /** Personal note added to the email (optional) */ customMessage?: string | null; /** Refund amount */ refundAmount?: Price; /** Refund ID. (Optional) */ refundId?: string | null; } interface SendCancelRefundEmailResponse { } interface SendRefundEmailRequest { /** The ID of order that is refunded */ orderId?: string; /** Refund ID */ refundId?: string; /** Personal note added to the email (optional) */ customMessage?: string | null; } interface SendRefundEmailResponse { } interface SendMerchantOrderReceivedPushRequest { orderId?: string; } interface SendMerchantOrderReceivedPushResponse { } interface PreviewEmailByTypeRequest { emailType?: PreviewEmailType; } declare enum PreviewEmailType { ORDER_PLACED = "ORDER_PLACED", DOWNLOAD_LINKS = "DOWNLOAD_LINKS", ORDER_SHIPPED = "ORDER_SHIPPED", ORDER_READY_FOR_PICKUP = "ORDER_READY_FOR_PICKUP" } interface PreviewEmailByTypeResponse { emailPreview?: string; } interface PreviewRefundEmailRequest { orderId?: string; /** Refund amount */ refundAmount?: Price; /** Refund business details */ details?: RefundDetails; /** Personal note added to the email (optional) */ customMessage?: string | null; /** Refund ID. (Optional) */ refundId?: string | null; } interface PreviewRefundEmailResponse { emailPreview?: string; } interface PreviewCancelEmailRequest { orderId?: string; /** Personal note added to the email (optional) */ customMessage?: string | null; } interface PreviewCancelEmailResponse { emailPreview?: string; } interface PreviewCancelRefundEmailRequest { orderId?: string; /** Personal note added to the email (optional) */ customMessage?: string | null; /** Refund amount */ refundAmount?: Price; /** Refund ID. (Optional) */ refundId?: string | null; } interface PreviewCancelRefundEmailResponse { emailPreview?: string; } interface PreviewBuyerPaymentsReceivedEmailRequest { } interface PreviewBuyerPaymentsReceivedEmailResponse { emailPreview?: string; } interface PreviewBuyerConfirmationEmailRequest { } interface PreviewBuyerConfirmationEmailResponse { emailPreview?: string; } interface PreviewBuyerPickupConfirmationEmailRequest { } interface PreviewBuyerPickupConfirmationEmailResponse { emailPreview?: string; } interface PreviewShippingConfirmationEmailRequest { } interface PreviewShippingConfirmationEmailResponse { emailPreview?: string; } interface PreviewResendDownloadLinksEmailRequest { } interface PreviewResendDownloadLinksEmailResponse { emailPreview?: string; } interface PreparePaymentCollectionRequest { /** Ecom order ID. */ ecomOrderId: string; /** Amount to collect */ amount: Price; /** * Optional parameter. When present, payment collection will be performed using given payment gateway order. * Existing payment gateway order will be updated with a new amount. * When parameter is absent, new payment gateway order will be created and used for payment collection. */ paymentGatewayOrderId?: string | null; /** * Whether to delay capture of the payment. * Default: false * @deprecated Whether to delay capture of the payment. * Default: false * @replacedBy delayed_capture_settings.scheduled_action * @targetRemovalDate 2024-09-30 */ delayedCapture?: boolean; /** * Specifies whether payment collection is initiated by Merchant or User of User * Default: `true` * @internal */ merchantInitiated?: boolean | null; /** * Redirect urls which are used to return buyer to third party system. * @internal */ redirectUrls?: RedirectUrls; /** Delayed capture payment settings */ delayedCaptureSettings?: DelayedCaptureSettings; } interface RedirectUrls { /** URL to redirect buyer in case of approved (successful) transaction */ successUrl?: string | null; /** URL to redirect buyer in case of buyer canceled the transaction */ cancelUrl?: string | null; /** URL to redirect buyer in case of failed/rejected transaction */ errorUrl?: string | null; /** URL to redirect buyer in case of pending transaction (that might take some time to process) */ pendingUrl?: string | null; } interface DelayedCaptureSettings { /** Specifies the automatic action (void/capture) for authorized transaction after the specified duration */ scheduledAction?: ScheduledAction; /** Delay duration before execution. Optional - if not set, providers default period will be used */ delayDuration?: Duration; } declare enum ScheduledAction { UNSPECIFIED = "UNSPECIFIED", /** Whether payment will be auto-voided when duration passes */ VOID = "VOID", /** Whether payment will be auto-captured when duration passes */ CAPTURE = "CAPTURE" } interface Duration { /** Amount of units. For example, 30 MINUTES, 1 HOURS, 7 DAYS, etc */ count?: number; /** Duration unit: MINUTES, HOURS and DAYS */ unit?: DurationUnit; } declare enum DurationUnit { UNKNOWN_DURATION_UNIT = "UNKNOWN_DURATION_UNIT", MINUTES = "MINUTES", HOURS = "HOURS", DAYS = "DAYS" } interface PreparePaymentCollectionResponse { /** Payment gateway order id which is associated with given payment */ paymentGatewayOrderId?: string; } interface GetPaymentCollectabilityStatusRequest { /** Ecom order ID. */ ecomOrderId: string; } interface GetPaymentCollectabilityStatusResponse { /** Payment collectability status */ status?: PaymentCollectabilityStatus; /** Collectable order amount */ amount?: Price; } declare enum PaymentCollectabilityStatus { UNKNOWN = "UNKNOWN", COLLECTABLE = "COLLECTABLE", NONCOLLECTABLE_ORDER_IS_CANCELLED = "NONCOLLECTABLE_ORDER_IS_CANCELLED", NONCOLLECTABLE_ORDER_IS_PAID = "NONCOLLECTABLE_ORDER_IS_PAID", NONCOLLECTABLE_MISSING_PAYMENT_METHOD = "NONCOLLECTABLE_MISSING_PAYMENT_METHOD", NONCOLLECTABLE_ORDER_IS_PENDING = "NONCOLLECTABLE_ORDER_IS_PENDING", NONCOLLECTABLE_ORDER_IS_REJECTED = "NONCOLLECTABLE_ORDER_IS_REJECTED" } interface RecordManuallyCollectedPaymentRequest { /** Order ID. */ orderId: string; /** Amount to be recorded as approved manual payment for given order */ amount: Price; } interface RecordManuallyCollectedPaymentResponse { } interface MarkOrderAsPaidRequest { /** Ecom order ID. */ ecomOrderId: string; } interface MarkOrderAsPaidResponse { /** Updated order. */ order?: Order; } interface BulkMarkOrdersAsPaidRequest { /** IDs of orders to mark as paid. */ ecomOrderIds: string[]; } interface BulkMarkOrdersAsPaidResponse { /** * Items updated by the bulk action. * The Order entity within the results optimistically changes its payment status to paid, however this process is async. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkOrderResult { /** Item metadata. */ itemMetadata?: ItemMetadata; /** * Updated order. * * Returned when `returnFullEntity = true`. */ item?: Order; } interface ItemMetadata { /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */ _id?: string | null; /** Index of the item within the request array. Allows for correlation between request and response items. */ originalIndex?: number; /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */ success?: boolean; /** Details about the error in case of failure. */ error?: ApplicationError; } interface ApplicationError { /** Error code. */ code?: string; /** Description of the error. */ description?: string; /** Data related to the error. */ data?: Record | null; } interface BulkActionMetadata { /** Number of items that were successfully processed. */ totalSuccesses?: number; /** Number of items that couldn't be processed. */ totalFailures?: number; /** Number of failures without details because detailed failure threshold was exceeded. */ undetailedFailures?: number; } interface GetRefundabilityStatusRequest { /** Order ID. */ ecomOrderId: string; } interface GetRefundabilityStatusResponse { /** Refundability details. */ refundabilities?: Refundability[]; /** * Whether the order supports refunding per item. * @deprecated */ refundablePerItem?: boolean; } interface Refundability extends RefundabilityAdditionalRefundabilityInfoOneOf { /** Reason why payment is not refundable. */ nonRefundableReason?: NonRefundableReason; /** Reason why payment is only refundable manually. */ manuallyRefundableReason?: ManuallyRefundableReason; /** Payment ID. */ paymentId?: string; /** Payment refundability status. */ refundabilityStatus?: RefundableStatus; /** Link to payment provider dashboard. */ providerLink?: string | null; } /** @oneof */ interface RefundabilityAdditionalRefundabilityInfoOneOf { /** Reason why payment is not refundable. */ nonRefundableReason?: NonRefundableReason; /** Reason why payment is only refundable manually. */ manuallyRefundableReason?: ManuallyRefundableReason; } declare enum RefundableStatus { NOT_REFUNDABLE = "NOT_REFUNDABLE", MANUAL = "MANUAL", REFUNDABLE = "REFUNDABLE" } declare enum NonRefundableReason { NONE = "NONE", ALREADY_REFUNDED = "ALREADY_REFUNDED", PROVIDER_IS_DOWN = "PROVIDER_IS_DOWN", INTERNAL_ERROR = "INTERNAL_ERROR", NOT_PAID = "NOT_PAID", ACCESS_DENIED = "ACCESS_DENIED", ZERO_PRICE = "ZERO_PRICE", DISABLED_BY_PROVIDER = "DISABLED_BY_PROVIDER", PENDING_REFUND = "PENDING_REFUND", FORBIDDEN = "FORBIDDEN", TRANSACTION_NOT_FOUND = "TRANSACTION_NOT_FOUND", ORDER_IS_PENDING = "ORDER_IS_PENDING", ORDER_IS_REJECTED = "ORDER_IS_REJECTED" } declare enum ManuallyRefundableReason { EXPIRED = "EXPIRED", NOT_SUPPORTED = "NOT_SUPPORTED", OFFLINE = "OFFLINE", REQUIRES_CARD_READER = "REQUIRES_CARD_READER" } interface CreatePaymentGatewayOrderRequest { /** Ecom order ID. */ ecomOrderId: string; /** Information about the user who initiated the payment. */ chargedBy?: ChargedBy; } interface ChargedBy { /** ID - id of the user who initiated the payment */ _id?: string; /** Full name - name of the user who initiated the payment */ fullName?: string | null; } interface CreatePaymentGatewayOrderResponse { /** ID of the order created in the payment gateway */ paymentGatewayOrderId?: string; } interface ChargeMembershipsRequest { /** Order ID. */ ecomOrderId: string; /** * The member id. Do not attempt to get it from the request context, since in some cases the caller is not a member * but a user which is using the membership on behalf of the a member */ memberId: string; /** List of items to be paid by memberships */ membershipCharges?: MembershipChargeItem[]; } interface MembershipChargeItem { /** The id of used membership */ membershipId?: string; /** ID of the application providing this payment option */ appId?: string; /** The name of used membership */ membershipName?: MembershipName; /** Additional data about this membership */ membershipAdditionalData?: Record | null; /** Catalog and item reference info. */ catalogReference?: CatalogReference; /** Properties of the service. When relevant, contains information such as date and number of participants. */ serviceProperties?: ServiceProperties; /** * Usually would be the same as catalogReference.catalogItemId * For cases when these are not the same, this field would return the actual id of the item in the catalog * For example, for Wix bookings, catalogReference.catalogItemId is the booking id, and this value is being set to be the service id */ rootCatalogItemId?: string | null; /** line item id of Checkout/Order line item */ lineItemId?: string; } interface ServiceProperties { /** * Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * For example, the start time of a class. */ scheduledDate?: Date | null; /** The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room. */ numberOfParticipants?: number | null; } interface ChargeMembershipsResponse { } interface TriggerRefundRequest { /** The order this refund related to */ ecomOrderId: string; /** Refund operations information */ payments: PaymentRefund[]; /** Business model of a refund */ details?: RefundDetails; /** Side effect details related to refund */ sideEffects?: RefundSideEffects; } interface PaymentRefund { /** Specific payment within the order to refund */ paymentId?: string; /** Refund amount. Not relevant for membership and gift card refunds. */ amount?: Price; /** * Whether refund is made externally and manually (on the payment provider's side) * When false (default), the payment gateway will be called in order to make an actual refund, and then the payment will be marked as refunded. * When true, the payment will only be *marked* as refunded, and no actual refund will be performed. */ externalRefund?: boolean; } interface RefundSideEffects { /** Inventory restock details as part of this refund. */ restockInfo?: RestockInfo; /** Whether to send a refund confirmation email to the customer. */ sendOrderRefundedEmail?: boolean; /** Custom message added to the refund confirmation email. */ customMessage?: string | null; } interface RestockInfo { /** Restock type. */ type?: RestockType; /** Restocked line items and quantities. Only relevant for `{"type": "SOME_ITEMS"}`. */ items?: RestockItem[]; } declare enum RestockType { NO_ITEMS = "NO_ITEMS", ALL_ITEMS = "ALL_ITEMS", SOME_ITEMS = "SOME_ITEMS" } interface RestockItem { /** ID of the line item being restocked. */ lineItemId?: string; /** Line item quantity being restocked. */ quantity?: number; } interface TriggerRefundResponse { /** All order's transactions after the refunds were added */ orderTransactions?: OrderTransactions; /** Created refund ID */ refundId?: string | null; /** Payment ID's that the refund execution had failed for */ failedPaymentIds?: ItemMetadata[]; } interface CalculateRefundRequest { /** Order ID */ ecomOrderId?: string; /** Refunded line items and quantity */ refundItems?: CalculateRefundItemRequest[]; /** Should include shipping in refund calculation */ refundShipping?: boolean; } interface CalculateRefundItemRequest { /** ID of the line item being refunded */ _id?: string; /** How much of that line item is being refunded */ quantity?: number; } interface CalculateRefundResponse { /** Total refundable amount */ total?: Price; /** Tax cost of the order */ tax?: Price; /** Discount given for this order */ discount?: Price; /** Total cost of the order (without tax) */ subtotal?: Price; /** Total shipping cost for order */ shipping?: Price; /** Previous refund given on that order */ previouslyRefundedAmount?: Price; /** The refundable items of that order */ items?: CalculateRefundItemResponse[]; } interface CalculateRefundItemResponse { /** Line item ID */ _id?: string; /** Refundable amount for requested quantity of items (price of requested quantity of items without tax and discount) */ price?: Price; } interface VoidAuthorizedPaymentsRequest { /** Wix eCommerce order ID */ ecomOrderId: string; /** Payment IDs */ paymentIds: string[]; } interface VoidAuthorizedPaymentsResponse { /** All order's transactions after the void was triggered */ orderTransactions?: OrderTransactions; } interface CaptureAuthorizedPaymentsRequest { /** Wix eCommerce order ID */ ecomOrderId: string; /** Capture payments information */ payments: PaymentCapture[]; } interface PaymentCapture { /** Payment ID */ paymentId?: string | null; /** * Capture amount. * If not provided - full authorized amount will be captured. */ amount?: Price; } interface CaptureAuthorizedPaymentsResponse { /** All order's transactions after the capture was triggered */ orderTransactions?: OrderTransactions; } interface ChargeSavedPaymentMethodRequest { /** Ecom Order ID. */ ecomOrderId?: string; /** Amount to be charged */ amount?: Price; } interface ChargeSavedPaymentMethodResponse { /** Payment gateway's order ID (e.g Wix Payments) */ paymentGatewayOrderId?: string; } interface DiffmatokyPayload { left?: string; right?: string; compareChannel?: string; entityId?: string; errorInformation?: ErrorInformation; tags?: string[]; } interface ErrorInformation { stackTrace?: string; } interface ContinueSideEffectsFlowInLegacyData { storeId?: string; orderId?: string; ordersExperiments?: OrdersExperiments; } interface IndexingMessage { _id?: string; opType?: number; requiredVersions?: string[]; } interface GetOrderRequest { /** ID of the order to retrieve. */ _id: string; } interface GetOrderResponse { /** The requested order. */ order?: Order; } interface InternalQueryOrdersResponse { /** List of orders. */ orders?: Order[]; /** Details on the paged set of results returned. */ metadata?: PlatformPagingMetadata; } interface QueryOrderRequest { /** Query options. */ query?: PlatformQuery; } interface QueryOrderResponse { /** List of orders. */ orders?: Order[]; /** Details on the paged set of results returned. */ metadata?: PlatformPagingMetadata; } interface SearchOrdersRequest { /** Search options. */ search?: CursorSearch; } interface CursorSearch extends CursorSearchPagingMethodOneOf { /** * Cursor paging options. * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging). */ cursorPaging?: CursorPaging; /** * Filter object. * * For example, the following `filter` object will only return orders with payment statuses of paid and/or partially paid: * * `"filter": {"paymentStatus": {"$in": ["PAID", "PARTIALLY_PAID"]}}` * * Learn more about the [filter format](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section). */ filter?: Record | null; /** * Array of sort objects that specify the order in which results should be sorted. * * For example, the following `sort` array will sort by `createdDate` in descending order: * * `"sort": [{"fieldName": "createdDate", "order":"DESC"}]`. * * Learn more about the [sort format](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section). */ sort?: Sorting[]; } /** @oneof */ interface CursorSearchPagingMethodOneOf { /** * Cursor paging options. * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging). */ cursorPaging?: CursorPaging; } interface SearchOrdersResponse { /** List of orders. */ orders?: Order[]; /** Details on the paged set of results returned. */ metadata?: CursorPagingMetadata; } interface CursorPagingMetadata { /** Number of items returned in current page. */ count?: number | null; /** Cursor strings that point to the next page, previous page, or both. */ cursors?: Cursors; /** * Whether there are more pages to retrieve following the current page. * * + `true`: Another page of results can be retrieved. * + `false`: This is the last page. */ hasNext?: boolean | null; } interface CreateOrderRequest { /** Order info. */ order: Order; /** Determine order lifecycle */ settings?: OrderCreationSettings; } interface OrderCreationSettings { /** * Condition for the order to be approved. * Default: `DEFAULT` */ orderApprovalStrategy?: OrderApprovalStrategy; /** Notification settings to be applied on order creation */ notifications?: OrderCreateNotifications; } declare enum OrderApprovalStrategy { /** Order is automatically approved when `order.priceSummary.total = 0`, **or** after receiving payment. */ DEFAULT = "DEFAULT", /** Order is automatically approved **only** after receiving payment. */ PAYMENT_RECEIVED = "PAYMENT_RECEIVED", /** Order is automatically approved when payment method is saved for it. */ PAYMENT_METHOD_SAVED = "PAYMENT_METHOD_SAVED" } interface OrderCreateNotifications { /** * Whether to send notification to the buyer. * * Default: `true` */ sendNotificationToBuyer?: boolean | null; /** * Whether to send notifications to the business. * * Default: `true` */ sendNotificationsToBusiness?: boolean | null; } interface CreateOrderResponse { /** Newly created order. */ order?: Order; } interface UpdateOrderRequest { /** Order to be updated. */ order: Order; } interface UpdateOrderResponse { /** Newly created order. */ order?: Order; } interface BulkUpdateOrdersRequest { /** Orders to update. */ orders: MaskedOrder[]; /** * Whether to return the full order entities. * * Default: `false` */ returnEntity?: boolean; } interface MaskedOrder { /** Order to be updated. */ order?: Order; } interface BulkUpdateOrdersResponse { /** Bulk action results. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface CommitDeltasRequest { /** Order id to be updated */ _id: string; /** * Draft order Id representing this change. * Use this ID to get this specific draft content. call .../v1/draft-orders/{draft_order_id}/get */ draftOrderId?: string; /** Draft order changes to be applied */ changes: DraftOrderDiffs; /** Side-effects to happen after order is updated */ commitSettings?: DraftOrderCommitSettings; /** Reason for edit, given by user (optional). */ reason?: string | null; } interface DraftOrderDiffs extends DraftOrderDiffsShippingUpdateInfoOneOf, DraftOrderDiffsBuyerUpdateInfoOneOf, DraftOrderDiffsBillingUpdateInfoOneOf, DraftOrderDiffsRecipientUpdateInfoOneOf { /** Shipping info and selected shipping option details. */ changedShippingInfo?: V1ShippingInformation; /** Remove existing shipping info. */ shippingInfoRemoved?: boolean; /** * Buyer info and selected buyer option details. * @internal */ changedBuyerInfo?: BuyerInfo; /** * Remove existing buyer info. * @internal */ buyerInfoRemoved?: boolean; /** * Updated billing info. * @internal */ changedBillingInfo?: AddressWithContact; /** * Remove existing billing info. * @internal */ billingInfoRemoved?: boolean; /** * Updated recipient info. * @internal */ changedRecipientInfo?: AddressWithContact; /** * Remove existing recipient info. * @internal */ recipientInfoRemoved?: boolean; /** Added/updated/removed order line items. */ lineItems?: V1LineItemDelta[]; /** Added/updated/removed discounts. */ appliedDiscounts?: AppliedDiscountDelta[]; /** Added/updated/removed additional fee. */ additionalFees?: AdditionalFeeDelta[]; /** * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Updated Tax summary. overwrites existing tax summary. * @deprecated Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Updated Tax summary. overwrites existing tax summary. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxSummary?: TaxSummary; /** * Updated order price summary. overwrites existing price summary. * balance will be updated automatically. */ priceSummary?: PriceSummary; } /** @oneof */ interface DraftOrderDiffsShippingUpdateInfoOneOf { /** Shipping info and selected shipping option details. */ changedShippingInfo?: V1ShippingInformation; /** Remove existing shipping info. */ shippingInfoRemoved?: boolean; } /** @oneof */ interface DraftOrderDiffsBuyerUpdateInfoOneOf { /** * Buyer info and selected buyer option details. * @internal */ changedBuyerInfo?: BuyerInfo; /** * Remove existing buyer info. * @internal */ buyerInfoRemoved?: boolean; } /** @oneof */ interface DraftOrderDiffsBillingUpdateInfoOneOf { /** * Updated billing info. * @internal */ changedBillingInfo?: AddressWithContact; /** * Remove existing billing info. * @internal */ billingInfoRemoved?: boolean; } /** @oneof */ interface DraftOrderDiffsRecipientUpdateInfoOneOf { /** * Updated recipient info. * @internal */ changedRecipientInfo?: AddressWithContact; /** * Remove existing recipient info. * @internal */ recipientInfoRemoved?: boolean; } interface V1LineItemDelta extends V1LineItemDeltaDeltaOneOf { /** The line item was added. */ lineItemAdded?: boolean; /** The line item was modified. */ changedDetails?: ItemChangedDetails; /** The line item was added. */ lineItemRemoved?: boolean; /** Line item ID. */ lineItemId?: string; lineItem?: OrderLineItemChangedDetails; } /** @oneof */ interface V1LineItemDeltaDeltaOneOf { /** The line item was added. */ lineItemAdded?: boolean; /** The line item was modified. */ changedDetails?: ItemChangedDetails; /** The line item was added. */ lineItemRemoved?: boolean; } interface OrderLineItemChangedDetails { /** * Item name. * + Stores - `product.name` * + Bookings - `service.info.name` * + Events - `ticket.name` */ productName?: ProductName; /** * References to the line item's origin catalog. * This field may be empty in the case of a custom line item. */ catalogReference?: CatalogReference; /** Line item quantity. */ quantity?: number; /** Total discount for this line item's entire quantity. */ totalDiscount?: Price; /** Line item description lines. Used for display purposes for the cart, checkout and order. */ descriptionLines?: DescriptionLine[]; /** Line item image. */ image?: string; /** Physical properties of the item. When relevant, contains information such as SKU and item weight. */ physicalProperties?: PhysicalProperties; /** Item type. Either a preset type or custom. */ itemType?: ItemType; /** * Fulfiller ID. Field is empty when the line item is self-fulfilled. * * To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://www.wix.com/velo/reference/wix-ecom-backend/orderfulfillments/listfulfillmentsforsingleorder). */ fulfillerId?: string | null; /** Line item price after line item discounts for display purposes. */ price?: Price; /** Line item price before line item discounts for display purposes. Defaults to `price` when not provided. */ priceBeforeDiscounts?: Price; /** Total price after all discounts and tax. */ totalPriceAfterTax?: Price; /** * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`. * + `FULL_PAYMENT_OFFLINE` - The entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods. * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0. */ paymentOption?: DeltaPaymentOptionType; /** * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @deprecated Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxDetails?: ItemTaxFullDetails; /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */ priceDescription?: PriceDescription; /** Total price **after** catalog-defined discount and line item discounts. */ lineItemPrice?: Price; /** Total price after all discounts excluding tax. */ totalPriceBeforeTax?: Price; /** * ID of the app managing the inventory. * @internal */ inventoryAppId?: string | null; /** Subscription info. */ subscriptionInfo?: SubscriptionInfo; } /** Type of selected payment option for catalog item */ declare enum DeltaPaymentOptionType { /** Irrelevant */ UNKNOWN_PAYMENT_OPTION = "UNKNOWN_PAYMENT_OPTION", /** The entire payment for the given item will happen after checkout. */ FULL_PAYMENT_OFFLINE = "FULL_PAYMENT_OFFLINE", /** * Payment for this item can only be done using a membership and must be manually redeemed in the dashboard by the site owner. * Note: when this option is used, the price will be 0. */ MEMBERSHIP_OFFLINE = "MEMBERSHIP_OFFLINE" } interface ItemChangedDetails { /** The quantity before the change. */ quantityBeforeChange?: number | null; /** The price before the change. */ priceBeforeChange?: Price; /** The price description before the change */ priceDescriptionBeforeChange?: PriceDescription; } interface AppliedDiscountDelta extends AppliedDiscountDeltaDeltaOneOf { editedDiscount?: AppliedDiscount; discountRemoved?: boolean; /** Discount id. */ discountId?: string; } /** @oneof */ interface AppliedDiscountDeltaDeltaOneOf { editedDiscount?: AppliedDiscount; discountRemoved?: boolean; } interface AdditionalFeeDelta extends AdditionalFeeDeltaDeltaOneOf { editedAdditionalFee?: AdditionalFee; additionalFeeRemoved?: boolean; /** Additional fee id. */ additionalFeeId?: string; } /** @oneof */ interface AdditionalFeeDeltaDeltaOneOf { editedAdditionalFee?: AdditionalFee; additionalFeeRemoved?: boolean; } interface DraftOrderCommitSettings { /** If false, do not send notifications to buyer. Default is true. */ sendNotificationsToBuyer?: boolean | null; /** If false, do not send notifications to business. Default is true. */ sendNotificationsToBusiness?: boolean | null; /** If false, do not add activities to the order. Default is true. */ addActivitiesToOrder?: boolean | null; /** If false, do not send mails to custom fulfillers in case of a change of shippable items fulfilled by custom fulfillers. Default is true. */ sendNotificationsToCustomFulfillers?: boolean | null; /** Inventory changes to be applied. Either to restock, or decrease. */ inventoryUpdates?: InventoryUpdateDetails[]; } interface InventoryUpdateDetails { /** Action to be applied - decrease or restock */ actionType?: InventoryAction; /** Order line item id */ lineItemId?: string; /** The amount to be increased or restocked */ quantityChange?: number; } declare enum InventoryAction { /** Restock inventory */ RESTOCK = "RESTOCK", /** Decrease inventory. Without failing on negative inventory. */ DECREASE = "DECREASE" } interface CommitDeltasResponse { /** Order after deltas are applied */ order?: Order; } /** Triggered when order is edited by draftOrders */ interface OrderDeltasCommitted { /** The order after committed changes. */ order?: Order; /** Draft order Id representing this change. */ draftOrderId?: string; /** Applied changes. */ changes?: CommittedDiffs; /** Side-effects requested to happen as a result of this edit. */ commitSettings?: DraftOrderCommitSettings; /** * Date and time when order deltas were committed. * @readonly */ commitDate?: Date | null; } interface CommittedDiffs extends CommittedDiffsShippingUpdateInfoOneOf { /** Shipping info and selected shipping option details. */ changedShippingInfo?: V1ShippingInformation; /** Remove existing shipping info. */ shippingInfoRemoved?: boolean; /** Added/updated/removed order line items. */ lineItems?: LineItemDelta[]; /** Added/updated/removed discounts. */ appliedDiscounts?: AppliedDiscountDelta[]; /** Added/updated/removed additional fee. */ additionalFees?: AdditionalFeeDelta[]; } /** @oneof */ interface CommittedDiffsShippingUpdateInfoOneOf { /** Shipping info and selected shipping option details. */ changedShippingInfo?: V1ShippingInformation; /** Remove existing shipping info. */ shippingInfoRemoved?: boolean; } interface LineItemDelta extends LineItemDeltaDeltaOneOf { lineItemAdded?: boolean; changedDetails?: ItemChangedDetails; lineItemRemoved?: OrderLineItemChangedDetails; /** Line item ID. */ lineItemId?: string; } /** @oneof */ interface LineItemDeltaDeltaOneOf { lineItemAdded?: boolean; changedDetails?: ItemChangedDetails; lineItemRemoved?: OrderLineItemChangedDetails; } interface ArchiveOrderRequest { /** Order ID. */ _id?: string; } interface ArchiveOrderResponse { /** Archived order. */ order?: Order; } interface BulkArchiveOrdersRequest { /** IDs of orders to archive. */ ids?: string[]; /** Whether to return the full updated order entities in the response. */ returnFullEntity?: boolean; } interface BulkArchiveOrdersResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkArchiveOrdersByFilterRequest { /** Filter object. Learn more about supported filters [here](https://bo.wix.com/wix-docs/rest/ecommerce/orders/filter-and-sort). */ filter?: Record | null; } interface BulkArchiveOrdersByFilterResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface UnArchiveOrderRequest { /** Order ID. */ _id?: string; } interface UnArchiveOrderResponse { /** Unarchived order. */ order?: Order; } interface BulkUnArchiveOrdersRequest { /** IDs or orders to unarchive. */ ids?: string[]; /** Whether to return the full updated order entities in the response. */ returnFullEntity?: boolean; } interface BulkUnArchiveOrdersResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkUnArchiveOrdersByFilterRequest { /** Filter object. Learn more about supported filters [here](https://bo.wix.com/wix-docs/rest/ecommerce/orders/filter-and-sort). */ filter?: Record | null; } interface BulkUnArchiveOrdersByFilterResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface UpdateBuyerInfoRequest { /** * Order ID. * @readonly */ _id?: string; /** Buyer info. */ buyerInfo?: BuyerInfoUpdate; } interface BuyerInfoUpdate { /** Contact ID. */ contactId?: string | null; /** Email associated with the buyer. */ email?: string | null; } interface UpdateBuyerInfoResponse { /** Updated order. */ order?: Order; } interface UpdateBuyerEmailRequest { /** @readonly */ _id?: string; email?: string | null; } interface UpdateBuyerEmailResponse { order?: Order; } interface UpdateOrderShippingAddressRequest { /** Order ID. */ _id?: string; /** Shipping address and contact details to be updated. */ shippingAddress?: AddressWithContact; } interface UpdateOrderShippingAddressResponse { /** Updated order. */ order?: Order; } interface UpdateBillingContactDetailsRequest { /** * Order ID. * @readonly */ _id?: string; /** Contact details. */ addressContactDetails?: FullAddressContactDetails; } interface UpdateBillingContactDetailsResponse { /** Updated order. */ order?: Order; } interface UpdateOrderLineItemRequest { /** Order ID */ _id: string; /** Order line item to update */ lineItem: OrderLineItem; } interface UpdateOrderLineItemResponse { /** Updated order data */ order?: Order; } interface UpdateOrderLineItemsRequest { /** Order ID */ orderId?: string; /** Order line items to update */ lineItems?: MaskedOrderLineItem[]; } interface MaskedOrderLineItem { /** Order line item to update */ lineItem?: OrderLineItem; } interface UpdateOrderLineItemsResponse { /** Updated order data */ order?: Order; } interface AddInternalActivityRequest { /** Order ID. */ _id?: string; /** Activity info. */ activity?: InternalActivity; } interface InternalActivity extends InternalActivityContentOneOf { /** Order refunded. */ orderRefunded?: OrderRefunded; /** Order placed. */ orderPlaced?: OrderPlaced; /** Order paid. Either by the store owner (for offline orders), or when an online transaction was confirmed. */ orderPaid?: OrderPaid; /** Order shipping status set as fulfilled. */ orderFulfilled?: OrderFulfilled; /** Order shipping status set as not fulfilled. */ orderNotFulfilled?: OrderNotFulfilled; /** Order canceled. */ orderCanceled?: OrderCanceled; /** Download link was sent (relevant for orders with digital line items). */ downloadLinkSent?: DownloadLinkSent; /** Shipping tracking number added to order. */ trackingNumberAdded?: TrackingNumberAdded; /** Shipping tracking number was edited. */ trackingNumberEdited?: TrackingNumberEdited; /** Shipping tracking link added to order. */ trackingLinkAdded?: TrackingLinkAdded; /** An email confirmation of order shipment was sent. */ shippingConfirmationEmailSent?: ShippingConfirmationEmailSent; /** Invoice was added to order. */ invoiceAdded?: InvoiceAdded; /** Invoice sent to customer via email. */ invoiceSent?: InvoiceSent; /** Email sent to fulfiller. */ fulfillerEmailSent?: FulfillerEmailSent; /** Shipping address was updated. */ shippingAddressEdited?: ShippingAddressEdited; /** Order email was updated. */ emailEdited?: EmailEdited; /** Email notification for pickup sent. */ pickupReadyEmailSent?: PickupReadyEmailSent; /** Order created as a result of items exchange. */ orderCreatedFromExchange?: OrderCreatedFromExchange; /** New exchange order created. */ newExchangeOrderCreated?: NewExchangeOrderCreated; /** Order partially paid. During the checkout for orders with deposit items. */ orderPartiallyPaid?: OrderPartiallyPaid; /** Draft order changes applied */ draftOrderChangesApplied?: DraftOrderChangesApplied; /** Payment method is saved for order */ savedPaymentMethod?: SavedPaymentMethod; /** * Details of an initiated refund process. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ refundInitiated?: RefundInitiated; /** * Details of a refunded payment. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefunded?: PaymentRefunded; /** * Details of a failed payment refund. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefundFailed?: PaymentRefundFailed; /** * Details of refund to store credit. * @internal */ refundedAsStoreCredit?: RefundedAsStoreCredit; /** Details of a pending payment */ paymentPending?: PaymentPending; /** Details of a canceled payment */ paymentCanceled?: PaymentCanceled; /** Details of a declined payment */ paymentDeclined?: PaymentDeclined; /** Order pending */ orderPending?: OrderPending; /** Order rejected */ orderRejected?: OrderRejected; /** * Receipt was added for associated payment * @internal */ receiptCreated?: ReceiptCreated; /** * Receipt sent to customer * @internal */ receiptSent?: ReceiptSent; /** * Internal activity ID. * @readonly */ _id?: string | null; /** * Internal activity author's email. * @readonly */ authorEmail?: string | null; /** * Internal activity creation date and time. * @readonly */ _createdDate?: Date | null; } /** @oneof */ interface InternalActivityContentOneOf { /** Order refunded. */ orderRefunded?: OrderRefunded; /** Order placed. */ orderPlaced?: OrderPlaced; /** Order paid. Either by the store owner (for offline orders), or when an online transaction was confirmed. */ orderPaid?: OrderPaid; /** Order shipping status set as fulfilled. */ orderFulfilled?: OrderFulfilled; /** Order shipping status set as not fulfilled. */ orderNotFulfilled?: OrderNotFulfilled; /** Order canceled. */ orderCanceled?: OrderCanceled; /** Download link was sent (relevant for orders with digital line items). */ downloadLinkSent?: DownloadLinkSent; /** Shipping tracking number added to order. */ trackingNumberAdded?: TrackingNumberAdded; /** Shipping tracking number was edited. */ trackingNumberEdited?: TrackingNumberEdited; /** Shipping tracking link added to order. */ trackingLinkAdded?: TrackingLinkAdded; /** An email confirmation of order shipment was sent. */ shippingConfirmationEmailSent?: ShippingConfirmationEmailSent; /** Invoice was added to order. */ invoiceAdded?: InvoiceAdded; /** Invoice sent to customer via email. */ invoiceSent?: InvoiceSent; /** Email sent to fulfiller. */ fulfillerEmailSent?: FulfillerEmailSent; /** Shipping address was updated. */ shippingAddressEdited?: ShippingAddressEdited; /** Order email was updated. */ emailEdited?: EmailEdited; /** Email notification for pickup sent. */ pickupReadyEmailSent?: PickupReadyEmailSent; /** Order created as a result of items exchange. */ orderCreatedFromExchange?: OrderCreatedFromExchange; /** New exchange order created. */ newExchangeOrderCreated?: NewExchangeOrderCreated; /** Order partially paid. During the checkout for orders with deposit items. */ orderPartiallyPaid?: OrderPartiallyPaid; /** Draft order changes applied */ draftOrderChangesApplied?: DraftOrderChangesApplied; /** Payment method is saved for order */ savedPaymentMethod?: SavedPaymentMethod; /** * Details of an initiated refund process. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ refundInitiated?: RefundInitiated; /** * Details of a refunded payment. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefunded?: PaymentRefunded; /** * Details of a failed payment refund. * * > **Note:** A single `refund_initiated` activity can result in multiple `payment_refunded` or `payment_refund_failed` activities. * > In these cases, the `refund_id` will be identical across the activities. * @internal */ paymentRefundFailed?: PaymentRefundFailed; /** * Details of refund to store credit. * @internal */ refundedAsStoreCredit?: RefundedAsStoreCredit; /** Details of a pending payment */ paymentPending?: PaymentPending; /** Details of a canceled payment */ paymentCanceled?: PaymentCanceled; /** Details of a declined payment */ paymentDeclined?: PaymentDeclined; /** Order pending */ orderPending?: OrderPending; /** Order rejected */ orderRejected?: OrderRejected; /** * Receipt was added for associated payment * @internal */ receiptCreated?: ReceiptCreated; /** * Receipt sent to customer * @internal */ receiptSent?: ReceiptSent; } /** Order placed */ interface OrderPlaced { } /** Order marked as paid, either by the store owner (for offline orders), or when an online transaction was confirmed */ interface OrderPaid { } /** Order shipping status set as fulfilled */ interface OrderFulfilled { } /** Order shipping status set as not fulfilled */ interface OrderNotFulfilled { } /** Order canceled */ interface OrderCanceled { } /** A download link was sent (relevant for orders with digital line items) */ interface DownloadLinkSent { } /** Shipping tracking number was set */ interface TrackingNumberAdded { } /** Shipping tracking number was edited */ interface TrackingNumberEdited { } /** Shipping tracking link was set */ interface TrackingLinkAdded { } /** An email confirmation of order shipment was sent */ interface ShippingConfirmationEmailSent { } /** Invoice was set in the order */ interface InvoiceAdded { } /** Invoice sent to customer via email */ interface InvoiceSent { } /** Email was sent to fulfiller */ interface FulfillerEmailSent { } /** Shipping address was updated */ interface ShippingAddressEdited { } /** Order email was updated */ interface EmailEdited { } /** An email notification for pickup was sent */ interface PickupReadyEmailSent { } /** Order marked as partially paid when an online transaction was confirmed with partial minimal required amount of total sum */ interface OrderPartiallyPaid { } /** Order reject */ interface OrderPending { } /** Order reject */ interface OrderRejected { } interface AddInternalActivityResponse { /** Updated order. */ order?: Order; /** * ID of the added internal activity. * Use this ID to either [update](https://bo.wix.com/wix-docs/rest/ecommerce/orders/update-activity) or [delete](https://bo.wix.com/wix-docs/rest/ecommerce/orders/delete-activity) the activity. */ activityId?: string; } interface AddActivityRequest { /** Order ID. */ _id: string; /** Activity info. */ activity: PublicActivity; } interface PublicActivity extends PublicActivityContentOneOf { /** Custom activity details. */ customActivity?: CustomActivity; /** Merchant commment. */ merchantComment?: MerchantComment; } /** @oneof */ interface PublicActivityContentOneOf { /** Custom activity details. */ customActivity?: CustomActivity; /** Merchant commment. */ merchantComment?: MerchantComment; } interface AddActivityResponse { /** Updated order. */ order?: Order; /** * ID of the added activity. * Use this ID to either [update](https://bo.wix.com/wix-docs/rest/ecommerce/orders/update-activity) or [delete](https://bo.wix.com/wix-docs/rest/ecommerce/orders/delete-activity) the activity. */ activityId?: string; } interface AddActivitiesRequest { /** Order ID. */ orderId?: string; /** Activities to add. */ activities?: PublicActivity[]; } interface AddActivitiesResponse { /** Updated order. */ order?: Order; /** * IDs of the added activities. * Use this IDs to either [update](https://bo.wix.com/wix-docs/rest/ecommerce/orders/update-activities) or [delete](https://bo.wix.com/wix-docs/rest/ecommerce/orders/delete-activities) the activities. */ activityIds?: string[]; } interface UpdateActivityRequest { /** Order ID. */ _id: string; /** ID of the activity to update. */ activityId: string; /** Activity info. */ activity: PublicActivity; } interface UpdateActivityResponse { /** Updated order. */ order?: Order; } interface DeleteActivityRequest { /** Order ID. */ _id: string; /** ID of the activity to delete. */ activityId: string; } interface DeleteActivityResponse { /** Updated order. */ order?: Order; } interface UpdateLineItemsDescriptionLinesRequest { /** Order ID. */ _id?: string; /** Line items. */ lineItems?: LineItemUpdate[]; } interface LineItemUpdate { /** Line item ID. */ lineItemId?: string; /** * Description lines' info. * If description line already exists for this name, it will be replaced. */ descriptionLines?: DescriptionLine[]; } interface UpdateLineItemsDescriptionLinesResponse { /** Updated order. */ order?: Order; } interface MarkOrderAsSeenByHumanRequest { /** Order ID. */ _id?: string; } interface MarkOrderAsSeenByHumanResponse { /** Updated order. */ order?: Order; } interface CancelOrderRequest { /** Order ID. */ _id: string; /** Whether to send an order canceled email to the buyer. */ sendOrderCanceledEmail?: boolean; /** Custom note to be added to the email (optional). */ customMessage?: string | null; /** Whether to restock all items in the order. This will only apply to products in the Wix Stores inventory. */ restockAllItems?: boolean; } interface CancelOrderResponse { /** Canceled order. */ order?: Order; } interface OrderCanceledEventOrderCanceled { /** The order that was cancelled */ order?: Order; /** Should restock all items on that order */ restockAllItems?: boolean; /** Should send a confirmation mail to the customer */ sendOrderCanceledEmail?: boolean; /** Personal note added to the email */ customMessage?: string | null; } interface UpdateOrderStatusRequest { /** Order ID. */ orderId: string; /** New order status. */ status: OrderStatus; } interface UpdateOrderStatusResponse { /** Updated order. */ order?: Order; } interface MarkAsFulfilledRequest { /** Order ID. */ _id?: string; } interface MarkAsFulfilledResponse { /** Updated order. */ order?: Order; } /** Triggered when the fulfillment status of an order is updated */ interface FulfillmentStatusUpdated { /** The order that was updated */ order?: Order; /** The previous status (before the update) */ previousFulfillmentStatus?: FulfillmentStatus; /** the new status (after the update) */ newFulfillmentStatus?: FulfillmentStatus; /** the action that caused this update */ action?: string; } interface BulkMarkAsFulfilledRequest { /** IDs of orders to be marked as fulfilled. */ ids?: string[]; /** Whether to return the full updated order entities in the response. */ returnFullEntity?: boolean; } interface BulkMarkAsFulfilledResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkMarkAsFulfilledByFilterRequest { /** Filter object. Learn more about supported filters [here](https://bo.wix.com/wix-docs/rest/ecommerce/orders/filter-and-sort). */ filter?: Record | null; } interface BulkMarkAsFulfilledByFilterResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface MarkAsUnfulfilledRequest { /** Order ID. */ _id?: string; } interface MarkAsUnfulfilledResponse { /** Updated order. */ order?: Order; } interface BulkMarkAsUnfulfilledRequest { /** IDs of orders to be marked as not fulfilled. */ ids?: string[]; /** Whether to return the full updated order entities in the response. */ returnFullEntity?: boolean; } interface BulkMarkAsUnfulfilledResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkMarkAsUnfulfilledByFilterRequest { /** Filter object. Learn more about supported filters [here](https://bo.wix.com/wix-docs/rest/ecommerce/orders/filter-and-sort). */ filter?: Record | null; } interface BulkMarkAsUnfulfilledByFilterResponse { /** Items updated by bulk action. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkSetBusinessLocationRequest { /** IDs of orders to update location for. */ orderIds?: string[]; /** Business location. */ businessLocation?: Location; } interface BulkSetBusinessLocationResponse { /** Bulk action results. */ results?: BulkSetBusinessLocationResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface BulkSetBusinessLocationResult { itemMetadata?: ItemMetadata; } interface V1MarkOrderAsPaidRequest { /** Order ID. */ _id?: string; } interface V1MarkOrderAsPaidResponse { /** Updated order. */ order?: Order; } interface V1BulkMarkOrdersAsPaidRequest { /** IDs of orders to mark as paid. */ ids?: string[]; } interface V1BulkMarkOrdersAsPaidResponse { /** * Items updated by the bulk action. * The Order entity within the results optimistically changes its payment status to paid, however this process is async. */ results?: BulkOrderResult[]; /** Bulk action metadata. */ bulkActionMetadata?: BulkActionMetadata; } interface V1CreatePaymentGatewayOrderRequest { /** eCom Order ID */ ecomOrderId?: string; } interface V1CreatePaymentGatewayOrderResponse { /** ID of the order created in the payment gateway */ paymentGatewayOrderId?: string; } interface GetShipmentsRequest { _id?: string; } interface GetShipmentsResponse { shipmentIds?: string[]; } interface AggregateOrdersRequest { /** Filter applied to original data */ filter?: Record | null; /** This is an object defining aggregation itself */ aggregation: Record | null; /** * Optional custom separator string that can be used to override default separator value '|' * for hierarchical responses of multifaceted aggregation requests like: * '{"aggregation": {"example_request_key": {"$count" : ["deliveryMethod", "shippingRegion"]}}}' * with example response for default '|' separator like: * '{"aggregates" :{"example_request_key": {"(Mail|Region 1)": 5, "(Pickup|Region 2)": 10}}}' */ hierarchySeparatorOverride?: string | null; } interface AggregateOrdersResponse { aggregates?: Record | null; } interface DecrementItemsQuantityRequest { /** Order ID */ _id?: string; /** Which items to decrement, and how much to decrement from each one */ decrementData?: DecrementData[]; } interface DecrementData { /** ID of the line item being decremented. */ lineItemId?: string; /** Line item quantity being decremented. */ decrementBy?: number; /** Whether to restock the line item (triggers inventory update). */ restock?: boolean; } interface DecrementItemsQuantityResponse { /** Updated order data */ order?: Order; } interface BulkUpdateOrderTagsRequest { /** IDs of orders to update tags for. */ orderIds: string[]; /** Tags to be added to orders */ assignTags?: Tags; /** Tags to be removed from orders */ unassignTags?: Tags; } interface BulkUpdateOrderTagsResponse { results?: BulkUpdateOrderTagsResult[]; bulkActionMetadata?: BulkActionMetadata; } interface BulkUpdateOrderTagsResult { itemMetadata?: ItemMetadata; } interface Task { key?: TaskKey; executeAt?: Date | null; payload?: string | null; } interface TaskKey { appId?: string; instanceId?: string; subjectId?: string | null; } interface TaskAction extends TaskActionActionOneOf { complete?: Complete; cancel?: Cancel; reschedule?: Reschedule; } /** @oneof */ interface TaskActionActionOneOf { complete?: Complete; cancel?: Cancel; reschedule?: Reschedule; } interface Complete { } interface Cancel { } interface Reschedule { executeAt?: Date | null; payload?: string | null; } interface InvoiceSentEvent { _id?: IdAndVersion; /** @readonly */ data?: InvoiceFields; /** @readonly */ status?: InvoiceStatus; } interface IdAndVersion { _id?: string | null; version?: number | null; } interface InvoiceFields { /** The invoice number allocated the invoice by the server. The number is limited to at most 11 digits. */ number?: string | null; /** The invoice 3-letter currency code in [ISO-4217 alphabetic](https://www.iso.org/iso-4217-currency-codes.html) format. */ currencyCode?: string | null; /** The invoice customer. The customer must be a contact of the site, with an email. */ customer?: Customer; /** * Invoice dates: issue date and due date are mandatory and provided when the invoice is created. * Last seen date is the optional date when the invoice was last seen be UoU. */ dates?: InvoiceDates; /** * Line items containing the details of the products or services relevant to the invoice, with their name, prices, * and quantity. There must be at least one line item on the invoice. */ lineItems?: LineItems; /** * Locale of the invoice, containing the language. * This field is not mandatory but is used for display purposes, to determine the appearance of numbers and dates * on the invoice. */ locale?: Locale; /** * The totals on the invoice. * The totals.subtotal, totals.total and totals.taxed_amount are calculated by the server based on the line items. * Alternatively, these fields can be provided in the invoice creation request, in this case, these values are fixed. * The totals contain fees and a discount, that apply to the invoice. */ totals?: TotalPrice; /** An optional discount on the invoice. */ discount?: Discount; /** The taxes of the invoice. */ taxes?: CalculatedTaxes; /** The payments on the invoice. The invoice has status paid if its payments cover the invoice total. */ payments?: Payments; /** Invoice metadata */ metaData?: MetaData; /** * Not used * @deprecated */ creationAdditional_BIInformation?: string | null; /** * The balance and amount paid on the invoice. * This read-only field is calculated based on the invoice totals and payments. * @readonly */ dynamicTotals?: InvoiceDynamicPriceTotals; /** The invoice title */ title?: string | null; /** Invoice custom fields */ customFields?: CustomFieldValue[]; /** * Not used * @deprecated */ designTemplateId?: string | null; /** * Not used * @deprecated */ createOrder?: boolean | null; /** The optional deposit of the invoice */ deposit?: Deposit; /** Associated checkout for this invoice */ ecomCheckoutId?: string | null; } interface Customer { contactId?: string | null; name?: string | null; email?: Email; address?: QuotesAddress; phone?: Phone; company?: Company; firstName?: string | null; lastName?: string | null; billingAddress?: CommonAddress; shippingAddress?: CommonAddress; } interface Email { address?: string; } interface QuotesAddress { street?: string | null; city?: string | null; zip?: string | null; state?: string | null; country?: string | null; /** @readonly */ description?: AddressDescription; } interface AddressDescription { content?: string; placement?: Placement; } declare enum Placement { Unknown = "Unknown", Replace = "Replace", Before = "Before", After = "After" } interface Phone { number?: string; } interface Company { name?: string; _id?: string | null; } /** Physical address */ interface CommonAddress extends CommonAddressStreetOneOf { /** Street name and number. */ streetAddress?: StreetAddress; /** Main address line, usually street and number as free text. */ addressLine1?: string | null; /** Country code. */ country?: string | null; /** Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. e.g. NY */ subdivision?: string | null; /** City name. */ city?: string | null; /** Zip/postal code. */ postalCode?: string | null; /** Free text providing more detailed address info. Usually contains Apt, Suite, and Floor. */ addressLine2?: string | null; } /** @oneof */ interface CommonAddressStreetOneOf { /** Street name and number. */ streetAddress?: StreetAddress; /** Main address line, usually street and number as free text. */ addressLine?: string | null; } interface Subdivision { /** Short subdivision code. */ code?: string; /** Subdivision full name. */ name?: string; } declare enum SubdivisionType { UNKNOWN_SUBDIVISION_TYPE = "UNKNOWN_SUBDIVISION_TYPE", /** State */ ADMINISTRATIVE_AREA_LEVEL_1 = "ADMINISTRATIVE_AREA_LEVEL_1", /** County */ ADMINISTRATIVE_AREA_LEVEL_2 = "ADMINISTRATIVE_AREA_LEVEL_2", /** City/town */ ADMINISTRATIVE_AREA_LEVEL_3 = "ADMINISTRATIVE_AREA_LEVEL_3", /** Neighborhood/quarter */ ADMINISTRATIVE_AREA_LEVEL_4 = "ADMINISTRATIVE_AREA_LEVEL_4", /** Street/block */ ADMINISTRATIVE_AREA_LEVEL_5 = "ADMINISTRATIVE_AREA_LEVEL_5", /** ADMINISTRATIVE_AREA_LEVEL_0. Indicates the national political entity, and is typically the highest order type returned by the Geocoder. */ COUNTRY = "COUNTRY" } /** Subdivision Concordance values */ interface StandardDetails { /** subdivision iso-3166-2 code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). e.g. US-NY, GB-SCT, NO-30 */ iso31662?: string | null; } interface InvoiceDates { /** use UTC midnight date to set the issue date according to the site time zone */ issueDate?: Date | null; /** use UTC midnight date to set the due date according to the site time zone */ dueDate?: Date | null; /** Valid time zones */ timeZoneCode?: string | null; /** * ignored in request use in response to get the site time zone * @readonly */ lastSeenDate?: Date | null; } interface LineItems { lineItems?: LineItem[]; } interface LineItem { _id?: string; name?: string; description?: string | null; price?: BigDecimalWrapper; taxedTotal?: BigDecimalWrapper; quantity?: BigDecimalWrapper; taxes?: LineItemTax[]; /** The source of the line item */ source?: Source; /** The line-item level metadata. */ metadata?: LineItemMetaData; } interface BigDecimalWrapper { serializedValue?: number; } interface LineItemTax { name?: string; rate?: BigDecimalWrapper; code?: string | null; } interface Source { /** * Source app or service ID. * @readonly */ sourceId?: string; /** * App or service type. * @readonly */ sourceType?: SourceType; } declare enum SourceType { UNKNOWN_SOURCE_TYPE = "UNKNOWN_SOURCE_TYPE", WIX_APP = "WIX_APP", EXTERNAL = "EXTERNAL", ADMIN = "ADMIN", OTHER = "OTHER" } interface LineItemMetaData { metadata?: Record; } interface Locale { /** ISO 639 alpha-2 or alpha-3 language code, or a language subtag */ language?: string; /** An ISO 3166 alpha-2 country code or a UN M.49 numeric-3 area code. */ country?: string | null; invariant?: string | null; } interface TotalPrice { /** the subtotal of the line items without the tax reduction */ subtotal?: BigDecimalWrapper; /** the total price taking into account the itemized fees and the taxes */ total?: BigDecimalWrapper; fees?: ItemizedFee[]; discountAmount?: BigDecimalWrapper; taxedAmount?: BigDecimalWrapper; } interface ItemizedFee { name?: string; price?: BigDecimalWrapper; } interface Discount extends DiscountOneDiscountTypeOneOf { /** Discount as percentage value. */ percentage?: BigDecimalWrapper; } /** @oneof */ interface DiscountOneDiscountTypeOneOf { /** Discount as percentage value. */ percentage?: BigDecimalWrapper; } interface CalculatedTaxes { /** consider calculated or not - cannot enforce set */ taxes?: CalculatedTax[]; } interface CalculatedTax { name?: string; rate?: BigDecimalWrapper; /** the costs on which the taxes are applied */ taxable?: BigDecimalWrapper; /** the taxes as a result of the */ taxed?: BigDecimalWrapper; code?: string | null; } interface Payments { payments?: InvoicesPayment[]; } interface InvoicesPayment { /** document */ _id?: string; type?: string; amount?: BigDecimalWrapper; date?: Date | null; /** * The orderId of the order in cashier associated with the payment. * This field is populated for external payments that are charged by invoices via AddPayment endpoint. */ orderId?: string | null; /** * The transactionId corresponding to the orderId of the payment which are returned by cashier. * This field is populated for external payments that are charged by invoices via AddPayment endpoint as well. */ transactionId?: string | null; } interface MetaData { notes?: string | null; legalTerms?: string | null; sourceUrl?: string | null; sourceProperties?: Record; source?: string | null; sourceRefId?: string | null; /** Optional indicator whether to allow editing of the invoice by other applications other than the source. Default is true. */ allowEditByOthers?: boolean | null; } interface InvoiceDynamicPriceTotals { paidAmount?: BigDecimalWrapper; balance?: BigDecimalWrapper; } /** * A custom field value is used to add additional data to a financial document or to a financial document template. * The custom field value may be based on a custom field definition. */ interface CustomFieldValue { /** * The unique id of the custom field value * @readonly */ _id?: string | null; /** The display name of the custom field value */ displayName?: string; /** The optional namespace of the custom field value. This field may be used to indicate intended usage or source. */ namespace?: string | null; /** The group of the custom field indicates its intended placement in the financial document */ group?: CustomFieldGroup; /** The value of the custom field */ value?: Value; /** The optional key of the custom field definition on which the custom field value is based */ originCustomFieldKey?: string | null; } declare enum CustomFieldGroup { UNKNOWN_CUSTOM_FIELD_GROUP = "UNKNOWN_CUSTOM_FIELD_GROUP", BUSINESS_DETAILS = "BUSINESS_DETAILS", CUSTOMER_DETAILS = "CUSTOMER_DETAILS", DOCUMENT = "DOCUMENT", FOOTER = "FOOTER", OTHER = "OTHER" } interface Value { value?: string; valueType?: ValueType; } declare enum ValueType { UNKNOWN_VALUE_TYPE = "UNKNOWN_VALUE_TYPE", STRING = "STRING", DATE = "DATE", BOOLEAN = "BOOLEAN", NUMBER = "NUMBER" } interface Deposit { /** The flat amount of the deposit. The flat amount of the deposit must be less than the invoice total. */ flatAmount?: string; /** * The read-only percentage value of the deposit. * It is computed according to the flat_amount and the invoice total and is rounded to 2 digits precision. * @readonly */ percentage?: string; /** The type of the deposit. The default is FLAT. */ type?: DepositType; } declare enum DepositType { UNKNOWN = "UNKNOWN", FLAT = "FLAT", PERCENTAGE = "PERCENTAGE" } /** * InvoiceStatus allowed transitions based on current status: * Draft -> Deleted, Paid, Partially Paid, Sent * Sent -> Draft, Deleted, Void, Paid, Partially Paid, Processing, (Overdue) * Processing -> PartiallyPaid, Paid, Sent * Paid -> Void * PartiallyPaid -> Void, (PartialAndOverdue) * Void -> Deleted * Deleted */ declare enum InvoiceStatus { Draft = "Draft", Sent = "Sent", Processing = "Processing", Paid = "Paid", Overdue = "Overdue", Void = "Void", Deleted = "Deleted", PartiallyPaid = "PartiallyPaid", PartialAndOverdue = "PartialAndOverdue" } interface TriggerSideEffectsFromLegacyData { storeId?: string; orderId?: string; ordersExperiments?: OrdersExperiments; } interface PreparePaymentCollectionResponseNonNullableFields { paymentGatewayOrderId: string; } interface PriceNonNullableFields { amount: string; formattedAmount: string; } interface GetPaymentCollectabilityStatusResponseNonNullableFields { status: PaymentCollectabilityStatus; amount?: PriceNonNullableFields; /** @internal */ authorizationSupported: boolean; } interface ProductNameNonNullableFields { original: string; } interface CatalogReferenceNonNullableFields { catalogItemId: string; appId: string; } interface PlainTextValueNonNullableFields { original: string; } interface ColorNonNullableFields { original: string; } interface DescriptionLineNameNonNullableFields { original: string; } interface DescriptionLineNonNullableFields { plainText?: PlainTextValueNonNullableFields; colorInfo?: ColorNonNullableFields; plainTextValue?: PlainTextValueNonNullableFields; color: string; name?: DescriptionLineNameNonNullableFields; lineType: DescriptionLineType; } interface PhysicalPropertiesNonNullableFields { shippable: boolean; } interface ItemTypeNonNullableFields { preset: ItemTypeItemType; custom: string; } interface ItemTaxFullDetailsNonNullableFields { taxableAmount?: PriceNonNullableFields; taxRate: string; totalTax?: PriceNonNullableFields; } interface LineItemTaxBreakdownNonNullableFields { taxAmount?: PriceNonNullableFields; jurisdictionType: JurisdictionType; nonTaxableAmount?: PriceNonNullableFields; taxableAmount?: PriceNonNullableFields; } interface LineItemTaxInfoNonNullableFields { taxAmount?: PriceNonNullableFields; taxableAmount?: PriceNonNullableFields; taxIncludedInPrice: boolean; taxBreakdown: LineItemTaxBreakdownNonNullableFields[]; } interface DigitalFileNonNullableFields { fileId: string; } interface FreeTrialPeriodNonNullableFields { frequency: SubscriptionFrequency; interval: number; } interface SubscriptionSettingsNonNullableFields { frequency: SubscriptionFrequency; autoRenewal: boolean; /** @internal */ enableCustomerCancellation: boolean; /** @internal */ freeTrialPeriod?: FreeTrialPeriodNonNullableFields; } interface SubscriptionInfoNonNullableFields { cycleNumber: number; subscriptionOptionTitle: string; subscriptionSettings?: SubscriptionSettingsNonNullableFields; } interface PriceDescriptionNonNullableFields { original: string; } interface LocationAndQuantityNonNullableFields { _id: string; quantity: number; } interface TaxableAddressNonNullableFields { addressType: TaxableAddressType; } interface OrderLineItemNonNullableFields { _id: string; productName?: ProductNameNonNullableFields; catalogReference?: CatalogReferenceNonNullableFields; quantity: number; totalDiscount?: PriceNonNullableFields; descriptionLines: DescriptionLineNonNullableFields[]; image: string; physicalProperties?: PhysicalPropertiesNonNullableFields; itemType?: ItemTypeNonNullableFields; price?: PriceNonNullableFields; priceBeforeDiscounts?: PriceNonNullableFields; totalPriceBeforeTax?: PriceNonNullableFields; totalPriceAfterTax?: PriceNonNullableFields; paymentOption: PaymentOptionType; taxDetails?: ItemTaxFullDetailsNonNullableFields; taxInfo?: LineItemTaxInfoNonNullableFields; digitalFile?: DigitalFileNonNullableFields; subscriptionInfo?: SubscriptionInfoNonNullableFields; priceDescription?: PriceDescriptionNonNullableFields; depositAmount?: PriceNonNullableFields; /** @internal */ locations: LocationAndQuantityNonNullableFields[]; lineItemPrice?: PriceNonNullableFields; /** @internal */ taxableAddress?: TaxableAddressNonNullableFields; /** @internal */ priceUndetermined: boolean; /** @internal */ fixedQuantity: boolean; } interface BuyerInfoNonNullableFields { visitorId: string; memberId: string; } interface PriceSummaryNonNullableFields { subtotal?: PriceNonNullableFields; shipping?: PriceNonNullableFields; tax?: PriceNonNullableFields; discount?: PriceNonNullableFields; totalPrice?: PriceNonNullableFields; total?: PriceNonNullableFields; totalWithGiftCard?: PriceNonNullableFields; totalWithoutGiftCard?: PriceNonNullableFields; totalAdditionalFees?: PriceNonNullableFields; } interface StreetAddressNonNullableFields { number: string; name: string; apt: string; } interface AddressNonNullableFields { streetAddress?: StreetAddressNonNullableFields; } interface VatIdNonNullableFields { _id: string; type: VatType; } interface FullAddressContactDetailsNonNullableFields { vatId?: VatIdNonNullableFields; } interface AddressWithContactNonNullableFields { address?: AddressNonNullableFields; contactDetails?: FullAddressContactDetailsNonNullableFields; } interface PickupAddressNonNullableFields { streetAddress?: StreetAddressNonNullableFields; } interface PickupDetailsNonNullableFields { address?: PickupAddressNonNullableFields; pickupMethod: PickupMethod; } interface DeliveryLogisticsNonNullableFields { shippingDestination?: AddressWithContactNonNullableFields; pickupDetails?: PickupDetailsNonNullableFields; } interface ShippingPriceNonNullableFields { price?: PriceNonNullableFields; totalPriceBeforeTax?: PriceNonNullableFields; totalPriceAfterTax?: PriceNonNullableFields; taxDetails?: ItemTaxFullDetailsNonNullableFields; discount?: PriceNonNullableFields; } interface V1ShippingInformationNonNullableFields { title: string; logistics?: DeliveryLogisticsNonNullableFields; cost?: ShippingPriceNonNullableFields; } interface TaxSummaryNonNullableFields { totalTax?: PriceNonNullableFields; } interface OrderTaxBreakdownNonNullableFields { taxName: string; taxType: string; jurisdiction: string; jurisdictionType: JurisdictionType; rate: string; aggregatedTaxAmount?: PriceNonNullableFields; aggregatedTaxableAmount?: PriceNonNullableFields; } interface OrderTaxInfoNonNullableFields { totalTax?: PriceNonNullableFields; taxBreakdown: OrderTaxBreakdownNonNullableFields[]; } interface CouponNonNullableFields { _id: string; code: string; name: string; amount?: PriceNonNullableFields; } interface MerchantDiscountNonNullableFields { discountReason: DiscountReason; amount?: PriceNonNullableFields; } interface DiscountRuleNameNonNullableFields { original: string; } interface DiscountRuleNonNullableFields { _id: string; name?: DiscountRuleNameNonNullableFields; amount?: PriceNonNullableFields; } interface LineItemDiscountNonNullableFields { _id: string; totalDiscount?: PriceNonNullableFields; } interface AppliedDiscountNonNullableFields { coupon?: CouponNonNullableFields; merchantDiscount?: MerchantDiscountNonNullableFields; discountRule?: DiscountRuleNonNullableFields; discountType: DiscountType; lineItemIds: string[]; /** @internal */ lineItemDiscounts: LineItemDiscountNonNullableFields[]; } interface CustomActivityNonNullableFields { appId: string; type: string; } interface MerchantCommentNonNullableFields { message: string; } interface OrderRefundedNonNullableFields { manual: boolean; amount?: PriceNonNullableFields; reason: string; } interface OrderCreatedFromExchangeNonNullableFields { originalOrderId: string; } interface LineItemExchangeDataNonNullableFields { lineItemId: string; quantity: number; } interface NewExchangeOrderCreatedNonNullableFields { exchangeOrderId: string; lineItems: LineItemExchangeDataNonNullableFields[]; } interface LineItemQuantityChangeNonNullableFields { originalQuantity: number; newQuantity: number; diff: number; deltaType: LineItemQuantityChangeType; } interface LineItemPriceChangeNonNullableFields { originalPrice?: PriceNonNullableFields; newPrice?: PriceNonNullableFields; } interface LineItemChangesNonNullableFields { _id: string; name?: ProductNameNonNullableFields; quantity?: LineItemQuantityChangeNonNullableFields; price?: LineItemPriceChangeNonNullableFields; } interface ManagedLineItemNonNullableFields { _id: string; name?: ProductNameNonNullableFields; quantity: number; } interface TranslatedValueNonNullableFields { original: string; } interface LineItemAmountNonNullableFields { _id: string; name?: ProductNameNonNullableFields; amount?: PriceNonNullableFields; } interface ManagedDiscountNonNullableFields { _id: string; name?: TranslatedValueNonNullableFields; affectedLineItems: LineItemAmountNonNullableFields[]; totalAmount?: PriceNonNullableFields; } interface ManagedAdditionalFeeNonNullableFields { _id: string; name?: TranslatedValueNonNullableFields; affectedLineItems: LineItemAmountNonNullableFields[]; totalAmount?: PriceNonNullableFields; } interface TotalPriceChangeNonNullableFields { originalTotal?: PriceNonNullableFields; newTotal?: PriceNonNullableFields; } interface ShippingInformationNonNullableFields { total?: PriceNonNullableFields; shippingTitle: string; } interface ShippingInformationChangeNonNullableFields { originalShippingInfo?: ShippingInformationNonNullableFields; newShippingInfo?: ShippingInformationNonNullableFields; } interface OrderChangeNonNullableFields { lineItemChanged?: LineItemChangesNonNullableFields; lineItemAdded?: ManagedLineItemNonNullableFields; lineItemRemoved?: ManagedLineItemNonNullableFields; discountAdded?: ManagedDiscountNonNullableFields; discountRemoved?: ManagedDiscountNonNullableFields; additionalFeeAdded?: ManagedAdditionalFeeNonNullableFields; additionalFeeRemoved?: ManagedAdditionalFeeNonNullableFields; totalPriceChanged?: TotalPriceChangeNonNullableFields; shippingInformationChanged?: ShippingInformationChangeNonNullableFields; } interface DraftOrderChangesAppliedNonNullableFields { draftOrderId: string; changes: OrderChangeNonNullableFields[]; } interface SavedPaymentMethodNonNullableFields { name: string; } interface AuthorizedPaymentCreatedNonNullableFields { paymentId: string; amount?: PriceNonNullableFields; } interface AuthorizedPaymentCapturedNonNullableFields { paymentId: string; amount?: PriceNonNullableFields; } interface AuthorizedPaymentVoidedNonNullableFields { paymentId: string; amount?: PriceNonNullableFields; } interface RegularPaymentRefundNonNullableFields { amount?: PriceNonNullableFields; } interface GiftCardPaymentRefundNonNullableFields { amount?: PriceNonNullableFields; } interface RefundedPaymentNonNullableFields { regular?: RegularPaymentRefundNonNullableFields; giftCard?: GiftCardPaymentRefundNonNullableFields; paymentId: string; externalRefund: boolean; } interface RefundInitiatedNonNullableFields { refundId: string; amount?: PriceNonNullableFields; payments: RefundedPaymentNonNullableFields[]; } interface PaymentRefundedNonNullableFields { refundId: string; payment?: RefundedPaymentNonNullableFields; } interface PaymentRefundFailedNonNullableFields { refundId: string; payment?: RefundedPaymentNonNullableFields; } interface RefundedAsStoreCreditNonNullableFields { amount?: PriceNonNullableFields; } interface RegularPaymentNonNullableFields { amount?: PriceNonNullableFields; } interface PaymentPendingNonNullableFields { regular?: RegularPaymentNonNullableFields; paymentId: string; } interface PaymentCanceledNonNullableFields { regular?: RegularPaymentNonNullableFields; paymentId: string; } interface PaymentDeclinedNonNullableFields { regular?: RegularPaymentNonNullableFields; paymentId: string; } interface WixReceiptNonNullableFields { receiptId: string; } interface ReceiptCreatedNonNullableFields { wixReceipt?: WixReceiptNonNullableFields; paymentId: string; } interface ReceiptSentNonNullableFields { wixReceipt?: WixReceiptNonNullableFields; paymentId: string; } interface ActivityNonNullableFields { customActivity?: CustomActivityNonNullableFields; merchantComment?: MerchantCommentNonNullableFields; orderRefunded?: OrderRefundedNonNullableFields; orderCreatedFromExchange?: OrderCreatedFromExchangeNonNullableFields; newExchangeOrderCreated?: NewExchangeOrderCreatedNonNullableFields; /** @internal */ draftOrderChangesApplied?: DraftOrderChangesAppliedNonNullableFields; /** @internal */ savedPaymentMethod?: SavedPaymentMethodNonNullableFields; /** @internal */ authorizedPaymentCreated?: AuthorizedPaymentCreatedNonNullableFields; /** @internal */ authorizedPaymentCaptured?: AuthorizedPaymentCapturedNonNullableFields; /** @internal */ authorizedPaymentVoided?: AuthorizedPaymentVoidedNonNullableFields; /** @internal */ refundInitiated?: RefundInitiatedNonNullableFields; /** @internal */ paymentRefunded?: PaymentRefundedNonNullableFields; /** @internal */ paymentRefundFailed?: PaymentRefundFailedNonNullableFields; /** @internal */ refundedAsStoreCredit?: RefundedAsStoreCreditNonNullableFields; /** @internal */ paymentPending?: PaymentPendingNonNullableFields; /** @internal */ paymentCanceled?: PaymentCanceledNonNullableFields; /** @internal */ paymentDeclined?: PaymentDeclinedNonNullableFields; /** @internal */ receiptCreated?: ReceiptCreatedNonNullableFields; /** @internal */ receiptSent?: ReceiptSentNonNullableFields; type: ActivityType; } interface CreatedByNonNullableFields { userId: string; memberId: string; visitorId: string; appId: string; } interface ChannelInfoNonNullableFields { type: ChannelType; } interface CustomFieldNonNullableFields { title: string; } interface BalanceNonNullableFields { amount: string; formattedAmount: string; } interface BalanceSummaryNonNullableFields { balance?: BalanceNonNullableFields; paid?: PriceNonNullableFields; refunded?: PriceNonNullableFields; authorized?: PriceNonNullableFields; /** @internal */ pendingRefund?: PriceNonNullableFields; pending?: PriceNonNullableFields; } interface AdditionalFeeNonNullableFields { name: string; price?: PriceNonNullableFields; taxDetails?: ItemTaxFullDetailsNonNullableFields; priceBeforeTax?: PriceNonNullableFields; priceAfterTax?: PriceNonNullableFields; _id: string; lineItemIds: string[]; } interface TagListNonNullableFields { tagIds: string[]; } interface TagsNonNullableFields { privateTags?: TagListNonNullableFields; tags?: TagListNonNullableFields; } interface LocationNonNullableFields { _id: string; name: string; } interface OrderNonNullableFields { number: string; lineItems: OrderLineItemNonNullableFields[]; buyerInfo?: BuyerInfoNonNullableFields; paymentStatus: PaymentStatus; fulfillmentStatus: FulfillmentStatus; weightUnit: WeightUnit; taxIncludedInPrices: boolean; priceSummary?: PriceSummaryNonNullableFields; billingInfo?: AddressWithContactNonNullableFields; shippingInfo?: V1ShippingInformationNonNullableFields; status: OrderStatus; taxSummary?: TaxSummaryNonNullableFields; taxInfo?: OrderTaxInfoNonNullableFields; appliedDiscounts: AppliedDiscountNonNullableFields[]; activities: ActivityNonNullableFields[]; attributionSource: AttributionSource; createdBy?: CreatedByNonNullableFields; channelInfo?: ChannelInfoNonNullableFields; customFields: CustomFieldNonNullableFields[]; isInternalOrderCreate: boolean; payNow?: PriceSummaryNonNullableFields; balanceSummary?: BalanceSummaryNonNullableFields; additionalFees: AdditionalFeeNonNullableFields[]; recipientInfo?: AddressWithContactNonNullableFields; /** @internal */ tags?: TagsNonNullableFields; businessLocation?: LocationNonNullableFields; /** @internal */ payAfterFreeTrial?: PriceSummaryNonNullableFields; } interface MarkOrderAsPaidResponseNonNullableFields { order?: OrderNonNullableFields; } interface ApplicationErrorNonNullableFields { code: string; description: string; } interface ItemMetadataNonNullableFields { originalIndex: number; success: boolean; error?: ApplicationErrorNonNullableFields; } interface BulkOrderResultNonNullableFields { itemMetadata?: ItemMetadataNonNullableFields; item?: OrderNonNullableFields; } interface BulkActionMetadataNonNullableFields { totalSuccesses: number; totalFailures: number; undetailedFailures: number; } interface BulkMarkOrdersAsPaidResponseNonNullableFields { results: BulkOrderResultNonNullableFields[]; bulkActionMetadata?: BulkActionMetadataNonNullableFields; } interface RefundabilityNonNullableFields { nonRefundableReason: NonRefundableReason; manuallyRefundableReason: ManuallyRefundableReason; paymentId: string; refundabilityStatus: RefundableStatus; } interface GetRefundabilityStatusResponseNonNullableFields { refundabilities: RefundabilityNonNullableFields[]; refundablePerItem: boolean; } interface CreatePaymentGatewayOrderResponseNonNullableFields { paymentGatewayOrderId: string; } interface AuthorizationActionFailureDetailsNonNullableFields { failureCode: string; } interface AuthorizationCaptureNonNullableFields { status: AuthorizationCaptureStatus; amount?: PriceNonNullableFields; failureDetails?: AuthorizationActionFailureDetailsNonNullableFields; } interface AuthorizationVoidNonNullableFields { status: AuthorizationVoidStatus; failureDetails?: AuthorizationActionFailureDetailsNonNullableFields; reason: Reason; } interface V1ScheduledActionNonNullableFields { actionType: ActionType; } interface AuthorizationDetailsNonNullableFields { delayedCapture: boolean; captures: AuthorizationCaptureNonNullableFields[]; void?: AuthorizationVoidNonNullableFields; scheduledAction?: V1ScheduledActionNonNullableFields; } interface RegularPaymentDetailsNonNullableFields { offlinePayment: boolean; status: TransactionStatus; savedPaymentMethod: boolean; authorizationDetails?: AuthorizationDetailsNonNullableFields; } interface GiftCardPaymentDetailsNonNullableFields { giftCardPaymentId: string; giftCardId: string; appId: string; voided: boolean; } interface MembershipNameNonNullableFields { original: string; } interface MembershipPaymentDetailsNonNullableFields { membershipId: string; lineItemId: string; status: MembershipPaymentStatus; name?: MembershipNameNonNullableFields; voided: boolean; providerAppId: string; } interface WixReceiptInfoNonNullableFields { receiptId: string; } interface PaymentNonNullableFields { regularPaymentDetails?: RegularPaymentDetailsNonNullableFields; giftcardPaymentDetails?: GiftCardPaymentDetailsNonNullableFields; membershipPaymentDetails?: MembershipPaymentDetailsNonNullableFields; /** @internal */ wixReceipt?: WixReceiptInfoNonNullableFields; amount?: PriceNonNullableFields; refundDisabled: boolean; /** @internal */ supportReceiptGeneration: boolean; } interface RefundTransactionNonNullableFields { paymentId: string; amount?: PriceNonNullableFields; refundStatus: RefundStatus; externalRefund: boolean; } interface RefundItemNonNullableFields { lineItemId: string; quantity: number; } interface LineItemRefundNonNullableFields { /** @internal */ lineItemId: string; /** @internal */ quantity: number; } interface AdditionalFeeRefundNonNullableFields { /** @internal */ additionalFeeId: string; /** @internal */ amount?: PriceNonNullableFields; } interface ShippingRefundNonNullableFields { /** @internal */ amount?: PriceNonNullableFields; } interface RefundDetailsNonNullableFields { items: RefundItemNonNullableFields[]; shippingIncluded: boolean; /** @internal */ lineItems: LineItemRefundNonNullableFields[]; /** @internal */ additionalFees: AdditionalFeeRefundNonNullableFields[]; /** @internal */ shipping?: ShippingRefundNonNullableFields; } interface LineItemRefundSummaryNonNullableFields { lineItemId: string; totalRefundedAmount?: PriceNonNullableFields; } interface RefundItemsBreakdownNonNullableFields { lineItems: LineItemRefundSummaryNonNullableFields[]; } interface AggregatedRefundSummaryNonNullableFields { /** @internal */ requestedRefund?: PriceNonNullableFields; /** @internal */ pendingRefund?: PriceNonNullableFields; /** @internal */ refunded?: PriceNonNullableFields; /** @internal */ failedRefundAmount?: PriceNonNullableFields; /** @internal */ pending: boolean; breakdown?: RefundItemsBreakdownNonNullableFields; } interface RefundNonNullableFields { _id: string; transactions: RefundTransactionNonNullableFields[]; details?: RefundDetailsNonNullableFields; /** @internal */ summary?: AggregatedRefundSummaryNonNullableFields; } interface OrderTransactionsNonNullableFields { orderId: string; payments: PaymentNonNullableFields[]; refunds: RefundNonNullableFields[]; } interface TriggerRefundResponseNonNullableFields { orderTransactions?: OrderTransactionsNonNullableFields; failedPaymentIds: ItemMetadataNonNullableFields[]; } interface VoidAuthorizedPaymentsResponseNonNullableFields { orderTransactions?: OrderTransactionsNonNullableFields; } interface CaptureAuthorizedPaymentsResponseNonNullableFields { orderTransactions?: OrderTransactionsNonNullableFields; } interface GetOrderResponseNonNullableFields { order?: OrderNonNullableFields; } interface SearchOrdersResponseNonNullableFields { orders: OrderNonNullableFields[]; } interface CreateOrderResponseNonNullableFields { order?: OrderNonNullableFields; } interface UpdateOrderResponseNonNullableFields { order?: OrderNonNullableFields; } interface BulkUpdateOrdersResponseNonNullableFields { results: BulkOrderResultNonNullableFields[]; bulkActionMetadata?: BulkActionMetadataNonNullableFields; } interface CommitDeltasResponseNonNullableFields { order?: OrderNonNullableFields; } interface UpdateOrderLineItemResponseNonNullableFields { order?: OrderNonNullableFields; } interface AddActivityResponseNonNullableFields { order?: OrderNonNullableFields; activityId: string; } interface UpdateActivityResponseNonNullableFields { order?: OrderNonNullableFields; } interface DeleteActivityResponseNonNullableFields { order?: OrderNonNullableFields; } interface CancelOrderResponseNonNullableFields { order?: OrderNonNullableFields; } interface UpdateOrderStatusResponseNonNullableFields { order?: OrderNonNullableFields; } interface BulkUpdateOrderTagsResultNonNullableFields { itemMetadata?: ItemMetadataNonNullableFields; } interface BulkUpdateOrderTagsResponseNonNullableFields { results: BulkUpdateOrderTagsResultNonNullableFields[]; bulkActionMetadata?: BulkActionMetadataNonNullableFields; } interface BaseEventMetadata { /** App instance ID. */ instanceId?: string | null; /** Event type. */ eventType?: string; /** The identification type and identity data. */ identity?: IdentificationData; } interface EventMetadata extends BaseEventMetadata { /** * Unique event ID. * Allows clients to ignore duplicate webhooks. */ _id?: string; /** * Assumes actions are also always typed to an entity_type * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction */ entityFqdn?: string; /** * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug) * This is although the created/updated/deleted notion is duplication of the oneof types * Example: created/updated/deleted/started/completed/email_opened */ slug?: string; /** ID of the entity associated with the event. */ entityId?: string; /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */ eventTime?: Date | null; /** * Whether the event was triggered as a result of a privacy regulation application * (for example, GDPR). */ triggeredByAnonymizeRequest?: boolean | null; /** If present, indicates the action that triggered the event. */ originatedFrom?: string | null; /** * A sequence number defining the order of updates to the underlying entity. * For example, given that some entity was updated at 16:00 and than again at 16:01, * it is guaranteed that the sequence number of the second update is strictly higher than the first. * As the consumer, you can use this value to ensure that you handle messages in the correct order. * To do so, you will need to persist this number on your end, and compare the sequence number from the * message against the one you have stored. Given that the stored number is higher, you should ignore the message. */ entityEventSequence?: string | null; } interface OrderApprovedEnvelope { data: OrderApproved; metadata: EventMetadata; } interface OrderUpdatedEnvelope { entity: Order; metadata: EventMetadata; } interface OrderCanceledEnvelope { data: OrderCanceledEventOrderCanceled; metadata: EventMetadata; } interface OrderCreatedEnvelope { entity: Order; metadata: EventMetadata; } interface PreparePaymentCollectionOptions { /** * Optional parameter. When present, payment collection will be performed using given payment gateway order. * Existing payment gateway order will be updated with a new amount. * When parameter is absent, new payment gateway order will be created and used for payment collection. */ paymentGatewayOrderId?: string | null; /** * Whether to delay capture of the payment. * Default: false * @deprecated Whether to delay capture of the payment. * Default: false * @replacedBy delayed_capture_settings.scheduled_action * @targetRemovalDate 2024-09-30 */ delayedCapture?: boolean; /** Delayed capture payment settings */ delayedCaptureSettings?: DelayedCaptureSettings; } interface PaymentCollectionCreatePaymentGatewayOrderOptions { /** Information about the user who initiated the payment. */ chargedBy?: ChargedBy; } interface ChargeMembershipsOptions { /** List of items to be paid by memberships */ membershipCharges?: MembershipChargeItem[]; } interface TriggerRefundOptions { /** Business model of a refund */ details?: RefundDetails; /** Side effect details related to refund */ sideEffects?: RefundSideEffects; } interface SearchOrdersOptions { /** Search options. */ search?: CursorSearch; } interface CreateOrderOptions { /** Determine order lifecycle */ settings?: OrderCreationSettings; } interface UpdateOrder { /** * Order ID. * @readonly */ _id?: string | null; /** * Order number displayed in the site owner's dashboard (auto-generated). * @readonly */ number?: string; /** * Date and time the order was created. * @readonly */ _createdDate?: Date | null; /** * Date and time the order was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * @readonly */ _updatedDate?: Date | null; /** * Order line items. * @readonly */ lineItems?: OrderLineItem[]; /** Buyer information. */ buyerInfo?: BuyerInfo; /** Order payment status. */ paymentStatus?: PaymentStatus; /** * Order fulfillment status. * @readonly */ fulfillmentStatus?: FulfillmentStatus; /** * Language for communication with the buyer. Defaults to the site language. * For a site that supports multiple languages, this is the language the buyer selected. */ buyerLanguage?: string | null; /** Weight measurement unit - defaults to site's weight unit. */ weightUnit?: WeightUnit; /** Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. */ currency?: string | null; /** Whether tax is included in line item prices. */ taxIncludedInPrices?: boolean; /** * Site language in which original values are shown. * @readonly */ siteLanguage?: string | null; /** * Order price summary. * @readonly */ priceSummary?: PriceSummary; /** Billing address and contact details. */ billingInfo?: AddressWithContact; /** Shipping info and selected shipping option details. */ shippingInfo?: V1ShippingInformation; /** [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer. */ buyerNote?: string | null; /** Order status. */ status?: OrderStatus; /** Whether order is archived. */ archived?: boolean | null; /** * Tax summary. * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * @deprecated Tax summary. * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxSummary?: TaxSummary; /** Tax information. */ taxInfo?: OrderTaxInfo; /** Applied discounts. */ appliedDiscounts?: AppliedDiscount[]; /** * Order activities. * @readonly */ activities?: Activity[]; /** Order attribution source. */ attributionSource?: AttributionSource; /** * ID of the order's initiator. * @readonly */ createdBy?: CreatedBy; /** Information about the sales channel that submitted this order. */ channelInfo?: ChannelInfo; /** Whether a human has seen the order. Set when an order is clicked on in the dashboard. */ seenByAHuman?: boolean | null; /** Checkout ID. */ checkoutId?: string | null; /** Custom fields. */ customFields?: CustomField[]; /** * Balance summary. * @readonly */ balanceSummary?: BalanceSummary; /** Additional fees applied to the order. */ additionalFees?: AdditionalFee[]; /** * Custom field data for the order object. * * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls. */ extendedFields?: ExtendedFields; /** Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order. */ purchaseFlowId?: string | null; /** * Order recipient address and contact details. * * This field may differ from the address in `shippingInfo.logistics` when: * + The chosen shipping option is pickup point or store pickup. * + No shipping option is selected. */ recipientInfo?: AddressWithContact; /** * Date and time the order was originally purchased in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. * Used for migration from external systems. */ purchasedDate?: Date | null; /** Order Location */ businessLocation?: Location; /** * Pay after free trial price summary. Price summary that should be paid for subscriptions after free trial period. * @internal * @readonly */ payAfterFreeTrial?: PriceSummary; } interface BulkUpdateOrdersOptions { /** * Whether to return the full order entities. * * Default: `false` */ returnEntity?: boolean; } interface CommitDeltasOptions { /** * Draft order Id representing this change. * Use this ID to get this specific draft content. call .../v1/draft-orders/{draft_order_id}/get */ draftOrderId?: string; /** Draft order changes to be applied */ changes: DraftOrderDiffs; /** Side-effects to happen after order is updated */ commitSettings?: DraftOrderCommitSettings; /** Reason for edit, given by user (optional). */ reason?: string | null; } interface UpdateOrderLineItemIdentifiers { /** Order ID */ _id: string; /** Line item ID. */ lineItemId?: string; } interface UpdateOrderLineItem { /** Line item ID. */ _id?: string; /** * Item name. * + Stores - `product.name` * + Bookings - `service.info.name` * + Events - `ticket.name` */ productName?: ProductName; /** Catalog and item reference. Holds IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */ catalogReference?: CatalogReference; /** Line item quantity. */ quantity?: number; /** * Total discount for this line item's entire quantity. * @readonly */ totalDiscount?: Price; /** Line item description lines. Used for display purposes for the cart, checkout and order. */ descriptionLines?: DescriptionLine[]; /** Line item image. */ image?: string; /** Physical properties of the item. When relevant, contains information such as SKU and item weight. */ physicalProperties?: PhysicalProperties; /** Item type. Either a preset type or custom. */ itemType?: ItemType; /** * Fulfiller ID. Field is empty when the line item is self-fulfilled. * * To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://www.wix.com/velo/reference/wix-ecom-backend/orderfulfillments/listfulfillmentsforsingleorder). */ fulfillerId?: string | null; /** Number of items that were refunded. */ refundQuantity?: number | null; /** Number of items restocked. */ restockQuantity?: number | null; /** Line item price after line item discounts for display purposes. */ price?: Price; /** * Line item price before line item discounts for display purposes. Defaults to `price` when not provided. * @readonly */ priceBeforeDiscounts?: Price; /** * Total price after discounts, and before tax. * @readonly */ totalPriceBeforeTax?: Price; /** * Total price after all discounts and tax. * @readonly */ totalPriceAfterTax?: Price; /** * Type of selected payment option for current item. * * Default: `FULL_PAYMENT_ONLINE` */ paymentOption?: PaymentOptionType; /** * Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @deprecated Deprecated. Use `taxInfo` instead. * This field will be removed on September 30, 2024. * Tax details for this line item. * @replacedBy tax_info * @targetRemovalDate 2024-09-30 */ taxDetails?: ItemTaxFullDetails; /** Represents all the relevant tax details for a specific line item. */ taxInfo?: LineItemTaxInfo; /** Digital file identifier, relevant only for items with type DIGITAL. */ digitalFile?: DigitalFile; /** Subscription info. */ subscriptionInfo?: SubscriptionInfo; /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */ priceDescription?: PriceDescription; /** * Item's price amount to be charged during checkout. Relevant for items with a `paymentOption` value of `"DEPOSIT_ONLINE"`. * @readonly */ depositAmount?: Price; /** * Address used for tax calculation. * @internal */ taxableAddress?: TaxableAddress; /** * ID of the app managing the inventory. * @internal */ inventoryAppId?: string | null; /** * Custom extended fields for the line item object. * * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls. */ extendedFields?: ExtendedFields; } interface UpdateActivityIdentifiers { /** Order ID. */ _id: string; /** ID of the activity to update. */ activityId: string; } interface DeleteActivityIdentifiers { /** Order ID. */ _id: string; /** ID of the activity to delete. */ activityId: string; } interface CancelOrderOptions { /** Whether to send an order canceled email to the buyer. */ sendOrderCanceledEmail?: boolean; /** Custom note to be added to the email (optional). */ customMessage?: string | null; /** Whether to restock all items in the order. This will only apply to products in the Wix Stores inventory. */ restockAllItems?: boolean; } interface AggregateOrdersOptions { /** Filter applied to original data */ filter?: Record | null; /** This is an object defining aggregation itself */ aggregation: Record | null; /** * Optional custom separator string that can be used to override default separator value '|' * for hierarchical responses of multifaceted aggregation requests like: * '{"aggregation": {"example_request_key": {"$count" : ["deliveryMethod", "shippingRegion"]}}}' * with example response for default '|' separator like: * '{"aggregates" :{"example_request_key": {"(Mail|Region 1)": 5, "(Pickup|Region 2)": 10}}}' */ hierarchySeparatorOverride?: string | null; } interface BulkUpdateOrderTagsOptions { /** Tags to be added to orders */ assignTags?: Tags; /** Tags to be removed from orders */ unassignTags?: Tags; } export { type CancelOrderResponse as $, type CommitDeltasOptions as A, type BulkMarkOrdersAsPaidResponse as B, type CreatePaymentGatewayOrderResponse as C, type CommitDeltasResponse as D, type CommitDeltasResponseNonNullableFields as E, type UpdateOrderLineItemIdentifiers as F, type GetPaymentCollectabilityStatusResponse as G, type UpdateOrderLineItem as H, type UpdateOrderLineItemResponse as I, type UpdateOrderLineItemResponseNonNullableFields as J, type PublicActivity as K, type AddActivityResponse as L, type MarkOrderAsPaidResponse as M, type AddActivityResponseNonNullableFields as N, type Order as O, type Price as P, type UpdateActivityIdentifiers as Q, type UpdateActivityResponse as R, type SearchOrdersOptions as S, type TriggerRefundOptions as T, type UpdateOrder as U, type VoidAuthorizedPaymentsResponse as V, type UpdateActivityResponseNonNullableFields as W, type DeleteActivityIdentifiers as X, type DeleteActivityResponse as Y, type DeleteActivityResponseNonNullableFields as Z, type CancelOrderOptions as _, type PreparePaymentCollectionOptions as a, type PlainTextValue as a$, type CancelOrderResponseNonNullableFields as a0, OrderStatus as a1, type UpdateOrderStatusResponse as a2, type UpdateOrderStatusResponseNonNullableFields as a3, type AggregateOrdersOptions as a4, type AggregateOrdersResponse as a5, type BulkUpdateOrderTagsOptions as a6, type BulkUpdateOrderTagsResponse as a7, type BulkUpdateOrderTagsResponseNonNullableFields as a8, DescriptionLineType as a9, WebhookIdentityType as aA, VersioningMode as aB, PreviewEmailType as aC, ScheduledAction as aD, DurationUnit as aE, PaymentCollectabilityStatus as aF, RefundableStatus as aG, NonRefundableReason as aH, ManuallyRefundableReason as aI, RestockType as aJ, OrderApprovalStrategy as aK, DeltaPaymentOptionType as aL, InventoryAction as aM, Placement as aN, SubdivisionType as aO, SourceType as aP, CustomFieldGroup as aQ, ValueType as aR, DepositType as aS, InvoiceStatus as aT, type OrderLineItem as aU, type ProductName as aV, type CatalogReference as aW, type DescriptionLine as aX, type DescriptionLineValueOneOf as aY, type DescriptionLineDescriptionLineValueOneOf as aZ, type DescriptionLineName as a_, ItemTypeItemType as aa, PaymentOptionType as ab, JurisdictionType as ac, SubscriptionFrequency as ad, TaxableAddressType as ae, PaymentStatus as af, FulfillmentStatus as ag, WeightUnit as ah, VatType as ai, PickupMethod as aj, DiscountType as ak, DiscountReason as al, LineItemQuantityChangeType as am, ActivityType as an, AttributionSource as ao, ChannelType as ap, State as aq, Namespace as ar, SortOrder as as, TransactionStatus as at, AuthorizationCaptureStatus as au, AuthorizationVoidStatus as av, Reason as aw, ActionType as ax, MembershipPaymentStatus as ay, RefundStatus as az, type PreparePaymentCollectionResponse as b, type ManagedAdditionalFee as b$, type Color as b0, type FocalPoint as b1, type PhysicalProperties as b2, type ItemType as b3, type ItemTypeItemTypeDataOneOf as b4, type ItemTaxFullDetails as b5, type LineItemTaxInfo as b6, type LineItemTaxBreakdown as b7, type DigitalFile as b8, type SubscriptionInfo as b9, type OrderTaxBreakdown as bA, type AppliedDiscount as bB, type AppliedDiscountDiscountSourceOneOf as bC, type Coupon as bD, type MerchantDiscount as bE, type MerchantDiscountMerchantDiscountReasonOneOf as bF, type DiscountRule as bG, type DiscountRuleName as bH, type LineItemDiscount as bI, type Activity as bJ, type ActivityContentOneOf as bK, type CustomActivity as bL, type MerchantComment as bM, type OrderRefunded as bN, type OrderCreatedFromExchange as bO, type NewExchangeOrderCreated as bP, type LineItemExchangeData as bQ, type DraftOrderChangesApplied as bR, type OrderChange as bS, type OrderChangeValueOneOf as bT, type LineItemChanges as bU, type LineItemQuantityChange as bV, type LineItemPriceChange as bW, type ManagedLineItem as bX, type ManagedDiscount as bY, type TranslatedValue as bZ, type LineItemAmount as b_, type SubscriptionSettings as ba, type FreeTrialPeriod as bb, type PriceDescription as bc, type LocationAndQuantity as bd, type TaxableAddress as be, type TaxableAddressTaxableAddressDataOneOf as bf, type ExtendedFields as bg, type BuyerInfo as bh, type BuyerInfoIdOneOf as bi, type PriceSummary as bj, type AddressWithContact as bk, type Address as bl, type StreetAddress as bm, type AddressLocation as bn, type FullAddressContactDetails as bo, type VatId as bp, type V1ShippingInformation as bq, type DeliveryLogistics as br, type DeliveryLogisticsAddressOneOf as bs, type PickupDetails as bt, type PickupAddress as bu, type DeliveryTimeSlot as bv, type ShippingPrice as bw, type ShippingRegion as bx, type TaxSummary as by, type OrderTaxInfo as bz, type PreparePaymentCollectionResponseNonNullableFields as c, type Sorting as c$, type TotalPriceChange as c0, type ShippingInformationChange as c1, type ShippingInformation as c2, type SavedPaymentMethod as c3, type AuthorizedPaymentCreated as c4, type AuthorizedPaymentCaptured as c5, type AuthorizedPaymentVoided as c6, type RefundInitiated as c7, type RefundedPayment as c8, type RefundedPaymentKindOneOf as c9, type Balance as cA, type AdditionalFee as cB, type FulfillmentStatusesAggregate as cC, type Tags as cD, type TagList as cE, type Location as cF, type TriggerReindexOrderRequest as cG, type SnapshotMessage as cH, type PaymentStatusUpdated as cI, type OrderApproved as cJ, type OrdersExperiments as cK, type OrderRejectedEventOrderRejected as cL, type OrderItemsRestocked as cM, type V1RestockItem as cN, type GetMetasiteDataRequest as cO, type GetMetasiteDataResponse as cP, type MetaSite as cQ, type App as cR, type SeoData as cS, type MetaTag as cT, type HtmlApplication as cU, type ExternalUriMapping as cV, type UserDataResponse as cW, type QueryOrdersForMetasiteRequest as cX, type InternalQueryOrdersRequest as cY, type PlatformQuery as cZ, type PlatformQueryPagingMethodOneOf as c_, type RegularPaymentRefund as ca, type GiftCardPaymentRefund as cb, type MembershipPaymentRefund as cc, type PaymentRefunded as cd, type PaymentRefundFailed as ce, type RefundedAsStoreCredit as cf, type PaymentPending as cg, type PaymentPendingPaymentDetailsOneOf as ch, type RegularPayment as ci, type RegularPaymentPaymentMethodDetailsOneOf as cj, type CreditCardDetails as ck, type PaymentCanceled as cl, type PaymentCanceledPaymentDetailsOneOf as cm, type PaymentDeclined as cn, type PaymentDeclinedPaymentDetailsOneOf as co, type ReceiptCreated as cp, type ReceiptCreatedReceiptInfoOneOf as cq, type WixReceipt as cr, type ExternalReceipt as cs, type ReceiptSent as ct, type ReceiptSentReceiptInfoOneOf as cu, type CreatedBy as cv, type CreatedByStringOneOf as cw, type ChannelInfo as cx, type CustomField as cy, type BalanceSummary as cz, type GetPaymentCollectabilityStatusResponseNonNullableFields as d, type Empty as d$, type PlatformPaging as d0, type CursorPaging as d1, type QueryOrdersForMetasiteResponse as d2, type PlatformPagingMetadata as d3, type Cursors as d4, type GetOrderForMetasiteRequest as d5, type GetOrderForMetasiteResponse as d6, type ListOrderTransactionsForMetasiteRequest as d7, type ListOrderTransactionsForMetasiteResponse as d8, type OrderTransactions as d9, type RefundItemsBreakdown as dA, type LineItemRefundSummary as dB, type UpsertRefundRequest as dC, type UpsertRefundResponse as dD, type DomainEvent as dE, type DomainEventBodyOneOf as dF, type EntityCreatedEvent as dG, type RestoreInfo as dH, type EntityUpdatedEvent as dI, type EntityDeletedEvent as dJ, type ActionEvent as dK, type MessageEnvelope as dL, type IdentificationData as dM, type IdentificationDataIdOneOf as dN, type UpdateInternalDocumentsEvent as dO, type UpdateInternalDocumentsEventOperationOneOf as dP, type InternalDocument as dQ, type InternalDocumentUpdateOperation as dR, type DeleteByIdsOperation as dS, type DeleteByFilterOperation as dT, type InternalDocumentUpdateByFilterOperation as dU, type InternalUpdateExistingOperation as dV, type VersionedDocumentUpdateOperation as dW, type VersionedDeleteByIdsOperation as dX, type VersionedDocumentId as dY, type TriggerReindexRequest as dZ, type TriggerReindexResponse as d_, type Payment as da, type PaymentPaymentDetailsOneOf as db, type PaymentReceiptInfoOneOf as dc, type RegularPaymentDetails as dd, type RegularPaymentDetailsPaymentMethodDetailsOneOf as de, type CreditCardPaymentMethodDetails as df, type AuthorizationDetails as dg, type AuthorizationCapture as dh, type AuthorizationActionFailureDetails as di, type AuthorizationVoid as dj, type V1ScheduledAction as dk, type GiftCardPaymentDetails as dl, type MembershipPaymentDetails as dm, type MembershipName as dn, type WixReceiptInfo as dp, type ExternalReceiptInfo as dq, type Refund as dr, type RefundTransaction as ds, type RefundStatusInfo as dt, type RefundDetails as du, type RefundItem as dv, type LineItemRefund as dw, type AdditionalFeeRefund as dx, type ShippingRefund as dy, type AggregatedRefundSummary as dz, type MarkOrderAsPaidResponseNonNullableFields as e, type RestockInfo as e$, type BatchOfTriggerReindexOrderRequest as e0, type SendBuyerConfirmationEmailRequest as e1, type SendBuyerConfirmationEmailResponse as e2, type SendBuyerPaymentsReceivedEmailRequest as e3, type SendBuyerPaymentsReceivedEmailResponse as e4, type SendBuyerPickupConfirmationEmailRequest as e5, type SendBuyerPickupConfirmationEmailResponse as e6, type BulkSendBuyerPickupConfirmationEmailsRequest as e7, type BulkSendBuyerPickupConfirmationEmailsResponse as e8, type SendBuyerShippingConfirmationEmailRequest as e9, type PreviewShippingConfirmationEmailResponse as eA, type PreviewResendDownloadLinksEmailRequest as eB, type PreviewResendDownloadLinksEmailResponse as eC, type PreparePaymentCollectionRequest as eD, type RedirectUrls as eE, type DelayedCaptureSettings as eF, type Duration as eG, type GetPaymentCollectabilityStatusRequest as eH, type RecordManuallyCollectedPaymentRequest as eI, type RecordManuallyCollectedPaymentResponse as eJ, type MarkOrderAsPaidRequest as eK, type BulkMarkOrdersAsPaidRequest as eL, type BulkOrderResult as eM, type ItemMetadata as eN, type ApplicationError as eO, type BulkActionMetadata as eP, type GetRefundabilityStatusRequest as eQ, type Refundability as eR, type RefundabilityAdditionalRefundabilityInfoOneOf as eS, type CreatePaymentGatewayOrderRequest as eT, type ChargedBy as eU, type ChargeMembershipsRequest as eV, type MembershipChargeItem as eW, type ServiceProperties as eX, type ChargeMembershipsResponse as eY, type TriggerRefundRequest as eZ, type RefundSideEffects as e_, type SendBuyerShippingConfirmationEmailResponse as ea, type BulkSendBuyerShippingConfirmationEmailsRequest as eb, type BulkSendBuyerShippingConfirmationEmailsResponse as ec, type SendMerchantOrderReceivedNotificationRequest as ed, type SendMerchantOrderReceivedNotificationResponse as ee, type SendCancelRefundEmailRequest as ef, type SendCancelRefundEmailResponse as eg, type SendRefundEmailRequest as eh, type SendRefundEmailResponse as ei, type SendMerchantOrderReceivedPushRequest as ej, type SendMerchantOrderReceivedPushResponse as ek, type PreviewEmailByTypeRequest as el, type PreviewEmailByTypeResponse as em, type PreviewRefundEmailRequest as en, type PreviewRefundEmailResponse as eo, type PreviewCancelEmailRequest as ep, type PreviewCancelEmailResponse as eq, type PreviewCancelRefundEmailRequest as er, type PreviewCancelRefundEmailResponse as es, type PreviewBuyerPaymentsReceivedEmailRequest as et, type PreviewBuyerPaymentsReceivedEmailResponse as eu, type PreviewBuyerConfirmationEmailRequest as ev, type PreviewBuyerConfirmationEmailResponse as ew, type PreviewBuyerPickupConfirmationEmailRequest as ex, type PreviewBuyerPickupConfirmationEmailResponse as ey, type PreviewShippingConfirmationEmailRequest as ez, type BulkMarkOrdersAsPaidResponseNonNullableFields as f, type BuyerInfoUpdate as f$, type RestockItem as f0, type CalculateRefundRequest as f1, type CalculateRefundItemRequest as f2, type CalculateRefundResponse as f3, type CalculateRefundItemResponse as f4, type VoidAuthorizedPaymentsRequest as f5, type CaptureAuthorizedPaymentsRequest as f6, type ChargeSavedPaymentMethodRequest as f7, type ChargeSavedPaymentMethodResponse as f8, type DiffmatokyPayload as f9, type V1LineItemDeltaDeltaOneOf as fA, type OrderLineItemChangedDetails as fB, type ItemChangedDetails as fC, type AppliedDiscountDelta as fD, type AppliedDiscountDeltaDeltaOneOf as fE, type AdditionalFeeDelta as fF, type AdditionalFeeDeltaDeltaOneOf as fG, type DraftOrderCommitSettings as fH, type InventoryUpdateDetails as fI, type OrderDeltasCommitted as fJ, type CommittedDiffs as fK, type CommittedDiffsShippingUpdateInfoOneOf as fL, type LineItemDelta as fM, type LineItemDeltaDeltaOneOf as fN, type ArchiveOrderRequest as fO, type ArchiveOrderResponse as fP, type BulkArchiveOrdersRequest as fQ, type BulkArchiveOrdersResponse as fR, type BulkArchiveOrdersByFilterRequest as fS, type BulkArchiveOrdersByFilterResponse as fT, type UnArchiveOrderRequest as fU, type UnArchiveOrderResponse as fV, type BulkUnArchiveOrdersRequest as fW, type BulkUnArchiveOrdersResponse as fX, type BulkUnArchiveOrdersByFilterRequest as fY, type BulkUnArchiveOrdersByFilterResponse as fZ, type UpdateBuyerInfoRequest as f_, type ErrorInformation as fa, type ContinueSideEffectsFlowInLegacyData as fb, type IndexingMessage as fc, type GetOrderRequest as fd, type GetOrderResponse as fe, type InternalQueryOrdersResponse as ff, type QueryOrderRequest as fg, type QueryOrderResponse as fh, type SearchOrdersRequest as fi, type CursorSearch as fj, type CursorSearchPagingMethodOneOf as fk, type CursorPagingMetadata as fl, type CreateOrderRequest as fm, type OrderCreationSettings as fn, type OrderCreateNotifications as fo, type CreateOrderResponse as fp, type UpdateOrderRequest as fq, type UpdateOrderResponse as fr, type BulkUpdateOrdersRequest as fs, type CommitDeltasRequest as ft, type DraftOrderDiffs as fu, type DraftOrderDiffsShippingUpdateInfoOneOf as fv, type DraftOrderDiffsBuyerUpdateInfoOneOf as fw, type DraftOrderDiffsBillingUpdateInfoOneOf as fx, type DraftOrderDiffsRecipientUpdateInfoOneOf as fy, type V1LineItemDelta as fz, type GetRefundabilityStatusResponse as g, type BulkSetBusinessLocationResult as g$, type UpdateBuyerInfoResponse as g0, type UpdateBuyerEmailRequest as g1, type UpdateBuyerEmailResponse as g2, type UpdateOrderShippingAddressRequest as g3, type UpdateOrderShippingAddressResponse as g4, type UpdateBillingContactDetailsRequest as g5, type UpdateBillingContactDetailsResponse as g6, type UpdateOrderLineItemRequest as g7, type UpdateOrderLineItemsRequest as g8, type MaskedOrderLineItem as g9, type AddActivitiesRequest as gA, type AddActivitiesResponse as gB, type UpdateActivityRequest as gC, type DeleteActivityRequest as gD, type UpdateLineItemsDescriptionLinesRequest as gE, type LineItemUpdate as gF, type UpdateLineItemsDescriptionLinesResponse as gG, type MarkOrderAsSeenByHumanRequest as gH, type MarkOrderAsSeenByHumanResponse as gI, type CancelOrderRequest as gJ, type OrderCanceledEventOrderCanceled as gK, type UpdateOrderStatusRequest as gL, type MarkAsFulfilledRequest as gM, type MarkAsFulfilledResponse as gN, type FulfillmentStatusUpdated as gO, type BulkMarkAsFulfilledRequest as gP, type BulkMarkAsFulfilledResponse as gQ, type BulkMarkAsFulfilledByFilterRequest as gR, type BulkMarkAsFulfilledByFilterResponse as gS, type MarkAsUnfulfilledRequest as gT, type MarkAsUnfulfilledResponse as gU, type BulkMarkAsUnfulfilledRequest as gV, type BulkMarkAsUnfulfilledResponse as gW, type BulkMarkAsUnfulfilledByFilterRequest as gX, type BulkMarkAsUnfulfilledByFilterResponse as gY, type BulkSetBusinessLocationRequest as gZ, type BulkSetBusinessLocationResponse as g_, type UpdateOrderLineItemsResponse as ga, type AddInternalActivityRequest as gb, type InternalActivity as gc, type InternalActivityContentOneOf as gd, type OrderPlaced as ge, type OrderPaid as gf, type OrderFulfilled as gg, type OrderNotFulfilled as gh, type OrderCanceled as gi, type DownloadLinkSent as gj, type TrackingNumberAdded as gk, type TrackingNumberEdited as gl, type TrackingLinkAdded as gm, type ShippingConfirmationEmailSent as gn, type InvoiceAdded as go, type InvoiceSent as gp, type FulfillerEmailSent as gq, type ShippingAddressEdited as gr, type EmailEdited as gs, type PickupReadyEmailSent as gt, type OrderPartiallyPaid as gu, type OrderPending as gv, type OrderRejected as gw, type AddInternalActivityResponse as gx, type AddActivityRequest as gy, type PublicActivityContentOneOf as gz, type GetRefundabilityStatusResponseNonNullableFields as h, type OrderCanceledEnvelope as h$, type V1MarkOrderAsPaidRequest as h0, type V1MarkOrderAsPaidResponse as h1, type V1BulkMarkOrdersAsPaidRequest as h2, type V1BulkMarkOrdersAsPaidResponse as h3, type V1CreatePaymentGatewayOrderRequest as h4, type V1CreatePaymentGatewayOrderResponse as h5, type GetShipmentsRequest as h6, type GetShipmentsResponse as h7, type AggregateOrdersRequest as h8, type DecrementItemsQuantityRequest as h9, type LineItem as hA, type BigDecimalWrapper as hB, type LineItemTax as hC, type Source as hD, type LineItemMetaData as hE, type Locale as hF, type TotalPrice as hG, type ItemizedFee as hH, type Discount as hI, type DiscountOneDiscountTypeOneOf as hJ, type CalculatedTaxes as hK, type CalculatedTax as hL, type Payments as hM, type InvoicesPayment as hN, type MetaData as hO, type InvoiceDynamicPriceTotals as hP, type CustomFieldValue as hQ, type Value as hR, type Deposit as hS, type TriggerSideEffectsFromLegacyData as hT, type GetOrderResponseNonNullableFields as hU, type CreateOrderResponseNonNullableFields as hV, type UpdateOrderResponseNonNullableFields as hW, type BaseEventMetadata as hX, type EventMetadata as hY, type OrderApprovedEnvelope as hZ, type OrderUpdatedEnvelope as h_, type DecrementData as ha, type DecrementItemsQuantityResponse as hb, type BulkUpdateOrderTagsRequest as hc, type BulkUpdateOrderTagsResult as hd, type Task as he, type TaskKey as hf, type TaskAction as hg, type TaskActionActionOneOf as hh, type Complete as hi, type Cancel as hj, type Reschedule as hk, type InvoiceSentEvent as hl, type IdAndVersion as hm, type InvoiceFields as hn, type Customer as ho, type Email as hp, type QuotesAddress as hq, type AddressDescription as hr, type Phone as hs, type Company as ht, type CommonAddress as hu, type CommonAddressStreetOneOf as hv, type Subdivision as hw, type StandardDetails as hx, type InvoiceDates as hy, type LineItems as hz, type PaymentCollectionCreatePaymentGatewayOrderOptions as i, type OrderCreatedEnvelope as i0, type CreatePaymentGatewayOrderResponseNonNullableFields as j, type ChargeMembershipsOptions as k, type PaymentRefund as l, type TriggerRefundResponse as m, type TriggerRefundResponseNonNullableFields as n, type VoidAuthorizedPaymentsResponseNonNullableFields as o, type PaymentCapture as p, type CaptureAuthorizedPaymentsResponse as q, type CaptureAuthorizedPaymentsResponseNonNullableFields as r, type OrderNonNullableFields as s, type SearchOrdersResponse as t, type SearchOrdersResponseNonNullableFields as u, type CreateOrderOptions as v, type MaskedOrder as w, type BulkUpdateOrdersOptions as x, type BulkUpdateOrdersResponse as y, type BulkUpdateOrdersResponseNonNullableFields as z };