@wix/auto_sdk_ecom_payment-settings 1.0.96 → 1.0.98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,6 +4,11 @@ interface GetPaymentSettingsRequest {
4
4
  /** Order. */
5
5
  order?: Order;
6
6
  }
7
+ /**
8
+ * An order represents a completed purchase from a buyer. Orders are created through the checkout flow or manually via the Create Order endpoint.
9
+ *
10
+ * The order contains details about purchased items, buyer and recipient information, pricing, tax, shipping, fulfillment status, and payment status.
11
+ */
7
12
  interface Order {
8
13
  /**
9
14
  * Order ID.
@@ -150,10 +155,10 @@ interface Order {
150
155
  */
151
156
  purchaseFlowId?: string | null;
152
157
  /**
153
- * Order recipient address and contact details.
158
+ * Final recipient's address and contact details.
154
159
  *
155
- * This field may differ from the address in `shippingInfo.logistics` when:
156
- * + The chosen shipping option is pickup point or store pickup.
160
+ * This field represents who will ultimately receive the order. It may differ from `shippingInfo.logistics.shippingDestination` when:
161
+ * + The chosen shipping option is a pickup point or store pickup, where `shippingDestination` contains the pickup location.
157
162
  * + No shipping option is selected.
158
163
  */
159
164
  recipientInfo?: ApiAddressWithContact;
@@ -185,15 +190,13 @@ interface OrderLineItem {
185
190
  _id?: string;
186
191
  /**
187
192
  * Item name.
193
+ *
188
194
  * + Stores - `product.name`
189
195
  * + Bookings - `service.info.name`
190
196
  * + Events - `ticket.name`
191
197
  */
192
198
  productName?: ProductName;
193
- /**
194
- * References to the line item's origin catalog.
195
- * This field may be empty in the case of a custom line item.
196
- */
199
+ /** References to the line item's origin catalog. Empty for custom line items. */
197
200
  catalogReference?: CatalogReference;
198
201
  /**
199
202
  * Line item quantity.
@@ -850,25 +853,25 @@ interface V1ItemModifier {
850
853
  /** The price of the modifier. */
851
854
  price?: Price;
852
855
  }
853
- /** Buyer Info */
856
+ /** Buyer information. */
854
857
  interface V1BuyerInfo extends V1BuyerInfoIdOneOf {
855
858
  /**
856
- * Visitor ID (if site visitor is not a member).
859
+ * Visitor ID. Returned when the buyer isn't a logged-in site member.
857
860
  * @format GUID
858
861
  */
859
862
  visitorId?: string;
860
863
  /**
861
- * Member ID (if site visitor is a site member).
864
+ * Member ID. Returned when the buyer is a logged-in site member.
862
865
  * @format GUID
863
866
  */
864
867
  memberId?: string;
865
868
  /**
866
- * Contact ID. Auto-created if one does not yet exist. For more information, see [Contacts API](https://dev.wix.com/api/rest/contacts/contacts/introduction).
869
+ * Contact ID. Automatically created if one doesn't exist. For more information, see [Contacts API](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts/contact-v4/introduction).
867
870
  * @format GUID
868
871
  */
869
872
  contactId?: string | null;
870
873
  /**
871
- * Buyer email address.
874
+ * Buyer's email address.
872
875
  * @format EMAIL
873
876
  */
874
877
  email?: string | null;
@@ -876,12 +879,12 @@ interface V1BuyerInfo extends V1BuyerInfoIdOneOf {
876
879
  /** @oneof */
877
880
  interface V1BuyerInfoIdOneOf {
878
881
  /**
879
- * Visitor ID (if site visitor is not a member).
882
+ * Visitor ID. Returned when the buyer isn't a logged-in site member.
880
883
  * @format GUID
881
884
  */
882
885
  visitorId?: string;
883
886
  /**
884
- * Member ID (if site visitor is a site member).
887
+ * Member ID. Returned when the buyer is a logged-in site member.
885
888
  * @format GUID
886
889
  */
887
890
  memberId?: string;
@@ -965,17 +968,17 @@ interface CurrencyConversionDetails {
965
968
  conversionRate?: string | null;
966
969
  }
967
970
  interface PriceSummary {
968
- /** Subtotal of all the line items, before discounts and before tax. */
971
+ /** Subtotal of all line items, before discounts and before tax. */
969
972
  subtotal?: Price;
970
973
  /** Total shipping price, before discounts and before tax. */
971
974
  shipping?: Price;
972
- /** Total tax on this order. */
975
+ /** Total tax applied to the order. */
973
976
  tax?: Price;
974
- /** Total calculated discount value. */
977
+ /** Total discount amount applied to the order. */
975
978
  discount?: Price;
976
- /** Orders total price after discounts and tax. */
979
+ /** Order's total price after discounts and tax. */
977
980
  total?: Price;
978
- /** Total price of additional fees before tax. */
981
+ /** Total additional fees before tax. */
979
982
  totalAdditionalFees?: Price;
980
983
  }
981
984
  /** Billing Info and shipping details */
@@ -1116,9 +1119,9 @@ interface V1ShippingInformation {
1116
1119
  region?: ShippingRegion;
1117
1120
  }
1118
1121
  interface DeliveryLogistics extends DeliveryLogisticsAddressOneOf {
1119
- /** Shipping address and contact details. */
1122
+ /** Shipping destination address and contact details. For pickup orders, this contains the pickup location address, not the recipient's address. */
1120
1123
  shippingDestination?: ApiAddressWithContact;
1121
- /** Pickup details. */
1124
+ /** Pickup details for store pickup or pickup point orders. */
1122
1125
  pickupDetails?: PickupDetails;
1123
1126
  /**
1124
1127
  * Expected delivery time in free text. For example, `"3-5 business days"`.
@@ -1126,7 +1129,7 @@ interface DeliveryLogistics extends DeliveryLogisticsAddressOneOf {
1126
1129
  */
1127
1130
  deliveryTime?: string | null;
1128
1131
  /**
1129
- * Instructions for carrier. For example, `"Please knock on the door. If unanswered, please call contact number. Thanks."`.
1132
+ * Instructions for the carrier. For example, `"Please knock on the door. If unanswered, please call contact number."`.
1130
1133
  * @maxLength 1000
1131
1134
  */
1132
1135
  instructions?: string | null;
@@ -1135,14 +1138,14 @@ interface DeliveryLogistics extends DeliveryLogisticsAddressOneOf {
1135
1138
  * @deprecated
1136
1139
  */
1137
1140
  deliverByDate?: Date | null;
1138
- /** Expected delivery time. */
1141
+ /** Expected delivery time slot with start and end times. */
1139
1142
  deliveryTimeSlot?: DeliveryTimeSlot;
1140
1143
  }
1141
1144
  /** @oneof */
1142
1145
  interface DeliveryLogisticsAddressOneOf {
1143
- /** Shipping address and contact details. */
1146
+ /** Shipping destination address and contact details. For pickup orders, this contains the pickup location address, not the recipient's address. */
1144
1147
  shippingDestination?: ApiAddressWithContact;
1145
- /** Pickup details. */
1148
+ /** Pickup details for store pickup or pickup point orders. */
1146
1149
  pickupDetails?: PickupDetails;
1147
1150
  }
1148
1151
  interface PickupDetails {
@@ -1248,14 +1251,14 @@ declare enum OrderStatus {
1248
1251
  /**
1249
1252
  * Order approved.
1250
1253
  *
1251
- * This happens when either an online payment is received **or** when `order.priceSummary.total = 0` (a zero-total order).
1254
+ * This happens when either an online payment is received **or** when `priceSummary.total` is `0` (a zero-total order).
1252
1255
  * Offline orders (cash payment) are automatically approved.
1253
1256
  */
1254
1257
  APPROVED = "APPROVED",
1255
- /** Order canceled by the user. */
1258
+ /** Order canceled by the merchant or buyer. */
1256
1259
  CANCELED = "CANCELED",
1257
1260
  /**
1258
- * Order pending.
1261
+ * Order is waiting for the buyer to complete checkout.
1259
1262
  * @documentationMaturity preview
1260
1263
  */
1261
1264
  PENDING = "PENDING",
@@ -1474,8 +1477,6 @@ interface ItemCombinationLineItem {
1474
1477
  quantity?: number;
1475
1478
  }
1476
1479
  interface Activity extends ActivityContentOneOf {
1477
- /** Custom activity details (optional). `activity.type` must be `CUSTOM_ACTIVITY`. */
1478
- customActivity?: CustomActivity;
1479
1480
  /** Merchant comment details (optional). `activity.type` must be `MERCHANT_COMMENT`. */
1480
1481
  merchantComment?: MerchantComment;
1481
1482
  /** Additional info about order refunded activity (optional). `activity.type` must be `ORDER_REFUNDED`. */
@@ -1556,8 +1557,6 @@ interface Activity extends ActivityContentOneOf {
1556
1557
  }
1557
1558
  /** @oneof */
1558
1559
  interface ActivityContentOneOf {
1559
- /** Custom activity details (optional). `activity.type` must be `CUSTOM_ACTIVITY`. */
1560
- customActivity?: CustomActivity;
1561
1560
  /** Merchant comment details (optional). `activity.type` must be `MERCHANT_COMMENT`. */
1562
1561
  merchantComment?: MerchantComment;
1563
1562
  /** Additional info about order refunded activity (optional). `activity.type` must be `ORDER_REFUNDED`. */
@@ -2525,15 +2524,19 @@ interface V1CreatedByStringOneOf {
2525
2524
  appId?: string;
2526
2525
  }
2527
2526
  interface ChannelInfo {
2528
- /** Sales channel that submitted the order. */
2527
+ /**
2528
+ * Sales channel that submitted the order.
2529
+ *
2530
+ * When creating an order via the API to record an external order, use the channel type that matches the original source. If no matching type exists, use `OTHER_PLATFORM`.
2531
+ */
2529
2532
  type?: ChannelType;
2530
2533
  /**
2531
- * Reference to an order ID from an external system.
2534
+ * Reference to an order ID from an external system. Relevant when recording orders from external platforms.
2532
2535
  * @maxLength 100
2533
2536
  */
2534
2537
  externalOrderId?: string | null;
2535
2538
  /**
2536
- * URL to the order in the external system.
2539
+ * URL to the order in the external system. Relevant when recording orders from external platforms.
2537
2540
  * @maxLength 300
2538
2541
  */
2539
2542
  externalOrderUrl?: string | null;
@@ -2961,6 +2964,7 @@ interface GetPaymentSettingsForCheckoutRequest {
2961
2964
  /** Checkout. */
2962
2965
  checkout?: Checkout;
2963
2966
  }
2967
+ /** A checkout represents a cart that is in the process of being purchased. It holds calculated prices, tax, shipping, and buyer information needed to complete the purchase. */
2964
2968
  interface Checkout {
2965
2969
  /**
2966
2970
  * Checkout ID.
@@ -4567,7 +4571,7 @@ interface V1AdditionalFee {
4567
4571
  */
4568
4572
  code?: string | null;
4569
4573
  /**
4570
- * Translated additional fee's name.
4574
+ * Additional fee's name.
4571
4575
  * @minLength 1
4572
4576
  * @maxLength 50
4573
4577
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wix/auto_sdk_ecom_payment-settings",
3
- "version": "1.0.96",
3
+ "version": "1.0.98",
4
4
  "license": "MIT",
5
5
  "publishConfig": {
6
6
  "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
50
50
  "fqdn": "wix.interfaces.ecommerce.v1.payment_settings_provider"
51
51
  }
52
52
  },
53
- "falconPackageHash": "cd58a6e90dfc96c4c04141806eeddd9dbc9595ed5621a1ce06309377"
53
+ "falconPackageHash": "c5f1df966914752d108c31a7b51e567405ef62aab072a9aefaa8ec24"
54
54
  }