@wix/auto_sdk_ecom_orders 1.0.292 → 1.0.293
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.
- package/build/cjs/{ecom-v1-order-orders.universal-Dju98zZT.d.ts → ecom-v1-order-orders.universal-CvolNFuz.d.ts} +1665 -1665
- package/build/cjs/index.d.ts +2 -2
- package/build/cjs/index.js +80 -80
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +2 -2
- package/build/cjs/index.typings.js +80 -80
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +1665 -1665
- package/build/cjs/meta.js +80 -80
- package/build/cjs/meta.js.map +1 -1
- package/build/es/{ecom-v1-order-orders.universal-Dju98zZT.d.mts → ecom-v1-order-orders.universal-CvolNFuz.d.mts} +1665 -1665
- package/build/es/index.d.mts +2 -2
- package/build/es/index.mjs +80 -80
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +2 -2
- package/build/es/index.typings.mjs +80 -80
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +1665 -1665
- package/build/es/meta.mjs +80 -80
- package/build/es/meta.mjs.map +1 -1
- package/build/internal/cjs/{ecom-v1-order-orders.universal-BuoCmcuL.d.ts → ecom-v1-order-orders.universal-02_UWg3x.d.ts} +1812 -1812
- package/build/internal/cjs/index.d.ts +2 -2
- package/build/internal/cjs/index.typings.d.ts +2 -2
- package/build/internal/cjs/meta.d.ts +1812 -1812
- package/build/internal/es/{ecom-v1-order-orders.universal-BuoCmcuL.d.mts → ecom-v1-order-orders.universal-02_UWg3x.d.mts} +1812 -1812
- package/build/internal/es/index.d.mts +2 -2
- package/build/internal/es/index.typings.d.mts +2 -2
- package/build/internal/es/meta.d.mts +1812 -1812
- package/package.json +2 -2
package/build/cjs/meta.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { dX as ImportOrderRequest$1, I as ImportOrderResponse$1, dY as SetOrderNumberCounterRequest$1, b as SetOrderNumberCounterResponse$1, dZ as BulkDeleteImportedOrdersRequest$1, B as BulkDeleteImportedOrdersResponse$1,
|
|
1
|
+
import { dX as ImportOrderRequest$1, I as ImportOrderResponse$1, dY as SetOrderNumberCounterRequest$1, b as SetOrderNumberCounterResponse$1, dZ as BulkDeleteImportedOrdersRequest$1, B as BulkDeleteImportedOrdersResponse$1, fi as PreparePaymentCollectionRequest$1, e as PreparePaymentCollectionResponse$1, fm as GetPaymentCollectabilityStatusRequest$1, G as GetPaymentCollectabilityStatusResponse$1, fn as RecordManuallyCollectedPaymentRequest$1, fq as RecordManuallyCollectedPaymentResponse$1, fr as MarkOrderAsPaidRequest$1, fs as MarkOrderAsPaidResponse$1, ft as BulkMarkOrdersAsPaidRequest$1, fu as BulkMarkOrdersAsPaidResponse$1, fz as GetRefundabilityStatusRequest$1, fA as GetRefundabilityStatusResponse$1, fD as CreatePaymentGatewayOrderRequest$1, fF as CreatePaymentGatewayOrderResponse$1, fG as ChargeMembershipsRequest$1, fJ as ChargeMembershipsResponse$1, fK as TriggerRefundRequest$1, fP as TriggerRefundResponse$1, go as VoidAuthorizedPaymentsRequest$1, V as VoidAuthorizedPaymentsResponse$1, gp as CaptureAuthorizedPaymentsRequest$1, C as CaptureAuthorizedPaymentsResponse$1, gx as GetOrderRequest$1, gy as GetOrderResponse$1, gK as SearchOrdersRequest$1, l as SearchOrdersResponse$1, gO as CreateOrderRequest$1, gS as CreateOrderResponse$1, gT as UpdateOrderRequest$1, gU as UpdateOrderResponse$1, gV as BulkUpdateOrdersRequest$1, q as BulkUpdateOrdersResponse$1, ho as UpdateOrderLineItemRequest$1, hp as UpdateOrderLineItemResponse$1, hQ as AddActivityRequest$1, hT as AddActivityResponse$1, hU as AddActivitiesRequest$1, r as AddActivitiesResponse$1, hV as UpdateActivityRequest$1, hW as UpdateActivityResponse$1, hX as DeleteActivityRequest$1, hY as DeleteActivityResponse$1, i2 as CancelOrderRequest$1, t as CancelOrderResponse$1, i3 as UpdateOrderStatusRequest$1, i4 as UpdateOrderStatusResponse$1, iu as AggregateOrdersRequest$1, iv as AggregateOrdersResponse$1, iz as BulkUpdateOrderTagsRequest$1, w as BulkUpdateOrderTagsResponse$1 } from './ecom-v1-order-orders.universal-CvolNFuz.js';
|
|
2
2
|
import '@wix/sdk-types';
|
|
3
3
|
|
|
4
4
|
/**
|
|
@@ -3912,458 +3912,163 @@ interface BulkDeleteImportedOrdersResponse {
|
|
|
3912
3912
|
*/
|
|
3913
3913
|
jobId?: string;
|
|
3914
3914
|
}
|
|
3915
|
-
interface
|
|
3915
|
+
interface SendBuyerConfirmationEmailRequest {
|
|
3916
3916
|
/** @format GUID */
|
|
3917
|
-
|
|
3917
|
+
orderId?: string;
|
|
3918
|
+
}
|
|
3919
|
+
interface SendBuyerConfirmationEmailResponse {
|
|
3920
|
+
}
|
|
3921
|
+
interface SendBuyerPaymentsReceivedEmailRequest {
|
|
3918
3922
|
/**
|
|
3919
3923
|
* @minLength 1
|
|
3920
3924
|
* @maxLength 100
|
|
3921
|
-
* @maxSize 100
|
|
3922
3925
|
*/
|
|
3923
|
-
|
|
3926
|
+
orderId?: string;
|
|
3924
3927
|
}
|
|
3925
|
-
interface
|
|
3928
|
+
interface SendBuyerPaymentsReceivedEmailResponse {
|
|
3926
3929
|
}
|
|
3927
|
-
interface
|
|
3928
|
-
/** @format GUID */
|
|
3929
|
-
metasiteId?: string;
|
|
3930
|
+
interface SendBuyerPickupConfirmationEmailRequest {
|
|
3930
3931
|
/**
|
|
3931
3932
|
* @minLength 1
|
|
3932
3933
|
* @maxLength 100
|
|
3933
3934
|
*/
|
|
3934
3935
|
orderId?: string;
|
|
3935
3936
|
}
|
|
3936
|
-
interface
|
|
3937
|
+
interface SendBuyerPickupConfirmationEmailResponse {
|
|
3938
|
+
}
|
|
3939
|
+
interface BulkSendBuyerPickupConfirmationEmailsRequest {
|
|
3937
3940
|
/**
|
|
3938
|
-
*
|
|
3939
|
-
* @
|
|
3940
|
-
* @
|
|
3941
|
+
* IDs of orders to send pickup emails for.
|
|
3942
|
+
* @minSize 1
|
|
3943
|
+
* @maxSize 300
|
|
3941
3944
|
*/
|
|
3942
|
-
|
|
3943
|
-
|
|
3944
|
-
|
|
3945
|
+
orderIds?: string[];
|
|
3946
|
+
}
|
|
3947
|
+
interface BulkSendBuyerPickupConfirmationEmailsResponse {
|
|
3948
|
+
}
|
|
3949
|
+
interface SendBuyerShippingConfirmationEmailRequest {
|
|
3945
3950
|
/**
|
|
3946
|
-
*
|
|
3947
|
-
*
|
|
3948
|
-
* When parameter is absent, new payment gateway order will be created and used for payment collection.
|
|
3951
|
+
* @minLength 1
|
|
3952
|
+
* @maxLength 100
|
|
3949
3953
|
*/
|
|
3950
|
-
|
|
3954
|
+
orderId?: string;
|
|
3955
|
+
}
|
|
3956
|
+
interface SendBuyerShippingConfirmationEmailResponse {
|
|
3957
|
+
}
|
|
3958
|
+
interface BulkSendBuyerShippingConfirmationEmailsRequest {
|
|
3951
3959
|
/**
|
|
3952
|
-
*
|
|
3953
|
-
*
|
|
3954
|
-
* @
|
|
3955
|
-
* Default: false
|
|
3956
|
-
* @replacedBy delayed_capture_settings.scheduled_action
|
|
3957
|
-
* @targetRemovalDate 2024-09-30
|
|
3960
|
+
* IDs of orders to send pickup emails for.
|
|
3961
|
+
* @minSize 1
|
|
3962
|
+
* @maxSize 300
|
|
3958
3963
|
*/
|
|
3959
|
-
|
|
3960
|
-
/** Delayed capture payment settings */
|
|
3961
|
-
delayedCaptureSettings?: DelayedCaptureSettings;
|
|
3964
|
+
orderIds?: string[];
|
|
3962
3965
|
}
|
|
3963
|
-
interface
|
|
3966
|
+
interface BulkSendBuyerShippingConfirmationEmailsResponse {
|
|
3967
|
+
}
|
|
3968
|
+
interface SendMerchantOrderReceivedNotificationRequest {
|
|
3964
3969
|
/**
|
|
3965
|
-
*
|
|
3966
|
-
* @
|
|
3970
|
+
* @minLength 1
|
|
3971
|
+
* @maxLength 100
|
|
3967
3972
|
*/
|
|
3968
|
-
|
|
3973
|
+
orderId?: string;
|
|
3974
|
+
}
|
|
3975
|
+
interface SendMerchantOrderReceivedNotificationResponse {
|
|
3976
|
+
}
|
|
3977
|
+
interface SendCancelRefundEmailRequest {
|
|
3969
3978
|
/**
|
|
3970
|
-
*
|
|
3971
|
-
* @
|
|
3979
|
+
* The ID of order that is canceled/refunded
|
|
3980
|
+
* @minLength 1
|
|
3981
|
+
* @maxLength 100
|
|
3972
3982
|
*/
|
|
3973
|
-
|
|
3983
|
+
orderId?: string;
|
|
3974
3984
|
/**
|
|
3975
|
-
*
|
|
3976
|
-
* @
|
|
3985
|
+
* Personal note added to the email (optional)
|
|
3986
|
+
* @minLength 1
|
|
3987
|
+
* @maxLength 1000
|
|
3977
3988
|
*/
|
|
3978
|
-
|
|
3989
|
+
customMessage?: string | null;
|
|
3990
|
+
/** Refund amount */
|
|
3991
|
+
refundAmount?: Price;
|
|
3979
3992
|
/**
|
|
3980
|
-
*
|
|
3981
|
-
* @format
|
|
3993
|
+
* Refund ID. (Optional)
|
|
3994
|
+
* @format GUID
|
|
3982
3995
|
*/
|
|
3983
|
-
|
|
3984
|
-
}
|
|
3985
|
-
interface DelayedCaptureSettings {
|
|
3986
|
-
/** Specifies the automatic action (void/capture) for authorized transaction after the specified duration */
|
|
3987
|
-
scheduledAction?: ScheduledActionWithLiterals;
|
|
3988
|
-
/** Delay duration before execution. Optional - if not set, providers default period will be used */
|
|
3989
|
-
delayDuration?: Duration;
|
|
3996
|
+
refundId?: string | null;
|
|
3990
3997
|
}
|
|
3991
|
-
|
|
3992
|
-
/** Whether payment will be auto-voided when duration passes */
|
|
3993
|
-
VOID = "VOID",
|
|
3994
|
-
/** Whether payment will be auto-captured when duration passes */
|
|
3995
|
-
CAPTURE = "CAPTURE"
|
|
3998
|
+
interface SendCancelRefundEmailResponse {
|
|
3996
3999
|
}
|
|
3997
|
-
|
|
3998
|
-
type ScheduledActionWithLiterals = ScheduledAction | 'VOID' | 'CAPTURE';
|
|
3999
|
-
interface Duration {
|
|
4000
|
+
interface SendRefundEmailRequest {
|
|
4000
4001
|
/**
|
|
4001
|
-
*
|
|
4002
|
-
* @
|
|
4002
|
+
* The ID of order that is refunded
|
|
4003
|
+
* @format GUID
|
|
4003
4004
|
*/
|
|
4004
|
-
|
|
4005
|
-
/** Duration unit: MINUTES, HOURS and DAYS */
|
|
4006
|
-
unit?: DurationUnitWithLiterals;
|
|
4007
|
-
}
|
|
4008
|
-
declare enum DurationUnit {
|
|
4009
|
-
MINUTES = "MINUTES",
|
|
4010
|
-
HOURS = "HOURS",
|
|
4011
|
-
DAYS = "DAYS"
|
|
4012
|
-
}
|
|
4013
|
-
/** @enumType */
|
|
4014
|
-
type DurationUnitWithLiterals = DurationUnit | 'MINUTES' | 'HOURS' | 'DAYS';
|
|
4015
|
-
interface PreparePaymentCollectionResponse {
|
|
4016
|
-
/** Payment gateway order id which is associated with given payment */
|
|
4017
|
-
paymentGatewayOrderId?: string;
|
|
4018
|
-
}
|
|
4019
|
-
interface GetPaymentCollectabilityStatusRequest {
|
|
4005
|
+
orderId?: string;
|
|
4020
4006
|
/**
|
|
4021
|
-
*
|
|
4007
|
+
* Refund ID
|
|
4008
|
+
* @format GUID
|
|
4009
|
+
*/
|
|
4010
|
+
refundId?: string;
|
|
4011
|
+
/**
|
|
4012
|
+
* Personal note added to the email (optional)
|
|
4022
4013
|
* @minLength 1
|
|
4023
|
-
* @maxLength
|
|
4014
|
+
* @maxLength 1000
|
|
4024
4015
|
*/
|
|
4025
|
-
|
|
4016
|
+
customMessage?: string | null;
|
|
4026
4017
|
}
|
|
4027
|
-
interface
|
|
4028
|
-
/** Payment collectability status */
|
|
4029
|
-
status?: PaymentCollectabilityStatusWithLiterals;
|
|
4030
|
-
/** Collectable order amount */
|
|
4031
|
-
amount?: Price;
|
|
4018
|
+
interface SendRefundEmailResponse {
|
|
4032
4019
|
}
|
|
4033
|
-
|
|
4034
|
-
|
|
4035
|
-
|
|
4036
|
-
|
|
4037
|
-
|
|
4038
|
-
NONCOLLECTABLE_MISSING_PAYMENT_METHOD = "NONCOLLECTABLE_MISSING_PAYMENT_METHOD",
|
|
4039
|
-
NONCOLLECTABLE_ORDER_IS_PENDING = "NONCOLLECTABLE_ORDER_IS_PENDING",
|
|
4040
|
-
NONCOLLECTABLE_ORDER_IS_REJECTED = "NONCOLLECTABLE_ORDER_IS_REJECTED",
|
|
4041
|
-
NONCOLLECTABLE_ORDER_HAS_SUBSCRIPTIONS = "NONCOLLECTABLE_ORDER_HAS_SUBSCRIPTIONS",
|
|
4042
|
-
NONCOLLECTABLE_ORDER_HAS_CHARGEBACKS = "NONCOLLECTABLE_ORDER_HAS_CHARGEBACKS",
|
|
4043
|
-
NONCOLLECTABLE_SUBSCRIPTION_CYCLE_ALREADY_PASSED = "NONCOLLECTABLE_SUBSCRIPTION_CYCLE_ALREADY_PASSED",
|
|
4044
|
-
NONCOLLECTABLE_ORDER_HAS_UNSUPPORTED_SUBSCRIPTION = "NONCOLLECTABLE_ORDER_HAS_UNSUPPORTED_SUBSCRIPTION",
|
|
4045
|
-
NONCOLLECTABLE_CUSTOM_AMOUNT_NOT_SUPPORTED = "NONCOLLECTABLE_CUSTOM_AMOUNT_NOT_SUPPORTED"
|
|
4020
|
+
interface SendFulfillmentEmailRequest {
|
|
4021
|
+
/** @format GUID */
|
|
4022
|
+
orderId?: string;
|
|
4023
|
+
/** @format GUID */
|
|
4024
|
+
fulfillerId?: string;
|
|
4046
4025
|
}
|
|
4047
|
-
|
|
4048
|
-
|
|
4049
|
-
interface
|
|
4026
|
+
interface SendFulfillmentEmailResponse {
|
|
4027
|
+
}
|
|
4028
|
+
interface SendMerchantOrderReceivedPushRequest {
|
|
4050
4029
|
/**
|
|
4051
|
-
* Order ID.
|
|
4052
4030
|
* @minLength 1
|
|
4053
4031
|
* @maxLength 100
|
|
4054
4032
|
*/
|
|
4055
|
-
orderId
|
|
4056
|
-
/** Amount to be recorded as approved manual payment for given order */
|
|
4057
|
-
amount: Price;
|
|
4033
|
+
orderId?: string;
|
|
4058
4034
|
}
|
|
4059
|
-
|
|
4060
|
-
* User-defined payment method name.
|
|
4061
|
-
* Allows specifying either a predefined type or a custom name.
|
|
4062
|
-
*/
|
|
4063
|
-
interface UserDefinedPaymentMethodName extends UserDefinedPaymentMethodNameKindOneOf {
|
|
4064
|
-
/** Predefined payment method. */
|
|
4065
|
-
predefined?: PredefinedPaymentMethodWithLiterals;
|
|
4066
|
-
/**
|
|
4067
|
-
* Custom payment method name provided by user.
|
|
4068
|
-
*
|
|
4069
|
-
* For example, `"Wire transfer"`, `"Money order"`, `"Venmo"` or any other custom name.
|
|
4070
|
-
* @minLength 1
|
|
4071
|
-
* @maxLength 150
|
|
4072
|
-
*/
|
|
4073
|
-
custom?: string | null;
|
|
4035
|
+
interface SendMerchantOrderReceivedPushResponse {
|
|
4074
4036
|
}
|
|
4075
|
-
|
|
4076
|
-
|
|
4077
|
-
/** Predefined payment method. */
|
|
4078
|
-
predefined?: PredefinedPaymentMethodWithLiterals;
|
|
4079
|
-
/**
|
|
4080
|
-
* Custom payment method name provided by user.
|
|
4081
|
-
*
|
|
4082
|
-
* For example, `"Wire transfer"`, `"Money order"`, `"Venmo"` or any other custom name.
|
|
4083
|
-
* @minLength 1
|
|
4084
|
-
* @maxLength 150
|
|
4085
|
-
*/
|
|
4086
|
-
custom?: string | null;
|
|
4037
|
+
interface PreviewEmailByTypeRequest {
|
|
4038
|
+
emailType?: PreviewEmailTypeWithLiterals;
|
|
4087
4039
|
}
|
|
4088
|
-
|
|
4089
|
-
|
|
4090
|
-
|
|
4091
|
-
|
|
4092
|
-
|
|
4093
|
-
BANK_TRANSFER = "BANK_TRANSFER",
|
|
4094
|
-
/** Payment by check. */
|
|
4095
|
-
CHECK = "CHECK"
|
|
4040
|
+
declare enum PreviewEmailType {
|
|
4041
|
+
ORDER_PLACED = "ORDER_PLACED",
|
|
4042
|
+
DOWNLOAD_LINKS = "DOWNLOAD_LINKS",
|
|
4043
|
+
ORDER_SHIPPED = "ORDER_SHIPPED",
|
|
4044
|
+
ORDER_READY_FOR_PICKUP = "ORDER_READY_FOR_PICKUP"
|
|
4096
4045
|
}
|
|
4097
4046
|
/** @enumType */
|
|
4098
|
-
type
|
|
4099
|
-
interface
|
|
4047
|
+
type PreviewEmailTypeWithLiterals = PreviewEmailType | 'ORDER_PLACED' | 'DOWNLOAD_LINKS' | 'ORDER_SHIPPED' | 'ORDER_READY_FOR_PICKUP';
|
|
4048
|
+
interface PreviewEmailByTypeResponse {
|
|
4049
|
+
emailPreview?: string;
|
|
4100
4050
|
}
|
|
4101
|
-
interface
|
|
4051
|
+
interface PreviewRefundEmailRequest {
|
|
4102
4052
|
/**
|
|
4103
|
-
* Ecom order ID.
|
|
4104
4053
|
* @minLength 1
|
|
4105
4054
|
* @maxLength 100
|
|
4106
4055
|
*/
|
|
4107
|
-
|
|
4108
|
-
|
|
4109
|
-
|
|
4110
|
-
/**
|
|
4111
|
-
|
|
4112
|
-
}
|
|
4113
|
-
interface BulkMarkOrdersAsPaidRequest {
|
|
4056
|
+
orderId?: string;
|
|
4057
|
+
/** Refund amount */
|
|
4058
|
+
refundAmount?: Price;
|
|
4059
|
+
/** Refund business details */
|
|
4060
|
+
details?: RefundDetails;
|
|
4114
4061
|
/**
|
|
4115
|
-
*
|
|
4116
|
-
* @minSize 1
|
|
4117
|
-
* @maxSize 100
|
|
4062
|
+
* Personal note added to the email (optional)
|
|
4118
4063
|
* @minLength 1
|
|
4119
|
-
* @maxLength
|
|
4064
|
+
* @maxLength 1000
|
|
4120
4065
|
*/
|
|
4121
|
-
|
|
4122
|
-
}
|
|
4123
|
-
interface BulkMarkOrdersAsPaidResponse {
|
|
4066
|
+
customMessage?: string | null;
|
|
4124
4067
|
/**
|
|
4125
|
-
*
|
|
4126
|
-
*
|
|
4068
|
+
* Refund ID. (Optional)
|
|
4069
|
+
* @format GUID
|
|
4127
4070
|
*/
|
|
4128
|
-
|
|
4129
|
-
/** Bulk action metadata. */
|
|
4130
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
4131
|
-
}
|
|
4132
|
-
interface BulkOrderResult {
|
|
4133
|
-
/** Item metadata. */
|
|
4134
|
-
itemMetadata?: ItemMetadata;
|
|
4135
|
-
/**
|
|
4136
|
-
* Updated order.
|
|
4137
|
-
*
|
|
4138
|
-
* Returned when `returnFullEntity = true`.
|
|
4139
|
-
*/
|
|
4140
|
-
item?: Order;
|
|
4141
|
-
}
|
|
4142
|
-
interface ItemMetadata {
|
|
4143
|
-
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
4144
|
-
id?: string | null;
|
|
4145
|
-
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
4146
|
-
originalIndex?: number;
|
|
4147
|
-
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
4148
|
-
success?: boolean;
|
|
4149
|
-
/** Details about the error in case of failure. */
|
|
4150
|
-
error?: ApplicationError;
|
|
4151
|
-
}
|
|
4152
|
-
interface ApplicationError {
|
|
4153
|
-
/** Error code. */
|
|
4154
|
-
code?: string;
|
|
4155
|
-
/** Description of the error. */
|
|
4156
|
-
description?: string;
|
|
4157
|
-
/** Data related to the error. */
|
|
4158
|
-
data?: Record<string, any> | null;
|
|
4159
|
-
}
|
|
4160
|
-
interface BulkActionMetadata {
|
|
4161
|
-
/** Number of items that were successfully processed. */
|
|
4162
|
-
totalSuccesses?: number;
|
|
4163
|
-
/** Number of items that couldn't be processed. */
|
|
4164
|
-
totalFailures?: number;
|
|
4165
|
-
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
4166
|
-
undetailedFailures?: number;
|
|
4167
|
-
}
|
|
4168
|
-
interface GetRefundabilityStatusRequest {
|
|
4169
|
-
/**
|
|
4170
|
-
* Order ID.
|
|
4171
|
-
* @minLength 1
|
|
4172
|
-
* @maxLength 100
|
|
4173
|
-
*/
|
|
4174
|
-
ecomOrderId: string;
|
|
4175
|
-
}
|
|
4176
|
-
interface GetRefundabilityStatusResponse {
|
|
4177
|
-
/**
|
|
4178
|
-
* Refundability details.
|
|
4179
|
-
* @maxSize 300
|
|
4180
|
-
*/
|
|
4181
|
-
refundabilities?: Refundability[];
|
|
4182
|
-
/**
|
|
4183
|
-
* Whether the order supports refunding per item.
|
|
4184
|
-
* @deprecated
|
|
4185
|
-
*/
|
|
4186
|
-
refundablePerItem?: boolean;
|
|
4187
|
-
}
|
|
4188
|
-
interface Refundability extends RefundabilityAdditionalRefundabilityInfoOneOf {
|
|
4189
|
-
/** Reason why payment is not refundable. */
|
|
4190
|
-
nonRefundableReason?: NonRefundableReasonWithLiterals;
|
|
4191
|
-
/** Reason why payment is only refundable manually. */
|
|
4192
|
-
manuallyRefundableReason?: ManuallyRefundableReasonWithLiterals;
|
|
4193
|
-
/** Payment ID. */
|
|
4194
|
-
paymentId?: string;
|
|
4195
|
-
/** Payment refundability status. */
|
|
4196
|
-
refundabilityStatus?: RefundableStatusWithLiterals;
|
|
4197
|
-
/** Link to payment provider dashboard. */
|
|
4198
|
-
providerLink?: string | null;
|
|
4199
|
-
}
|
|
4200
|
-
/** @oneof */
|
|
4201
|
-
interface RefundabilityAdditionalRefundabilityInfoOneOf {
|
|
4202
|
-
/** Reason why payment is not refundable. */
|
|
4203
|
-
nonRefundableReason?: NonRefundableReasonWithLiterals;
|
|
4204
|
-
/** Reason why payment is only refundable manually. */
|
|
4205
|
-
manuallyRefundableReason?: ManuallyRefundableReasonWithLiterals;
|
|
4206
|
-
}
|
|
4207
|
-
declare enum RefundableStatus {
|
|
4208
|
-
NOT_REFUNDABLE = "NOT_REFUNDABLE",
|
|
4209
|
-
MANUAL = "MANUAL",
|
|
4210
|
-
REFUNDABLE = "REFUNDABLE"
|
|
4211
|
-
}
|
|
4212
|
-
/** @enumType */
|
|
4213
|
-
type RefundableStatusWithLiterals = RefundableStatus | 'NOT_REFUNDABLE' | 'MANUAL' | 'REFUNDABLE';
|
|
4214
|
-
declare enum NonRefundableReason {
|
|
4215
|
-
NONE = "NONE",
|
|
4216
|
-
ALREADY_REFUNDED = "ALREADY_REFUNDED",
|
|
4217
|
-
PROVIDER_IS_DOWN = "PROVIDER_IS_DOWN",
|
|
4218
|
-
INTERNAL_ERROR = "INTERNAL_ERROR",
|
|
4219
|
-
NOT_PAID = "NOT_PAID",
|
|
4220
|
-
ACCESS_DENIED = "ACCESS_DENIED",
|
|
4221
|
-
ZERO_PRICE = "ZERO_PRICE",
|
|
4222
|
-
DISABLED_BY_PROVIDER = "DISABLED_BY_PROVIDER",
|
|
4223
|
-
PENDING_REFUND = "PENDING_REFUND",
|
|
4224
|
-
FORBIDDEN = "FORBIDDEN",
|
|
4225
|
-
TRANSACTION_NOT_FOUND = "TRANSACTION_NOT_FOUND",
|
|
4226
|
-
ORDER_IS_PENDING = "ORDER_IS_PENDING",
|
|
4227
|
-
ORDER_IS_REJECTED = "ORDER_IS_REJECTED"
|
|
4228
|
-
}
|
|
4229
|
-
/** @enumType */
|
|
4230
|
-
type NonRefundableReasonWithLiterals = NonRefundableReason | 'NONE' | 'ALREADY_REFUNDED' | 'PROVIDER_IS_DOWN' | 'INTERNAL_ERROR' | 'NOT_PAID' | 'ACCESS_DENIED' | 'ZERO_PRICE' | 'DISABLED_BY_PROVIDER' | 'PENDING_REFUND' | 'FORBIDDEN' | 'TRANSACTION_NOT_FOUND' | 'ORDER_IS_PENDING' | 'ORDER_IS_REJECTED';
|
|
4231
|
-
declare enum ManuallyRefundableReason {
|
|
4232
|
-
EXPIRED = "EXPIRED",
|
|
4233
|
-
NOT_SUPPORTED = "NOT_SUPPORTED",
|
|
4234
|
-
OFFLINE = "OFFLINE",
|
|
4235
|
-
REQUIRES_CARD_READER = "REQUIRES_CARD_READER"
|
|
4236
|
-
}
|
|
4237
|
-
/** @enumType */
|
|
4238
|
-
type ManuallyRefundableReasonWithLiterals = ManuallyRefundableReason | 'EXPIRED' | 'NOT_SUPPORTED' | 'OFFLINE' | 'REQUIRES_CARD_READER';
|
|
4239
|
-
interface CreatePaymentGatewayOrderRequest {
|
|
4240
|
-
/**
|
|
4241
|
-
* Ecom order ID.
|
|
4242
|
-
* @minLength 1
|
|
4243
|
-
* @maxLength 100
|
|
4244
|
-
*/
|
|
4245
|
-
ecomOrderId: string;
|
|
4246
|
-
/** Information about the user who initiated the payment. */
|
|
4247
|
-
chargedBy?: ChargedBy;
|
|
4248
|
-
}
|
|
4249
|
-
interface ChargedBy {
|
|
4250
|
-
/**
|
|
4251
|
-
* ID - id of the user who initiated the payment
|
|
4252
|
-
* @format GUID
|
|
4253
|
-
*/
|
|
4254
|
-
id?: string;
|
|
4255
|
-
/**
|
|
4256
|
-
* Full name - name of the user who initiated the payment
|
|
4257
|
-
* @minLength 1
|
|
4258
|
-
* @maxLength 200
|
|
4259
|
-
*/
|
|
4260
|
-
fullName?: string | null;
|
|
4261
|
-
}
|
|
4262
|
-
interface CreatePaymentGatewayOrderResponse {
|
|
4263
|
-
/** ID of the order created in the payment gateway */
|
|
4264
|
-
paymentGatewayOrderId?: string;
|
|
4265
|
-
}
|
|
4266
|
-
interface ChargeMembershipsRequest {
|
|
4267
|
-
/**
|
|
4268
|
-
* Order ID.
|
|
4269
|
-
* @minLength 1
|
|
4270
|
-
* @maxLength 100
|
|
4271
|
-
*/
|
|
4272
|
-
ecomOrderId: string;
|
|
4273
|
-
/**
|
|
4274
|
-
* The member id. Do not attempt to get it from the request context, since in some cases the caller is not a member
|
|
4275
|
-
* but a user which is using the membership on behalf of the a member
|
|
4276
|
-
* @format GUID
|
|
4277
|
-
*/
|
|
4278
|
-
memberId: string;
|
|
4279
|
-
/**
|
|
4280
|
-
* List of items to be paid by memberships
|
|
4281
|
-
* @minSize 1
|
|
4282
|
-
* @maxSize 300
|
|
4283
|
-
*/
|
|
4284
|
-
membershipCharges?: MembershipChargeItem[];
|
|
4285
|
-
}
|
|
4286
|
-
interface MembershipChargeItem {
|
|
4287
|
-
/**
|
|
4288
|
-
* The id of used membership
|
|
4289
|
-
* @minLength 1
|
|
4290
|
-
* @maxLength 100
|
|
4291
|
-
*/
|
|
4292
|
-
membershipId?: string;
|
|
4293
|
-
/**
|
|
4294
|
-
* ID of the application providing this payment option
|
|
4295
|
-
* @format GUID
|
|
4296
|
-
*/
|
|
4297
|
-
appId?: string;
|
|
4298
|
-
/** The name of used membership */
|
|
4299
|
-
membershipName?: MembershipName;
|
|
4300
|
-
/** Additional data about this membership */
|
|
4301
|
-
membershipAdditionalData?: Record<string, any> | null;
|
|
4302
|
-
/** Catalog and item reference info. */
|
|
4303
|
-
catalogReference?: CatalogReference;
|
|
4304
|
-
/** Properties of the service. When relevant, contains information such as date and number of participants. */
|
|
4305
|
-
serviceProperties?: ServiceProperties;
|
|
4306
|
-
/**
|
|
4307
|
-
* Usually would be the same as catalogReference.catalogItemId
|
|
4308
|
-
* For cases when these are not the same, this field would return the actual id of the item in the catalog
|
|
4309
|
-
* For example, for Wix bookings, catalogReference.catalogItemId is the booking id, and this value is being set to be the service id
|
|
4310
|
-
* @minLength 1
|
|
4311
|
-
* @maxLength 36
|
|
4312
|
-
*/
|
|
4313
|
-
rootCatalogItemId?: string | null;
|
|
4314
|
-
/**
|
|
4315
|
-
* line item id of Checkout/Order line item
|
|
4316
|
-
* @minLength 1
|
|
4317
|
-
* @maxLength 100
|
|
4318
|
-
*/
|
|
4319
|
-
lineItemId?: string;
|
|
4320
|
-
}
|
|
4321
|
-
interface MembershipName {
|
|
4322
|
-
/**
|
|
4323
|
-
* Membership name.
|
|
4324
|
-
* @maxLength 100
|
|
4325
|
-
*/
|
|
4326
|
-
original?: string;
|
|
4327
|
-
/**
|
|
4328
|
-
* Translated membership name. Defaults to `original` when not provided.
|
|
4329
|
-
* @maxLength 100
|
|
4330
|
-
*/
|
|
4331
|
-
translated?: string | null;
|
|
4332
|
-
}
|
|
4333
|
-
interface ChargeMembershipsResponse {
|
|
4334
|
-
}
|
|
4335
|
-
interface TriggerRefundRequest {
|
|
4336
|
-
/**
|
|
4337
|
-
* The order this refund related to
|
|
4338
|
-
* @minLength 1
|
|
4339
|
-
* @maxLength 100
|
|
4340
|
-
*/
|
|
4341
|
-
ecomOrderId: string;
|
|
4342
|
-
/**
|
|
4343
|
-
* Refund operations information
|
|
4344
|
-
* @minSize 1
|
|
4345
|
-
* @maxSize 1
|
|
4346
|
-
*/
|
|
4347
|
-
payments: PaymentRefund[];
|
|
4348
|
-
/** Business model of a refund */
|
|
4349
|
-
details?: RefundDetails;
|
|
4350
|
-
/** Side effect details related to refund */
|
|
4351
|
-
sideEffects?: RefundSideEffects;
|
|
4352
|
-
}
|
|
4353
|
-
interface PaymentRefund {
|
|
4354
|
-
/**
|
|
4355
|
-
* Specific payment within the order to refund
|
|
4356
|
-
* @format GUID
|
|
4357
|
-
*/
|
|
4358
|
-
paymentId?: string;
|
|
4359
|
-
/** Refund amount. Not relevant for membership and gift card refunds. */
|
|
4360
|
-
amount?: Price;
|
|
4361
|
-
/**
|
|
4362
|
-
* Whether refund is made externally and manually (on the payment provider's side)
|
|
4363
|
-
* 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.
|
|
4364
|
-
* When true, the payment will only be *marked* as refunded, and no actual refund will be performed.
|
|
4365
|
-
*/
|
|
4366
|
-
externalRefund?: boolean;
|
|
4071
|
+
refundId?: string | null;
|
|
4367
4072
|
}
|
|
4368
4073
|
/** Business model of a refund request */
|
|
4369
4074
|
interface RefundDetails {
|
|
@@ -4440,1643 +4145,1938 @@ interface ShippingRefund {
|
|
|
4440
4145
|
*/
|
|
4441
4146
|
amount?: Price;
|
|
4442
4147
|
}
|
|
4443
|
-
interface
|
|
4444
|
-
|
|
4445
|
-
|
|
4446
|
-
|
|
4447
|
-
sendOrderRefundedEmail?: boolean;
|
|
4148
|
+
interface PreviewRefundEmailResponse {
|
|
4149
|
+
emailPreview?: string;
|
|
4150
|
+
}
|
|
4151
|
+
interface PreviewCancelEmailRequest {
|
|
4448
4152
|
/**
|
|
4449
|
-
*
|
|
4153
|
+
* @minLength 1
|
|
4154
|
+
* @maxLength 100
|
|
4155
|
+
*/
|
|
4156
|
+
orderId?: string;
|
|
4157
|
+
/**
|
|
4158
|
+
* Personal note added to the email (optional)
|
|
4450
4159
|
* @minLength 1
|
|
4451
4160
|
* @maxLength 1000
|
|
4452
4161
|
*/
|
|
4453
4162
|
customMessage?: string | null;
|
|
4454
4163
|
}
|
|
4455
|
-
interface
|
|
4456
|
-
|
|
4457
|
-
|
|
4164
|
+
interface PreviewCancelEmailResponse {
|
|
4165
|
+
emailPreview?: string;
|
|
4166
|
+
}
|
|
4167
|
+
interface PreviewCancelRefundEmailRequest {
|
|
4458
4168
|
/**
|
|
4459
|
-
*
|
|
4460
|
-
* @
|
|
4169
|
+
* @minLength 1
|
|
4170
|
+
* @maxLength 100
|
|
4461
4171
|
*/
|
|
4462
|
-
|
|
4172
|
+
orderId?: string;
|
|
4173
|
+
/**
|
|
4174
|
+
* Personal note added to the email (optional)
|
|
4175
|
+
* @minLength 1
|
|
4176
|
+
* @maxLength 1000
|
|
4177
|
+
*/
|
|
4178
|
+
customMessage?: string | null;
|
|
4179
|
+
/** Refund amount */
|
|
4180
|
+
refundAmount?: Price;
|
|
4181
|
+
/**
|
|
4182
|
+
* Refund ID. (Optional)
|
|
4183
|
+
* @format GUID
|
|
4184
|
+
*/
|
|
4185
|
+
refundId?: string | null;
|
|
4463
4186
|
}
|
|
4464
|
-
|
|
4465
|
-
|
|
4466
|
-
ALL_ITEMS = "ALL_ITEMS",
|
|
4467
|
-
SOME_ITEMS = "SOME_ITEMS"
|
|
4187
|
+
interface PreviewCancelRefundEmailResponse {
|
|
4188
|
+
emailPreview?: string;
|
|
4468
4189
|
}
|
|
4469
|
-
|
|
4470
|
-
|
|
4471
|
-
interface
|
|
4190
|
+
interface PreviewBuyerPaymentsReceivedEmailRequest {
|
|
4191
|
+
}
|
|
4192
|
+
interface PreviewBuyerPaymentsReceivedEmailResponse {
|
|
4193
|
+
emailPreview?: string;
|
|
4194
|
+
}
|
|
4195
|
+
interface PreviewBuyerConfirmationEmailRequest {
|
|
4196
|
+
}
|
|
4197
|
+
interface PreviewBuyerConfirmationEmailResponse {
|
|
4198
|
+
emailPreview?: string;
|
|
4199
|
+
}
|
|
4200
|
+
interface PreviewBuyerPickupConfirmationEmailRequest {
|
|
4201
|
+
}
|
|
4202
|
+
interface PreviewBuyerPickupConfirmationEmailResponse {
|
|
4203
|
+
emailPreview?: string;
|
|
4204
|
+
}
|
|
4205
|
+
interface PreviewShippingConfirmationEmailRequest {
|
|
4206
|
+
}
|
|
4207
|
+
interface PreviewShippingConfirmationEmailResponse {
|
|
4208
|
+
emailPreview?: string;
|
|
4209
|
+
}
|
|
4210
|
+
interface PreviewResendDownloadLinksEmailRequest {
|
|
4211
|
+
}
|
|
4212
|
+
interface PreviewResendDownloadLinksEmailResponse {
|
|
4213
|
+
emailPreview?: string;
|
|
4214
|
+
}
|
|
4215
|
+
interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {
|
|
4216
|
+
/** Emitted on a meta site creation. */
|
|
4217
|
+
siteCreated?: SiteCreated;
|
|
4218
|
+
/** Emitted on a meta site transfer completion. */
|
|
4219
|
+
siteTransferred?: SiteTransferred;
|
|
4220
|
+
/** Emitted on a meta site deletion. */
|
|
4221
|
+
siteDeleted?: SiteDeleted;
|
|
4222
|
+
/** Emitted on a meta site restoration. */
|
|
4223
|
+
siteUndeleted?: SiteUndeleted;
|
|
4224
|
+
/** Emitted on the first* publish of the meta site (* switching from unpublished to published state). */
|
|
4225
|
+
sitePublished?: SitePublished;
|
|
4226
|
+
/** Emitted on a meta site unpublish. */
|
|
4227
|
+
siteUnpublished?: SiteUnpublished;
|
|
4228
|
+
/** Emitted when meta site is marked as template. */
|
|
4229
|
+
siteMarkedAsTemplate?: SiteMarkedAsTemplate;
|
|
4230
|
+
/** Emitted when meta site is marked as a WixSite. */
|
|
4231
|
+
siteMarkedAsWixSite?: SiteMarkedAsWixSite;
|
|
4232
|
+
/** Emitted when an application is provisioned (installed). */
|
|
4233
|
+
serviceProvisioned?: ServiceProvisioned;
|
|
4234
|
+
/** Emitted when an application is removed (uninstalled). */
|
|
4235
|
+
serviceRemoved?: ServiceRemoved;
|
|
4236
|
+
/** Emitted when meta site name (URL slug) is changed. */
|
|
4237
|
+
siteRenamedPayload?: SiteRenamed;
|
|
4238
|
+
/** Emitted when meta site was permanently deleted. */
|
|
4239
|
+
hardDeleted?: SiteHardDeleted;
|
|
4240
|
+
/** Emitted on a namespace change. */
|
|
4241
|
+
namespaceChanged?: NamespaceChanged;
|
|
4242
|
+
/** Emitted when Studio is attached. */
|
|
4243
|
+
studioAssigned?: StudioAssigned;
|
|
4244
|
+
/** Emitted when Studio is detached. */
|
|
4245
|
+
studioUnassigned?: StudioUnassigned;
|
|
4472
4246
|
/**
|
|
4473
|
-
*
|
|
4247
|
+
* Emitted when one of the URLs is changed. After this event you may call `urls-server` to fetch
|
|
4248
|
+
* the actual URL.
|
|
4249
|
+
*
|
|
4250
|
+
* See: https://wix.slack.com/archives/C0UHEBPFT/p1732520791210559?thread_ts=1732027914.294059&cid=C0UHEBPFT
|
|
4251
|
+
* See: https://wix.slack.com/archives/C0UHEBPFT/p1744115197619459
|
|
4252
|
+
*/
|
|
4253
|
+
urlChanged?: SiteUrlChanged;
|
|
4254
|
+
/** Site is marked as PurgedExternally */
|
|
4255
|
+
sitePurgedExternally?: SitePurgedExternally;
|
|
4256
|
+
/** Emitted when Odeditor is attached. */
|
|
4257
|
+
odeditorAssigned?: OdeditorAssigned;
|
|
4258
|
+
/** Emitted when Odeditor is detached. */
|
|
4259
|
+
odeditorUnassigned?: OdeditorUnassigned;
|
|
4260
|
+
/** Emitted when Picasso is attached. */
|
|
4261
|
+
picassoAssigned?: PicassoAssigned;
|
|
4262
|
+
/** Emitted when Picasso is detached. */
|
|
4263
|
+
picassoUnassigned?: PicassoUnassigned;
|
|
4264
|
+
/** Emitted when Wixel is attached. */
|
|
4265
|
+
wixelAssigned?: WixelAssigned;
|
|
4266
|
+
/** Emitted when Wixel is detached. */
|
|
4267
|
+
wixelUnassigned?: WixelUnassigned;
|
|
4268
|
+
/** Emitted when StudioTwo is attached. */
|
|
4269
|
+
studioTwoAssigned?: StudioTwoAssigned;
|
|
4270
|
+
/** Emitted when StudioTwo is detached. */
|
|
4271
|
+
studioTwoUnassigned?: StudioTwoUnassigned;
|
|
4272
|
+
/** Emitted when media from user domain is enabled. */
|
|
4273
|
+
userDomainMediaEnabled?: UserDomainMediaEnabled;
|
|
4274
|
+
/** Emitted when media from user domain is disabled. */
|
|
4275
|
+
userDomainMediaDisabled?: UserDomainMediaDisabled;
|
|
4276
|
+
/** Emitted when Editorless is attached. */
|
|
4277
|
+
editorlessAssigned?: EditorlessAssigned;
|
|
4278
|
+
/** Emitted when Editorless is detached. */
|
|
4279
|
+
editorlessUnassigned?: EditorlessUnassigned;
|
|
4280
|
+
/**
|
|
4281
|
+
* A meta site id.
|
|
4474
4282
|
* @format GUID
|
|
4475
4283
|
*/
|
|
4476
|
-
|
|
4284
|
+
metaSiteId?: string;
|
|
4285
|
+
/** A meta site version. Monotonically increasing. */
|
|
4286
|
+
version?: string;
|
|
4287
|
+
/** A timestamp of the event. */
|
|
4288
|
+
timestamp?: string;
|
|
4477
4289
|
/**
|
|
4478
|
-
*
|
|
4479
|
-
*
|
|
4480
|
-
* @
|
|
4290
|
+
* TODO(meta-site): Change validation once validations are disabled for consumers
|
|
4291
|
+
* More context: https://wix.slack.com/archives/C0UHEBPFT/p1720957844413149 and https://wix.slack.com/archives/CFWKX325T/p1728892152855659
|
|
4292
|
+
* @maxSize 4000
|
|
4481
4293
|
*/
|
|
4482
|
-
|
|
4483
|
-
}
|
|
4484
|
-
interface TriggerRefundResponse {
|
|
4485
|
-
/** All order's transactions after the refunds were added */
|
|
4486
|
-
orderTransactions?: OrderTransactions;
|
|
4487
|
-
/** Created refund ID */
|
|
4488
|
-
refundId?: string | null;
|
|
4489
|
-
/** Payment ID's that the refund execution had failed for */
|
|
4490
|
-
failedPaymentIds?: ItemMetadata[];
|
|
4294
|
+
assets?: Asset[];
|
|
4491
4295
|
}
|
|
4492
|
-
/**
|
|
4493
|
-
|
|
4494
|
-
|
|
4495
|
-
|
|
4496
|
-
*/
|
|
4497
|
-
|
|
4296
|
+
/** @oneof */
|
|
4297
|
+
interface MetaSiteSpecialEventPayloadOneOf {
|
|
4298
|
+
/** Emitted on a meta site creation. */
|
|
4299
|
+
siteCreated?: SiteCreated;
|
|
4300
|
+
/** Emitted on a meta site transfer completion. */
|
|
4301
|
+
siteTransferred?: SiteTransferred;
|
|
4302
|
+
/** Emitted on a meta site deletion. */
|
|
4303
|
+
siteDeleted?: SiteDeleted;
|
|
4304
|
+
/** Emitted on a meta site restoration. */
|
|
4305
|
+
siteUndeleted?: SiteUndeleted;
|
|
4306
|
+
/** Emitted on the first* publish of the meta site (* switching from unpublished to published state). */
|
|
4307
|
+
sitePublished?: SitePublished;
|
|
4308
|
+
/** Emitted on a meta site unpublish. */
|
|
4309
|
+
siteUnpublished?: SiteUnpublished;
|
|
4310
|
+
/** Emitted when meta site is marked as template. */
|
|
4311
|
+
siteMarkedAsTemplate?: SiteMarkedAsTemplate;
|
|
4312
|
+
/** Emitted when meta site is marked as a WixSite. */
|
|
4313
|
+
siteMarkedAsWixSite?: SiteMarkedAsWixSite;
|
|
4314
|
+
/** Emitted when an application is provisioned (installed). */
|
|
4315
|
+
serviceProvisioned?: ServiceProvisioned;
|
|
4316
|
+
/** Emitted when an application is removed (uninstalled). */
|
|
4317
|
+
serviceRemoved?: ServiceRemoved;
|
|
4318
|
+
/** Emitted when meta site name (URL slug) is changed. */
|
|
4319
|
+
siteRenamedPayload?: SiteRenamed;
|
|
4320
|
+
/** Emitted when meta site was permanently deleted. */
|
|
4321
|
+
hardDeleted?: SiteHardDeleted;
|
|
4322
|
+
/** Emitted on a namespace change. */
|
|
4323
|
+
namespaceChanged?: NamespaceChanged;
|
|
4324
|
+
/** Emitted when Studio is attached. */
|
|
4325
|
+
studioAssigned?: StudioAssigned;
|
|
4326
|
+
/** Emitted when Studio is detached. */
|
|
4327
|
+
studioUnassigned?: StudioUnassigned;
|
|
4498
4328
|
/**
|
|
4499
|
-
*
|
|
4500
|
-
*
|
|
4329
|
+
* Emitted when one of the URLs is changed. After this event you may call `urls-server` to fetch
|
|
4330
|
+
* the actual URL.
|
|
4331
|
+
*
|
|
4332
|
+
* See: https://wix.slack.com/archives/C0UHEBPFT/p1732520791210559?thread_ts=1732027914.294059&cid=C0UHEBPFT
|
|
4333
|
+
* See: https://wix.slack.com/archives/C0UHEBPFT/p1744115197619459
|
|
4501
4334
|
*/
|
|
4502
|
-
|
|
4335
|
+
urlChanged?: SiteUrlChanged;
|
|
4336
|
+
/** Site is marked as PurgedExternally */
|
|
4337
|
+
sitePurgedExternally?: SitePurgedExternally;
|
|
4338
|
+
/** Emitted when Odeditor is attached. */
|
|
4339
|
+
odeditorAssigned?: OdeditorAssigned;
|
|
4340
|
+
/** Emitted when Odeditor is detached. */
|
|
4341
|
+
odeditorUnassigned?: OdeditorUnassigned;
|
|
4342
|
+
/** Emitted when Picasso is attached. */
|
|
4343
|
+
picassoAssigned?: PicassoAssigned;
|
|
4344
|
+
/** Emitted when Picasso is detached. */
|
|
4345
|
+
picassoUnassigned?: PicassoUnassigned;
|
|
4346
|
+
/** Emitted when Wixel is attached. */
|
|
4347
|
+
wixelAssigned?: WixelAssigned;
|
|
4348
|
+
/** Emitted when Wixel is detached. */
|
|
4349
|
+
wixelUnassigned?: WixelUnassigned;
|
|
4350
|
+
/** Emitted when StudioTwo is attached. */
|
|
4351
|
+
studioTwoAssigned?: StudioTwoAssigned;
|
|
4352
|
+
/** Emitted when StudioTwo is detached. */
|
|
4353
|
+
studioTwoUnassigned?: StudioTwoUnassigned;
|
|
4354
|
+
/** Emitted when media from user domain is enabled. */
|
|
4355
|
+
userDomainMediaEnabled?: UserDomainMediaEnabled;
|
|
4356
|
+
/** Emitted when media from user domain is disabled. */
|
|
4357
|
+
userDomainMediaDisabled?: UserDomainMediaDisabled;
|
|
4358
|
+
/** Emitted when Editorless is attached. */
|
|
4359
|
+
editorlessAssigned?: EditorlessAssigned;
|
|
4360
|
+
/** Emitted when Editorless is detached. */
|
|
4361
|
+
editorlessUnassigned?: EditorlessUnassigned;
|
|
4362
|
+
}
|
|
4363
|
+
interface Asset {
|
|
4503
4364
|
/**
|
|
4504
|
-
*
|
|
4505
|
-
* @
|
|
4365
|
+
* An application definition id (app_id in dev-center). For legacy reasons may be UUID or a string (from Java Enum).
|
|
4366
|
+
* @maxLength 36
|
|
4506
4367
|
*/
|
|
4507
|
-
|
|
4368
|
+
appDefId?: string;
|
|
4508
4369
|
/**
|
|
4509
|
-
*
|
|
4510
|
-
* @
|
|
4370
|
+
* An instance id. For legacy reasons may be UUID or a string.
|
|
4371
|
+
* @maxLength 200
|
|
4511
4372
|
*/
|
|
4512
|
-
|
|
4373
|
+
instanceId?: string;
|
|
4374
|
+
/** An application state. */
|
|
4375
|
+
state?: StateWithLiterals;
|
|
4513
4376
|
}
|
|
4514
|
-
|
|
4515
|
-
|
|
4516
|
-
|
|
4517
|
-
|
|
4518
|
-
|
|
4519
|
-
|
|
4520
|
-
|
|
4377
|
+
declare enum State {
|
|
4378
|
+
UNKNOWN = "UNKNOWN",
|
|
4379
|
+
ENABLED = "ENABLED",
|
|
4380
|
+
DISABLED = "DISABLED",
|
|
4381
|
+
PENDING = "PENDING",
|
|
4382
|
+
DEMO = "DEMO"
|
|
4383
|
+
}
|
|
4384
|
+
/** @enumType */
|
|
4385
|
+
type StateWithLiterals = State | 'UNKNOWN' | 'ENABLED' | 'DISABLED' | 'PENDING' | 'DEMO';
|
|
4386
|
+
interface SiteCreated {
|
|
4521
4387
|
/**
|
|
4522
|
-
*
|
|
4388
|
+
* A template identifier (empty if not created from a template).
|
|
4389
|
+
* @maxLength 36
|
|
4390
|
+
*/
|
|
4391
|
+
originTemplateId?: string;
|
|
4392
|
+
/**
|
|
4393
|
+
* An account id of the owner.
|
|
4523
4394
|
* @format GUID
|
|
4524
|
-
* @readonly
|
|
4525
4395
|
*/
|
|
4526
|
-
|
|
4527
|
-
/**
|
|
4528
|
-
|
|
4396
|
+
ownerId?: string;
|
|
4397
|
+
/** A context in which meta site was created. */
|
|
4398
|
+
context?: SiteCreatedContextWithLiterals;
|
|
4529
4399
|
/**
|
|
4530
|
-
*
|
|
4531
|
-
*
|
|
4400
|
+
* A meta site id from which this site was created.
|
|
4401
|
+
*
|
|
4402
|
+
* In case of a creation from a template it's a template id.
|
|
4403
|
+
* In case of a site duplication ("Save As" in dashboard or duplicate in UM) it's an id of a source site.
|
|
4404
|
+
* @format GUID
|
|
4532
4405
|
*/
|
|
4533
|
-
|
|
4534
|
-
/** Payment amount. */
|
|
4535
|
-
amount?: Price;
|
|
4406
|
+
originMetaSiteId?: string | null;
|
|
4536
4407
|
/**
|
|
4537
|
-
*
|
|
4538
|
-
*
|
|
4539
|
-
* + `false`: This payment may be refunded. However, this ultimately depends on the payment provider.
|
|
4408
|
+
* A meta site name (URL slug).
|
|
4409
|
+
* @maxLength 20
|
|
4540
4410
|
*/
|
|
4541
|
-
|
|
4411
|
+
siteName?: string;
|
|
4412
|
+
/** A namespace. */
|
|
4413
|
+
namespace?: NamespaceWithLiterals;
|
|
4414
|
+
}
|
|
4415
|
+
declare enum SiteCreatedContext {
|
|
4416
|
+
/** A valid option, we don't expose all reasons why site might be created. */
|
|
4417
|
+
OTHER = "OTHER",
|
|
4418
|
+
/** A meta site was created from template. */
|
|
4419
|
+
FROM_TEMPLATE = "FROM_TEMPLATE",
|
|
4420
|
+
/** A meta site was created by copying of the transfferred meta site. */
|
|
4421
|
+
DUPLICATE_BY_SITE_TRANSFER = "DUPLICATE_BY_SITE_TRANSFER",
|
|
4422
|
+
/** A copy of existing meta site. */
|
|
4423
|
+
DUPLICATE = "DUPLICATE",
|
|
4424
|
+
/** A meta site was created as a transfferred site (copy of the original), old flow, should die soon. */
|
|
4425
|
+
OLD_SITE_TRANSFER = "OLD_SITE_TRANSFER",
|
|
4426
|
+
/** deprecated A meta site was created for Flash editor. */
|
|
4427
|
+
FLASH = "FLASH"
|
|
4428
|
+
}
|
|
4429
|
+
/** @enumType */
|
|
4430
|
+
type SiteCreatedContextWithLiterals = SiteCreatedContext | 'OTHER' | 'FROM_TEMPLATE' | 'DUPLICATE_BY_SITE_TRANSFER' | 'DUPLICATE' | 'OLD_SITE_TRANSFER' | 'FLASH';
|
|
4431
|
+
declare enum Namespace {
|
|
4432
|
+
UNKNOWN_NAMESPACE = "UNKNOWN_NAMESPACE",
|
|
4433
|
+
/** Default namespace for UGC sites. MetaSites with this namespace will be shown in a user's site list by default. */
|
|
4434
|
+
WIX = "WIX",
|
|
4435
|
+
/** 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. */
|
|
4436
|
+
SHOUT_OUT = "SHOUT_OUT",
|
|
4437
|
+
/** 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. */
|
|
4438
|
+
ALBUMS = "ALBUMS",
|
|
4439
|
+
/** 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. */
|
|
4440
|
+
WIX_STORES_TEST_DRIVE = "WIX_STORES_TEST_DRIVE",
|
|
4441
|
+
/** Hotels standalone (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4442
|
+
HOTELS = "HOTELS",
|
|
4443
|
+
/** 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. */
|
|
4444
|
+
CLUBS = "CLUBS",
|
|
4445
|
+
/** A partially created ADI website. MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4446
|
+
ONBOARDING_DRAFT = "ONBOARDING_DRAFT",
|
|
4542
4447
|
/**
|
|
4543
|
-
*
|
|
4544
|
-
*
|
|
4545
|
-
* + `false`: This payment doesn't support receipt generation, or a receipt was already generated.
|
|
4546
|
-
* @readonly
|
|
4448
|
+
* AppBuilder for AppStudio / shmite (c). MetaSites with this namespace will *not* be shown in a user's site list by default.
|
|
4449
|
+
* Not the dev-center dev site (see Flag.DEV_CENTER_DEV_SITE_FLAG).
|
|
4547
4450
|
*/
|
|
4548
|
-
|
|
4549
|
-
/**
|
|
4550
|
-
|
|
4451
|
+
DEV_SITE = "DEV_SITE",
|
|
4452
|
+
/** 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. */
|
|
4453
|
+
LOGOS = "LOGOS",
|
|
4454
|
+
/** 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. */
|
|
4455
|
+
VIDEO_MAKER = "VIDEO_MAKER",
|
|
4456
|
+
/** MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4457
|
+
PARTNER_DASHBOARD = "PARTNER_DASHBOARD",
|
|
4458
|
+
/** MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4459
|
+
DEV_CENTER_COMPANY = "DEV_CENTER_COMPANY",
|
|
4551
4460
|
/**
|
|
4552
|
-
*
|
|
4461
|
+
* A draft created by HTML editor on open. Upon "first save" it will be moved to be of WIX domain.
|
|
4553
4462
|
*
|
|
4554
|
-
*
|
|
4463
|
+
* Meta site with this namespace will *not* be shown in a user's site list by default.
|
|
4555
4464
|
*/
|
|
4556
|
-
|
|
4465
|
+
HTML_DRAFT = "HTML_DRAFT",
|
|
4557
4466
|
/**
|
|
4558
|
-
*
|
|
4467
|
+
* the user-journey for Fitness users who want to start from managing their business instead of designing their website.
|
|
4468
|
+
* Will be accessible from Site List and will not have a website app.
|
|
4469
|
+
* Once the user attaches a site, the site will become a regular wixsite.
|
|
4470
|
+
*/
|
|
4471
|
+
SITELESS_BUSINESS = "SITELESS_BUSINESS",
|
|
4472
|
+
/** Belongs to "strategic products" company. Supports new product in the creator's economy space. */
|
|
4473
|
+
CREATOR_ECONOMY = "CREATOR_ECONOMY",
|
|
4474
|
+
/** It is to be used in the Business First efforts. */
|
|
4475
|
+
DASHBOARD_FIRST = "DASHBOARD_FIRST",
|
|
4476
|
+
/** Bookings business flow with no site. */
|
|
4477
|
+
ANYWHERE = "ANYWHERE",
|
|
4478
|
+
/** Namespace for Headless Backoffice with no editor */
|
|
4479
|
+
HEADLESS = "HEADLESS",
|
|
4480
|
+
/**
|
|
4481
|
+
* Namespace for master site that will exist in parent account that will be referenced by subaccounts
|
|
4482
|
+
* The site will be used for account level CSM feature for enterprise
|
|
4483
|
+
*/
|
|
4484
|
+
ACCOUNT_MASTER_CMS = "ACCOUNT_MASTER_CMS",
|
|
4485
|
+
/** Rise.ai Siteless account management for Gift Cards and Store Credit. */
|
|
4486
|
+
RISE = "RISE",
|
|
4487
|
+
/**
|
|
4488
|
+
* As part of the branded app new funnel, users now can create a meta site that will be branded app first.
|
|
4489
|
+
* There's a blank site behind the scene but it's blank).
|
|
4490
|
+
* The Mobile company will be the owner of this namespace.
|
|
4491
|
+
*/
|
|
4492
|
+
BRANDED_FIRST = "BRANDED_FIRST",
|
|
4493
|
+
/** Nownia.com Siteless account management for Ai Scheduling Assistant. */
|
|
4494
|
+
NOWNIA = "NOWNIA",
|
|
4495
|
+
/**
|
|
4496
|
+
* UGC Templates are templates that are created by users for personal use and to sale to other users.
|
|
4497
|
+
* The Partners company owns this namespace.
|
|
4498
|
+
*/
|
|
4499
|
+
UGC_TEMPLATE = "UGC_TEMPLATE",
|
|
4500
|
+
/** Codux Headless Sites */
|
|
4501
|
+
CODUX = "CODUX",
|
|
4502
|
+
/** Bobb - AI Design Creator. */
|
|
4503
|
+
MEDIA_DESIGN_CREATOR = "MEDIA_DESIGN_CREATOR",
|
|
4504
|
+
/**
|
|
4505
|
+
* Shared Blog Site is a unique single site across Enterprise account,
|
|
4506
|
+
* This site will hold all Blog posts related to the Marketing product.
|
|
4507
|
+
*/
|
|
4508
|
+
SHARED_BLOG_ENTERPRISE = "SHARED_BLOG_ENTERPRISE",
|
|
4509
|
+
/** Standalone forms (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4510
|
+
STANDALONE_FORMS = "STANDALONE_FORMS",
|
|
4511
|
+
/** Standalone events (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
4512
|
+
STANDALONE_EVENTS = "STANDALONE_EVENTS",
|
|
4513
|
+
/** MIMIR - Siteless account for MIMIR Ai Job runner. */
|
|
4514
|
+
MIMIR = "MIMIR",
|
|
4515
|
+
/** Wix Twins platform. */
|
|
4516
|
+
TWINS = "TWINS",
|
|
4517
|
+
/** Wix Nano. */
|
|
4518
|
+
NANO = "NANO",
|
|
4519
|
+
/** Base44 headless sites. */
|
|
4520
|
+
BASE44 = "BASE44",
|
|
4521
|
+
/** Wix Channels Sites */
|
|
4522
|
+
CHANNELS = "CHANNELS",
|
|
4523
|
+
/** Nautilus platform. */
|
|
4524
|
+
NAUTILUS = "NAUTILUS",
|
|
4525
|
+
/**
|
|
4526
|
+
* Symphony — a siteless site representing a project within Symphony (the evolution of Orion).
|
|
4527
|
+
* Holds project data, conversations, assets, and manages collaborators / shared team members for the project.
|
|
4528
|
+
*/
|
|
4529
|
+
SYMPHONY = "SYMPHONY",
|
|
4530
|
+
/** Nautilus platform app. */
|
|
4531
|
+
NAUTILUS_APPS = "NAUTILUS_APPS",
|
|
4532
|
+
/**
|
|
4533
|
+
* Vibu — a siteless site representing a project built with Vibu (the AI app builder).
|
|
4534
|
+
* Holds the project's generated code, conversations, assets, and manages collaborators for the project.
|
|
4535
|
+
*/
|
|
4536
|
+
VIBU = "VIBU",
|
|
4537
|
+
/**
|
|
4538
|
+
* Ghost site for the BrandKit multi-site platform. Each ghost backs a single BrandKit
|
|
4539
|
+
* (an Enterprise account may have several), holding that BrandKit's brand definition
|
|
4540
|
+
* (theme, typography, assets) which is rolled out to the BrandKit's connected sites.
|
|
4541
|
+
* MetaSites with this namespace will *not* be shown in a user's site list by default.
|
|
4542
|
+
*/
|
|
4543
|
+
ENTERPRISE_BRAND_KIT = "ENTERPRISE_BRAND_KIT",
|
|
4544
|
+
/**
|
|
4545
|
+
* Dev-center development sites (com.wixpress.devcenter.dsm).
|
|
4546
|
+
* DEPRECATED: replaced by Flag.DEV_CENTER_DEV_SITE_FLAG (a dev site is orthogonal to the namespace). Do not use for new sites.
|
|
4547
|
+
*/
|
|
4548
|
+
DEV_CENTER_DEV_SITE = "DEV_CENTER_DEV_SITE"
|
|
4549
|
+
}
|
|
4550
|
+
/** @enumType */
|
|
4551
|
+
type NamespaceWithLiterals = Namespace | 'UNKNOWN_NAMESPACE' | 'WIX' | 'SHOUT_OUT' | 'ALBUMS' | 'WIX_STORES_TEST_DRIVE' | 'HOTELS' | 'CLUBS' | 'ONBOARDING_DRAFT' | 'DEV_SITE' | 'LOGOS' | 'VIDEO_MAKER' | 'PARTNER_DASHBOARD' | 'DEV_CENTER_COMPANY' | 'HTML_DRAFT' | 'SITELESS_BUSINESS' | 'CREATOR_ECONOMY' | 'DASHBOARD_FIRST' | 'ANYWHERE' | 'HEADLESS' | 'ACCOUNT_MASTER_CMS' | 'RISE' | 'BRANDED_FIRST' | 'NOWNIA' | 'UGC_TEMPLATE' | 'CODUX' | 'MEDIA_DESIGN_CREATOR' | 'SHARED_BLOG_ENTERPRISE' | 'STANDALONE_FORMS' | 'STANDALONE_EVENTS' | 'MIMIR' | 'TWINS' | 'NANO' | 'BASE44' | 'CHANNELS' | 'NAUTILUS' | 'SYMPHONY' | 'NAUTILUS_APPS' | 'VIBU' | 'ENTERPRISE_BRAND_KIT' | 'DEV_CENTER_DEV_SITE';
|
|
4552
|
+
/** Site transferred to another user. */
|
|
4553
|
+
interface SiteTransferred {
|
|
4554
|
+
/**
|
|
4555
|
+
* A previous owner id (user that transfers meta site).
|
|
4559
4556
|
* @format GUID
|
|
4560
4557
|
*/
|
|
4561
|
-
|
|
4558
|
+
oldOwnerId?: string;
|
|
4559
|
+
/**
|
|
4560
|
+
* A new owner id (user that accepts meta site).
|
|
4561
|
+
* @format GUID
|
|
4562
|
+
*/
|
|
4563
|
+
newOwnerId?: string;
|
|
4562
4564
|
}
|
|
4563
|
-
/**
|
|
4564
|
-
interface
|
|
4565
|
-
/**
|
|
4566
|
-
|
|
4567
|
-
/** Gift card payment details. */
|
|
4568
|
-
giftcardPaymentDetails?: GiftCardPaymentDetails;
|
|
4569
|
-
/** Membership payment details. */
|
|
4570
|
-
membershipPaymentDetails?: MembershipPaymentDetails;
|
|
4565
|
+
/** Soft deletion of the meta site. Could be restored. */
|
|
4566
|
+
interface SiteDeleted {
|
|
4567
|
+
/** A deletion context. */
|
|
4568
|
+
deleteContext?: DeleteContext;
|
|
4571
4569
|
}
|
|
4572
|
-
|
|
4573
|
-
|
|
4570
|
+
interface DeleteContext {
|
|
4571
|
+
/** When the meta site was deleted. */
|
|
4572
|
+
dateDeleted?: Date | null;
|
|
4573
|
+
/** A status. */
|
|
4574
|
+
deleteStatus?: DeleteStatusWithLiterals;
|
|
4575
|
+
/**
|
|
4576
|
+
* A reason (flow).
|
|
4577
|
+
* @maxLength 255
|
|
4578
|
+
*/
|
|
4579
|
+
deleteOrigin?: string;
|
|
4580
|
+
/**
|
|
4581
|
+
* A service that deleted it.
|
|
4582
|
+
* @maxLength 255
|
|
4583
|
+
*/
|
|
4584
|
+
initiatorId?: string | null;
|
|
4574
4585
|
}
|
|
4575
|
-
|
|
4576
|
-
|
|
4586
|
+
declare enum DeleteStatus {
|
|
4587
|
+
UNKNOWN = "UNKNOWN",
|
|
4588
|
+
TRASH = "TRASH",
|
|
4589
|
+
DELETED = "DELETED",
|
|
4590
|
+
PENDING_PURGE = "PENDING_PURGE",
|
|
4591
|
+
PURGED_EXTERNALLY = "PURGED_EXTERNALLY"
|
|
4577
4592
|
}
|
|
4578
|
-
|
|
4579
|
-
|
|
4580
|
-
|
|
4593
|
+
/** @enumType */
|
|
4594
|
+
type DeleteStatusWithLiterals = DeleteStatus | 'UNKNOWN' | 'TRASH' | 'DELETED' | 'PENDING_PURGE' | 'PURGED_EXTERNALLY';
|
|
4595
|
+
/** Restoration of the meta site. */
|
|
4596
|
+
interface SiteUndeleted {
|
|
4597
|
+
}
|
|
4598
|
+
/** First publish of a meta site. Or subsequent publish after unpublish. */
|
|
4599
|
+
interface SitePublished {
|
|
4600
|
+
}
|
|
4601
|
+
interface SiteUnpublished {
|
|
4581
4602
|
/**
|
|
4582
|
-
*
|
|
4583
|
-
* @maxLength
|
|
4603
|
+
* A list of URLs previously associated with the meta site.
|
|
4604
|
+
* @maxLength 4000
|
|
4605
|
+
* @maxSize 10000
|
|
4584
4606
|
*/
|
|
4585
|
-
|
|
4607
|
+
urls?: string[];
|
|
4608
|
+
}
|
|
4609
|
+
interface SiteMarkedAsTemplate {
|
|
4610
|
+
}
|
|
4611
|
+
interface SiteMarkedAsWixSite {
|
|
4612
|
+
}
|
|
4613
|
+
/**
|
|
4614
|
+
* Represents a service provisioned a site.
|
|
4615
|
+
*
|
|
4616
|
+
* Note on `origin_instance_id`:
|
|
4617
|
+
* There is no guarantee that you will be able to find a meta site using `origin_instance_id`.
|
|
4618
|
+
* This is because of the following scenario:
|
|
4619
|
+
*
|
|
4620
|
+
* Imagine you have a template where a third-party application (TPA) includes some stub data,
|
|
4621
|
+
* such as a product catalog. When you create a site from this template, you inherit this
|
|
4622
|
+
* default product catalog. However, if the template's product catalog is modified,
|
|
4623
|
+
* your site will retain the catalog as it was at the time of site creation. This ensures that
|
|
4624
|
+
* your site remains consistent with what you initially received and does not include any
|
|
4625
|
+
* changes made to the original template afterward.
|
|
4626
|
+
* To ensure this, the TPA on the template gets a new instance_id.
|
|
4627
|
+
*/
|
|
4628
|
+
interface ServiceProvisioned {
|
|
4586
4629
|
/**
|
|
4587
|
-
*
|
|
4588
|
-
*
|
|
4589
|
-
* @maxLength 100
|
|
4630
|
+
* Either UUID or EmbeddedServiceType.
|
|
4631
|
+
* @maxLength 36
|
|
4590
4632
|
*/
|
|
4591
|
-
|
|
4633
|
+
appDefId?: string;
|
|
4592
4634
|
/**
|
|
4593
|
-
*
|
|
4594
|
-
*
|
|
4595
|
-
* Non-exhaustive list of supported values:
|
|
4596
|
-
* + `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`
|
|
4597
|
-
* @maxLength 150
|
|
4598
|
-
* @deprecated Payment method.
|
|
4599
|
-
* Deprecated. Use `paymentMethodName.buyerLanguageName` instead.
|
|
4600
|
-
* Non-exhaustive list of supported values:
|
|
4601
|
-
* + `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`
|
|
4602
|
-
* @replacedBy payment_method_name
|
|
4603
|
-
* @targetRemovalDate 2026-07-01
|
|
4635
|
+
* Not only UUID. Something here could be something weird.
|
|
4636
|
+
* @maxLength 36
|
|
4604
4637
|
*/
|
|
4605
|
-
|
|
4638
|
+
instanceId?: string;
|
|
4606
4639
|
/**
|
|
4607
|
-
*
|
|
4608
|
-
* @maxLength
|
|
4640
|
+
* An instance id from which this instance is originated.
|
|
4641
|
+
* @maxLength 36
|
|
4609
4642
|
*/
|
|
4610
|
-
|
|
4611
|
-
/** Whether the payment was made offline. For example, when using cash or when marked as paid in the Business Manager. */
|
|
4612
|
-
offlinePayment?: boolean;
|
|
4643
|
+
originInstanceId?: string;
|
|
4613
4644
|
/**
|
|
4614
|
-
*
|
|
4615
|
-
* @
|
|
4616
|
-
* @replacedBy payment.status
|
|
4617
|
-
* @targetRemovalDate 2026-11-01
|
|
4645
|
+
* A version.
|
|
4646
|
+
* @maxLength 500
|
|
4618
4647
|
*/
|
|
4619
|
-
|
|
4620
|
-
/** Whether there is a payment agreement that allows for future charges. */
|
|
4621
|
-
savedPaymentMethod?: boolean;
|
|
4622
|
-
/** Authorization details. */
|
|
4623
|
-
authorizationDetails?: AuthorizationDetails;
|
|
4648
|
+
version?: string | null;
|
|
4624
4649
|
/**
|
|
4625
|
-
*
|
|
4626
|
-
* @
|
|
4650
|
+
* The origin meta site id
|
|
4651
|
+
* @format GUID
|
|
4627
4652
|
*/
|
|
4628
|
-
|
|
4629
|
-
|
|
4630
|
-
|
|
4653
|
+
originMetaSiteId?: string | null;
|
|
4654
|
+
}
|
|
4655
|
+
interface ServiceRemoved {
|
|
4631
4656
|
/**
|
|
4632
|
-
*
|
|
4633
|
-
*
|
|
4634
|
-
* + `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`
|
|
4657
|
+
* Either UUID or EmbeddedServiceType.
|
|
4658
|
+
* @maxLength 36
|
|
4635
4659
|
*/
|
|
4636
|
-
|
|
4637
|
-
}
|
|
4638
|
-
/** @oneof */
|
|
4639
|
-
interface RegularPaymentDetailsPaymentMethodDetailsOneOf {
|
|
4640
|
-
/** Credit card details. */
|
|
4641
|
-
creditCardDetails?: CreditCardPaymentMethodDetails;
|
|
4642
|
-
}
|
|
4643
|
-
declare enum TransactionStatus {
|
|
4644
|
-
UNDEFINED = "UNDEFINED",
|
|
4645
|
-
APPROVED = "APPROVED",
|
|
4646
|
-
PENDING = "PENDING",
|
|
4647
|
-
PENDING_MERCHANT = "PENDING_MERCHANT",
|
|
4648
|
-
CANCELED = "CANCELED",
|
|
4649
|
-
DECLINED = "DECLINED",
|
|
4650
|
-
REFUNDED = "REFUNDED",
|
|
4651
|
-
PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
|
|
4652
|
-
AUTHORIZED = "AUTHORIZED",
|
|
4653
|
-
VOIDED = "VOIDED"
|
|
4654
|
-
}
|
|
4655
|
-
/** @enumType */
|
|
4656
|
-
type TransactionStatusWithLiterals = TransactionStatus | 'UNDEFINED' | 'APPROVED' | 'PENDING' | 'PENDING_MERCHANT' | 'CANCELED' | 'DECLINED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'AUTHORIZED' | 'VOIDED';
|
|
4657
|
-
interface CreditCardPaymentMethodDetails {
|
|
4660
|
+
appDefId?: string;
|
|
4658
4661
|
/**
|
|
4659
|
-
*
|
|
4660
|
-
* @maxLength
|
|
4662
|
+
* Not only UUID. Something here could be something weird.
|
|
4663
|
+
* @maxLength 36
|
|
4661
4664
|
*/
|
|
4662
|
-
|
|
4665
|
+
instanceId?: string;
|
|
4663
4666
|
/**
|
|
4664
|
-
*
|
|
4665
|
-
* @maxLength
|
|
4667
|
+
* A version.
|
|
4668
|
+
* @maxLength 500
|
|
4666
4669
|
*/
|
|
4667
|
-
|
|
4670
|
+
version?: string | null;
|
|
4668
4671
|
}
|
|
4669
|
-
|
|
4672
|
+
/** Rename of the site. Meaning, free public url has been changed as well. */
|
|
4673
|
+
interface SiteRenamed {
|
|
4670
4674
|
/**
|
|
4671
|
-
*
|
|
4672
|
-
* @
|
|
4675
|
+
* A new meta site name (URL slug).
|
|
4676
|
+
* @maxLength 20
|
|
4673
4677
|
*/
|
|
4674
|
-
|
|
4675
|
-
/** Date and time the payment was authorized in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
4676
|
-
authorizedDate?: Date | null;
|
|
4678
|
+
newSiteName?: string;
|
|
4677
4679
|
/**
|
|
4678
|
-
*
|
|
4679
|
-
*
|
|
4680
|
-
* @maxSize 1
|
|
4680
|
+
* A previous meta site name (URL slug).
|
|
4681
|
+
* @maxLength 255
|
|
4681
4682
|
*/
|
|
4682
|
-
|
|
4683
|
-
/** Void associated with payment */
|
|
4684
|
-
void?: AuthorizationVoid;
|
|
4685
|
-
/** Scheduled action for this transaction */
|
|
4686
|
-
scheduledAction?: V1ScheduledAction;
|
|
4683
|
+
oldSiteName?: string;
|
|
4687
4684
|
}
|
|
4688
|
-
|
|
4689
|
-
|
|
4690
|
-
|
|
4691
|
-
|
|
4692
|
-
|
|
4693
|
-
|
|
4694
|
-
|
|
4695
|
-
|
|
4696
|
-
|
|
4685
|
+
/**
|
|
4686
|
+
* Hard deletion of the meta site.
|
|
4687
|
+
*
|
|
4688
|
+
* Could not be restored. Therefore it's desirable to cleanup data.
|
|
4689
|
+
*/
|
|
4690
|
+
interface SiteHardDeleted {
|
|
4691
|
+
/** A deletion context. */
|
|
4692
|
+
deleteContext?: DeleteContext;
|
|
4693
|
+
}
|
|
4694
|
+
interface NamespaceChanged {
|
|
4695
|
+
/** A previous namespace. */
|
|
4696
|
+
oldNamespace?: NamespaceWithLiterals;
|
|
4697
|
+
/** A new namespace. */
|
|
4698
|
+
newNamespace?: NamespaceWithLiterals;
|
|
4699
|
+
}
|
|
4700
|
+
/** Assigned Studio editor */
|
|
4701
|
+
interface StudioAssigned {
|
|
4702
|
+
}
|
|
4703
|
+
/** Unassigned Studio editor */
|
|
4704
|
+
interface StudioUnassigned {
|
|
4705
|
+
}
|
|
4706
|
+
/**
|
|
4707
|
+
* Fired in case site URLs were changed in any way: new secondary domain, published, account slug rename, site rename etc.
|
|
4708
|
+
*
|
|
4709
|
+
* This is an internal event, it's not propagated in special events, because it's non-actionable. If you need to keep up
|
|
4710
|
+
* with sites and its urls, you need to listen to another topic/event. Read about it:
|
|
4711
|
+
*
|
|
4712
|
+
* https://bo.wix.com/wix-docs/rest/meta-site/meta-site---urls-service
|
|
4713
|
+
*/
|
|
4714
|
+
interface SiteUrlChanged {
|
|
4715
|
+
}
|
|
4716
|
+
/**
|
|
4717
|
+
* Used at the end of the deletion flow for both draft sites and when a user deletes a site.
|
|
4718
|
+
* Consumed by other teams to remove relevant data.
|
|
4719
|
+
*/
|
|
4720
|
+
interface SitePurgedExternally {
|
|
4697
4721
|
/**
|
|
4698
|
-
*
|
|
4699
|
-
* @
|
|
4722
|
+
* @maxLength 2048
|
|
4723
|
+
* @maxSize 100
|
|
4724
|
+
* @deprecated
|
|
4725
|
+
* @targetRemovalDate 2025-04-15
|
|
4700
4726
|
*/
|
|
4701
|
-
|
|
4702
|
-
/** Date and time the capture was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
4703
|
-
createdDate?: Date | null;
|
|
4704
|
-
/** In case of status is FAILED may contain failure details */
|
|
4705
|
-
failureDetails?: AuthorizationActionFailureDetails;
|
|
4727
|
+
appDefId?: string[];
|
|
4706
4728
|
}
|
|
4707
|
-
|
|
4708
|
-
|
|
4709
|
-
PENDING = "PENDING",
|
|
4710
|
-
/** Capture operation succeeded. */
|
|
4711
|
-
SUCCEEDED = "SUCCEEDED",
|
|
4712
|
-
/** Capture operation failed. */
|
|
4713
|
-
FAILED = "FAILED"
|
|
4729
|
+
/** Assigned Odeditor */
|
|
4730
|
+
interface OdeditorAssigned {
|
|
4714
4731
|
}
|
|
4715
|
-
/**
|
|
4716
|
-
|
|
4717
|
-
interface AuthorizationActionFailureDetails {
|
|
4718
|
-
/** @maxLength 100 */
|
|
4719
|
-
failureCode?: string;
|
|
4732
|
+
/** Unassigned Odeditor */
|
|
4733
|
+
interface OdeditorUnassigned {
|
|
4720
4734
|
}
|
|
4721
|
-
|
|
4722
|
-
|
|
4723
|
-
status?: AuthorizationVoidStatusWithLiterals;
|
|
4724
|
-
/** Date and time the void was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
4725
|
-
voidedDate?: Date | null;
|
|
4726
|
-
/** In case of status is FAILED may contain failure details */
|
|
4727
|
-
failureDetails?: AuthorizationActionFailureDetails;
|
|
4728
|
-
/** Reason of void action */
|
|
4729
|
-
reason?: ReasonWithLiterals;
|
|
4735
|
+
/** Assigned Picasso editor */
|
|
4736
|
+
interface PicassoAssigned {
|
|
4730
4737
|
}
|
|
4731
|
-
|
|
4732
|
-
|
|
4733
|
-
PENDING = "PENDING",
|
|
4734
|
-
/** Void operation succeeded. */
|
|
4735
|
-
SUCCEEDED = "SUCCEEDED",
|
|
4736
|
-
/** Void operation failed. */
|
|
4737
|
-
FAILED = "FAILED"
|
|
4738
|
+
/** Unassigned Picasso */
|
|
4739
|
+
interface PicassoUnassigned {
|
|
4738
4740
|
}
|
|
4739
|
-
/**
|
|
4740
|
-
|
|
4741
|
-
|
|
4742
|
-
|
|
4743
|
-
|
|
4744
|
-
|
|
4745
|
-
|
|
4746
|
-
|
|
4741
|
+
/** Assigned Wixel */
|
|
4742
|
+
interface WixelAssigned {
|
|
4743
|
+
}
|
|
4744
|
+
/** Unassigned Wixel */
|
|
4745
|
+
interface WixelUnassigned {
|
|
4746
|
+
}
|
|
4747
|
+
/** Assigned StudioTwo */
|
|
4748
|
+
interface StudioTwoAssigned {
|
|
4749
|
+
}
|
|
4750
|
+
/** Unassigned StudioTwo */
|
|
4751
|
+
interface StudioTwoUnassigned {
|
|
4752
|
+
}
|
|
4753
|
+
/** Media from user domain is enabled. */
|
|
4754
|
+
interface UserDomainMediaEnabled {
|
|
4755
|
+
}
|
|
4756
|
+
/** Media from user domain is disabled. */
|
|
4757
|
+
interface UserDomainMediaDisabled {
|
|
4758
|
+
}
|
|
4759
|
+
/** Assigned Editorless */
|
|
4760
|
+
interface EditorlessAssigned {
|
|
4761
|
+
}
|
|
4762
|
+
/** Unassigned Editorless */
|
|
4763
|
+
interface EditorlessUnassigned {
|
|
4764
|
+
}
|
|
4765
|
+
interface HasCustomEmailConfigurationsRequest {
|
|
4766
|
+
}
|
|
4767
|
+
interface HasCustomEmailConfigurationsResponse {
|
|
4768
|
+
hasCustomConfigurations?: boolean;
|
|
4769
|
+
}
|
|
4770
|
+
interface AddToAutomationMigrationPopulationRequest {
|
|
4771
|
+
/** When true, sends custom email configurations to automation system via email */
|
|
4772
|
+
sendCustomEmailConfigs?: boolean;
|
|
4773
|
+
/** Origin of the migration request. Defaults to OPT_IN when UNKNOWN_ORIGIN. */
|
|
4774
|
+
origin?: OriginWithLiterals;
|
|
4775
|
+
}
|
|
4776
|
+
declare enum Origin {
|
|
4777
|
+
OPT_IN = "OPT_IN",
|
|
4778
|
+
MIGRATION = "MIGRATION"
|
|
4747
4779
|
}
|
|
4748
4780
|
/** @enumType */
|
|
4749
|
-
type
|
|
4750
|
-
interface
|
|
4751
|
-
|
|
4752
|
-
actionType?: ActionTypeWithLiterals;
|
|
4753
|
-
/** The date and time of the action. */
|
|
4754
|
-
executionDate?: Date | null;
|
|
4781
|
+
type OriginWithLiterals = Origin | 'OPT_IN' | 'MIGRATION';
|
|
4782
|
+
interface AddToAutomationMigrationPopulationResponse {
|
|
4783
|
+
success?: boolean;
|
|
4755
4784
|
}
|
|
4756
|
-
|
|
4757
|
-
VOID = "VOID",
|
|
4758
|
-
CAPTURE = "CAPTURE"
|
|
4785
|
+
interface IsInAutomationMigrationPopulationRequest {
|
|
4759
4786
|
}
|
|
4760
|
-
|
|
4761
|
-
|
|
4762
|
-
|
|
4787
|
+
interface IsInAutomationMigrationPopulationResponse {
|
|
4788
|
+
inPopulation?: boolean;
|
|
4789
|
+
}
|
|
4790
|
+
interface PreparePaymentCollectionRequest {
|
|
4763
4791
|
/**
|
|
4764
|
-
*
|
|
4765
|
-
* @
|
|
4766
|
-
* @
|
|
4767
|
-
* @immutable
|
|
4792
|
+
* Ecom order ID.
|
|
4793
|
+
* @minLength 1
|
|
4794
|
+
* @maxLength 100
|
|
4768
4795
|
*/
|
|
4769
|
-
|
|
4796
|
+
ecomOrderId: string;
|
|
4797
|
+
/** Amount to collect */
|
|
4798
|
+
amount: Price;
|
|
4770
4799
|
/**
|
|
4771
|
-
*
|
|
4772
|
-
*
|
|
4773
|
-
*
|
|
4800
|
+
* Optional parameter. When present, payment collection will be performed using given payment gateway order.
|
|
4801
|
+
* Existing payment gateway order will be updated with a new amount.
|
|
4802
|
+
* When parameter is absent, new payment gateway order will be created and used for payment collection.
|
|
4774
4803
|
*/
|
|
4775
|
-
|
|
4804
|
+
paymentGatewayOrderId?: string | null;
|
|
4776
4805
|
/**
|
|
4777
|
-
*
|
|
4778
|
-
*
|
|
4806
|
+
* Whether to delay capture of the payment.
|
|
4807
|
+
* Default: false
|
|
4808
|
+
* @deprecated Whether to delay capture of the payment.
|
|
4809
|
+
* Default: false
|
|
4810
|
+
* @replacedBy delayed_capture_settings.scheduled_action
|
|
4811
|
+
* @targetRemovalDate 2024-09-30
|
|
4779
4812
|
*/
|
|
4780
|
-
|
|
4813
|
+
delayedCapture?: boolean;
|
|
4814
|
+
/** Delayed capture payment settings */
|
|
4815
|
+
delayedCaptureSettings?: DelayedCaptureSettings;
|
|
4816
|
+
}
|
|
4817
|
+
interface RedirectUrls {
|
|
4781
4818
|
/**
|
|
4782
|
-
*
|
|
4783
|
-
* @
|
|
4784
|
-
* @immutable
|
|
4819
|
+
* URL to redirect buyer in case of approved (successful) transaction
|
|
4820
|
+
* @format WEB_URL
|
|
4785
4821
|
*/
|
|
4786
|
-
|
|
4822
|
+
successUrl?: string | null;
|
|
4787
4823
|
/**
|
|
4788
|
-
*
|
|
4789
|
-
* @
|
|
4824
|
+
* URL to redirect buyer in case of buyer canceled the transaction
|
|
4825
|
+
* @format WEB_URL
|
|
4790
4826
|
*/
|
|
4791
|
-
|
|
4827
|
+
cancelUrl?: string | null;
|
|
4792
4828
|
/**
|
|
4793
|
-
*
|
|
4794
|
-
*
|
|
4795
|
-
* Default: `"APPROVED"`.
|
|
4829
|
+
* URL to redirect buyer in case of failed/rejected transaction
|
|
4830
|
+
* @format WEB_URL
|
|
4796
4831
|
*/
|
|
4797
|
-
|
|
4832
|
+
errorUrl?: string | null;
|
|
4798
4833
|
/**
|
|
4799
|
-
*
|
|
4800
|
-
* @format
|
|
4801
|
-
* @readonly
|
|
4802
|
-
* @immutable
|
|
4834
|
+
* URL to redirect buyer in case of pending transaction (that might take some time to process)
|
|
4835
|
+
* @format WEB_URL
|
|
4803
4836
|
*/
|
|
4804
|
-
|
|
4837
|
+
pendingUrl?: string | null;
|
|
4805
4838
|
}
|
|
4806
|
-
|
|
4807
|
-
/**
|
|
4808
|
-
|
|
4809
|
-
/**
|
|
4810
|
-
|
|
4839
|
+
interface DelayedCaptureSettings {
|
|
4840
|
+
/** Specifies the automatic action (void/capture) for authorized transaction after the specified duration */
|
|
4841
|
+
scheduledAction?: ScheduledActionWithLiterals;
|
|
4842
|
+
/** Delay duration before execution. Optional - if not set, providers default period will be used */
|
|
4843
|
+
delayDuration?: Duration;
|
|
4844
|
+
}
|
|
4845
|
+
declare enum ScheduledAction {
|
|
4846
|
+
/** Whether payment will be auto-voided when duration passes */
|
|
4847
|
+
VOID = "VOID",
|
|
4848
|
+
/** Whether payment will be auto-captured when duration passes */
|
|
4849
|
+
CAPTURE = "CAPTURE"
|
|
4811
4850
|
}
|
|
4812
4851
|
/** @enumType */
|
|
4813
|
-
type
|
|
4814
|
-
interface
|
|
4815
|
-
/**
|
|
4816
|
-
* Translated payment method name in buyer language.
|
|
4817
|
-
* @maxLength 150
|
|
4818
|
-
*/
|
|
4819
|
-
buyerLanguageName?: string | null;
|
|
4820
|
-
/**
|
|
4821
|
-
* Translated payment method name in site owner language.
|
|
4822
|
-
* @maxLength 150
|
|
4823
|
-
*/
|
|
4824
|
-
siteLanguageName?: string | null;
|
|
4852
|
+
type ScheduledActionWithLiterals = ScheduledAction | 'VOID' | 'CAPTURE';
|
|
4853
|
+
interface Duration {
|
|
4825
4854
|
/**
|
|
4826
|
-
*
|
|
4827
|
-
*
|
|
4828
|
-
* When set, takes precedence over `buyerLanguageName` and `siteLanguageName`.
|
|
4855
|
+
* Amount of units. For example, 30 MINUTES, 1 HOURS, 7 DAYS, etc
|
|
4856
|
+
* @min 1
|
|
4829
4857
|
*/
|
|
4830
|
-
|
|
4858
|
+
count?: number;
|
|
4859
|
+
/** Duration unit: MINUTES, HOURS and DAYS */
|
|
4860
|
+
unit?: DurationUnitWithLiterals;
|
|
4831
4861
|
}
|
|
4832
|
-
|
|
4833
|
-
|
|
4834
|
-
|
|
4835
|
-
|
|
4836
|
-
*/
|
|
4837
|
-
giftCardPaymentId?: string;
|
|
4838
|
-
/**
|
|
4839
|
-
* ID of the app that created the gift card.
|
|
4840
|
-
* @format GUID
|
|
4841
|
-
*/
|
|
4842
|
-
appId?: string;
|
|
4843
|
-
/**
|
|
4844
|
-
* Whether the gift card is voided.
|
|
4845
|
-
* @readonly
|
|
4846
|
-
* @deprecated Whether the gift card is voided.
|
|
4847
|
-
* @replacedBy payment.status
|
|
4848
|
-
* @targetRemovalDate 2026-11-01
|
|
4849
|
-
*/
|
|
4850
|
-
voided?: boolean;
|
|
4851
|
-
/**
|
|
4852
|
-
* Gift card code with all but the last four characters masked. For example, `************QXY1`.
|
|
4853
|
-
* @maxLength 30
|
|
4854
|
-
* @immutable
|
|
4855
|
-
*/
|
|
4856
|
-
obfuscatedCode?: string | null;
|
|
4862
|
+
declare enum DurationUnit {
|
|
4863
|
+
MINUTES = "MINUTES",
|
|
4864
|
+
HOURS = "HOURS",
|
|
4865
|
+
DAYS = "DAYS"
|
|
4857
4866
|
}
|
|
4858
|
-
|
|
4859
|
-
|
|
4860
|
-
|
|
4861
|
-
|
|
4862
|
-
|
|
4863
|
-
|
|
4867
|
+
/** @enumType */
|
|
4868
|
+
type DurationUnitWithLiterals = DurationUnit | 'MINUTES' | 'HOURS' | 'DAYS';
|
|
4869
|
+
interface PreparePaymentCollectionResponse {
|
|
4870
|
+
/** Payment gateway order id which is associated with given payment */
|
|
4871
|
+
paymentGatewayOrderId?: string;
|
|
4872
|
+
}
|
|
4873
|
+
interface GetPaymentCollectabilityStatusRequest {
|
|
4864
4874
|
/**
|
|
4865
|
-
*
|
|
4875
|
+
* Ecom order ID.
|
|
4866
4876
|
* @minLength 1
|
|
4867
4877
|
* @maxLength 100
|
|
4868
4878
|
*/
|
|
4869
|
-
|
|
4870
|
-
|
|
4871
|
-
|
|
4872
|
-
|
|
4873
|
-
|
|
4874
|
-
|
|
4875
|
-
|
|
4876
|
-
|
|
4877
|
-
|
|
4878
|
-
|
|
4879
|
+
ecomOrderId: string;
|
|
4880
|
+
}
|
|
4881
|
+
interface GetPaymentCollectabilityStatusResponse {
|
|
4882
|
+
/** Payment collectability status */
|
|
4883
|
+
status?: PaymentCollectabilityStatusWithLiterals;
|
|
4884
|
+
/** Collectable order amount */
|
|
4885
|
+
amount?: Price;
|
|
4886
|
+
}
|
|
4887
|
+
declare enum PaymentCollectabilityStatus {
|
|
4888
|
+
UNKNOWN = "UNKNOWN",
|
|
4889
|
+
COLLECTABLE = "COLLECTABLE",
|
|
4890
|
+
NONCOLLECTABLE_ORDER_IS_CANCELLED = "NONCOLLECTABLE_ORDER_IS_CANCELLED",
|
|
4891
|
+
NONCOLLECTABLE_ORDER_IS_PAID = "NONCOLLECTABLE_ORDER_IS_PAID",
|
|
4892
|
+
NONCOLLECTABLE_MISSING_PAYMENT_METHOD = "NONCOLLECTABLE_MISSING_PAYMENT_METHOD",
|
|
4893
|
+
NONCOLLECTABLE_ORDER_IS_PENDING = "NONCOLLECTABLE_ORDER_IS_PENDING",
|
|
4894
|
+
NONCOLLECTABLE_ORDER_IS_REJECTED = "NONCOLLECTABLE_ORDER_IS_REJECTED",
|
|
4895
|
+
NONCOLLECTABLE_ORDER_HAS_SUBSCRIPTIONS = "NONCOLLECTABLE_ORDER_HAS_SUBSCRIPTIONS",
|
|
4896
|
+
NONCOLLECTABLE_ORDER_HAS_CHARGEBACKS = "NONCOLLECTABLE_ORDER_HAS_CHARGEBACKS",
|
|
4897
|
+
NONCOLLECTABLE_SUBSCRIPTION_CYCLE_ALREADY_PASSED = "NONCOLLECTABLE_SUBSCRIPTION_CYCLE_ALREADY_PASSED",
|
|
4898
|
+
NONCOLLECTABLE_ORDER_HAS_UNSUPPORTED_SUBSCRIPTION = "NONCOLLECTABLE_ORDER_HAS_UNSUPPORTED_SUBSCRIPTION",
|
|
4899
|
+
NONCOLLECTABLE_CUSTOM_AMOUNT_NOT_SUPPORTED = "NONCOLLECTABLE_CUSTOM_AMOUNT_NOT_SUPPORTED"
|
|
4900
|
+
}
|
|
4901
|
+
/** @enumType */
|
|
4902
|
+
type PaymentCollectabilityStatusWithLiterals = PaymentCollectabilityStatus | 'UNKNOWN' | 'COLLECTABLE' | 'NONCOLLECTABLE_ORDER_IS_CANCELLED' | 'NONCOLLECTABLE_ORDER_IS_PAID' | 'NONCOLLECTABLE_MISSING_PAYMENT_METHOD' | 'NONCOLLECTABLE_ORDER_IS_PENDING' | 'NONCOLLECTABLE_ORDER_IS_REJECTED' | 'NONCOLLECTABLE_ORDER_HAS_SUBSCRIPTIONS' | 'NONCOLLECTABLE_ORDER_HAS_CHARGEBACKS' | 'NONCOLLECTABLE_SUBSCRIPTION_CYCLE_ALREADY_PASSED' | 'NONCOLLECTABLE_ORDER_HAS_UNSUPPORTED_SUBSCRIPTION' | 'NONCOLLECTABLE_CUSTOM_AMOUNT_NOT_SUPPORTED';
|
|
4903
|
+
interface RecordManuallyCollectedPaymentRequest {
|
|
4879
4904
|
/**
|
|
4880
|
-
*
|
|
4905
|
+
* Order ID.
|
|
4881
4906
|
* @minLength 1
|
|
4882
4907
|
* @maxLength 100
|
|
4883
4908
|
*/
|
|
4884
|
-
|
|
4909
|
+
orderId: string;
|
|
4910
|
+
/** Amount to be recorded as approved manual payment for given order */
|
|
4911
|
+
amount: Price;
|
|
4912
|
+
}
|
|
4913
|
+
/**
|
|
4914
|
+
* User-defined payment method name.
|
|
4915
|
+
* Allows specifying either a predefined type or a custom name.
|
|
4916
|
+
*/
|
|
4917
|
+
interface UserDefinedPaymentMethodName extends UserDefinedPaymentMethodNameKindOneOf {
|
|
4918
|
+
/** Predefined payment method. */
|
|
4919
|
+
predefined?: PredefinedPaymentMethodWithLiterals;
|
|
4885
4920
|
/**
|
|
4886
|
-
*
|
|
4887
|
-
*
|
|
4888
|
-
*
|
|
4889
|
-
* @
|
|
4890
|
-
* @
|
|
4921
|
+
* Custom payment method name provided by user.
|
|
4922
|
+
*
|
|
4923
|
+
* For example, `"Wire transfer"`, `"Money order"`, `"Venmo"` or any other custom name.
|
|
4924
|
+
* @minLength 1
|
|
4925
|
+
* @maxLength 150
|
|
4891
4926
|
*/
|
|
4892
|
-
|
|
4927
|
+
custom?: string | null;
|
|
4928
|
+
}
|
|
4929
|
+
/** @oneof */
|
|
4930
|
+
interface UserDefinedPaymentMethodNameKindOneOf {
|
|
4931
|
+
/** Predefined payment method. */
|
|
4932
|
+
predefined?: PredefinedPaymentMethodWithLiterals;
|
|
4893
4933
|
/**
|
|
4894
|
-
*
|
|
4895
|
-
*
|
|
4934
|
+
* Custom payment method name provided by user.
|
|
4935
|
+
*
|
|
4936
|
+
* For example, `"Wire transfer"`, `"Money order"`, `"Venmo"` or any other custom name.
|
|
4937
|
+
* @minLength 1
|
|
4938
|
+
* @maxLength 150
|
|
4896
4939
|
*/
|
|
4897
|
-
|
|
4898
|
-
/** Details of a membership that does not yet exist, allowing the payment to be held before the membership is created. */
|
|
4899
|
-
futureMembership?: FutureMembershipDetails;
|
|
4940
|
+
custom?: string | null;
|
|
4900
4941
|
}
|
|
4901
|
-
|
|
4902
|
-
|
|
4903
|
-
|
|
4904
|
-
|
|
4905
|
-
|
|
4906
|
-
|
|
4907
|
-
|
|
4908
|
-
|
|
4909
|
-
VOIDED = "VOIDED"
|
|
4942
|
+
/** Predefined payment method types for offline/manual payments. */
|
|
4943
|
+
declare enum PredefinedPaymentMethod {
|
|
4944
|
+
/** Cash payment. */
|
|
4945
|
+
CASH = "CASH",
|
|
4946
|
+
/** Bank transfer. */
|
|
4947
|
+
BANK_TRANSFER = "BANK_TRANSFER",
|
|
4948
|
+
/** Payment by check. */
|
|
4949
|
+
CHECK = "CHECK"
|
|
4910
4950
|
}
|
|
4911
4951
|
/** @enumType */
|
|
4912
|
-
type
|
|
4913
|
-
interface
|
|
4914
|
-
/**
|
|
4915
|
-
* ID of the plan line item in the order from which the membership will be created.
|
|
4916
|
-
* @format GUID
|
|
4917
|
-
*/
|
|
4918
|
-
lineItemId?: string;
|
|
4919
|
-
/**
|
|
4920
|
-
* ID of the benefit the future membership will grant.
|
|
4921
|
-
* @maxLength 200
|
|
4922
|
-
*/
|
|
4923
|
-
benefitId?: string;
|
|
4952
|
+
type PredefinedPaymentMethodWithLiterals = PredefinedPaymentMethod | 'CASH' | 'BANK_TRANSFER' | 'CHECK';
|
|
4953
|
+
interface RecordManuallyCollectedPaymentResponse {
|
|
4924
4954
|
}
|
|
4925
|
-
interface
|
|
4955
|
+
interface MarkOrderAsPaidRequest {
|
|
4926
4956
|
/**
|
|
4927
|
-
*
|
|
4928
|
-
* @
|
|
4957
|
+
* Ecom order ID.
|
|
4958
|
+
* @minLength 1
|
|
4959
|
+
* @maxLength 100
|
|
4929
4960
|
*/
|
|
4930
|
-
|
|
4961
|
+
ecomOrderId: string;
|
|
4962
|
+
}
|
|
4963
|
+
interface MarkOrderAsPaidResponse {
|
|
4964
|
+
/** Updated order. */
|
|
4965
|
+
order?: Order;
|
|
4966
|
+
}
|
|
4967
|
+
interface BulkMarkOrdersAsPaidRequest {
|
|
4931
4968
|
/**
|
|
4932
|
-
*
|
|
4969
|
+
* IDs of orders to mark as paid.
|
|
4970
|
+
* @minSize 1
|
|
4971
|
+
* @maxSize 100
|
|
4933
4972
|
* @minLength 1
|
|
4934
|
-
* @maxLength
|
|
4973
|
+
* @maxLength 100
|
|
4935
4974
|
*/
|
|
4936
|
-
|
|
4975
|
+
ecomOrderIds: string[];
|
|
4937
4976
|
}
|
|
4938
|
-
interface
|
|
4977
|
+
interface BulkMarkOrdersAsPaidResponse {
|
|
4939
4978
|
/**
|
|
4940
|
-
*
|
|
4941
|
-
*
|
|
4979
|
+
* Items updated by the bulk action.
|
|
4980
|
+
* The Order entity within the results optimistically changes its payment status to paid, however this process is async.
|
|
4942
4981
|
*/
|
|
4943
|
-
|
|
4982
|
+
results?: BulkOrderResult[];
|
|
4983
|
+
/** Bulk action metadata. */
|
|
4984
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
4985
|
+
}
|
|
4986
|
+
interface BulkOrderResult {
|
|
4987
|
+
/** Item metadata. */
|
|
4988
|
+
itemMetadata?: ItemMetadata;
|
|
4944
4989
|
/**
|
|
4945
|
-
*
|
|
4946
|
-
*
|
|
4990
|
+
* Updated order.
|
|
4991
|
+
*
|
|
4992
|
+
* Returned when `returnFullEntity = true`.
|
|
4947
4993
|
*/
|
|
4948
|
-
|
|
4994
|
+
item?: Order;
|
|
4995
|
+
}
|
|
4996
|
+
interface ItemMetadata {
|
|
4997
|
+
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
4998
|
+
id?: string | null;
|
|
4999
|
+
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
5000
|
+
originalIndex?: number;
|
|
5001
|
+
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
5002
|
+
success?: boolean;
|
|
5003
|
+
/** Details about the error in case of failure. */
|
|
5004
|
+
error?: ApplicationError;
|
|
5005
|
+
}
|
|
5006
|
+
interface ApplicationError {
|
|
5007
|
+
/** Error code. */
|
|
5008
|
+
code?: string;
|
|
5009
|
+
/** Description of the error. */
|
|
5010
|
+
description?: string;
|
|
5011
|
+
/** Data related to the error. */
|
|
5012
|
+
data?: Record<string, any> | null;
|
|
5013
|
+
}
|
|
5014
|
+
interface BulkActionMetadata {
|
|
5015
|
+
/** Number of items that were successfully processed. */
|
|
5016
|
+
totalSuccesses?: number;
|
|
5017
|
+
/** Number of items that couldn't be processed. */
|
|
5018
|
+
totalFailures?: number;
|
|
5019
|
+
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
5020
|
+
undetailedFailures?: number;
|
|
5021
|
+
}
|
|
5022
|
+
interface GetRefundabilityStatusRequest {
|
|
4949
5023
|
/**
|
|
4950
|
-
*
|
|
5024
|
+
* Order ID.
|
|
4951
5025
|
* @minLength 1
|
|
4952
|
-
* @maxLength
|
|
5026
|
+
* @maxLength 100
|
|
4953
5027
|
*/
|
|
4954
|
-
|
|
5028
|
+
ecomOrderId: string;
|
|
4955
5029
|
}
|
|
4956
|
-
interface
|
|
5030
|
+
interface GetRefundabilityStatusResponse {
|
|
4957
5031
|
/**
|
|
4958
|
-
*
|
|
4959
|
-
*
|
|
4960
|
-
* to prevent false overpayment or underpayment due to rounding.
|
|
5032
|
+
* Refundability details.
|
|
5033
|
+
* @maxSize 300
|
|
4961
5034
|
*/
|
|
4962
|
-
|
|
5035
|
+
refundabilities?: Refundability[];
|
|
4963
5036
|
/**
|
|
4964
|
-
*
|
|
4965
|
-
*
|
|
4966
|
-
* @readonly
|
|
5037
|
+
* Whether the order supports refunding per item.
|
|
5038
|
+
* @deprecated
|
|
4967
5039
|
*/
|
|
4968
|
-
|
|
5040
|
+
refundablePerItem?: boolean;
|
|
4969
5041
|
}
|
|
4970
|
-
|
|
4971
|
-
/**
|
|
4972
|
-
|
|
4973
|
-
/**
|
|
4974
|
-
|
|
4975
|
-
/** Payment
|
|
4976
|
-
|
|
4977
|
-
/** Payment
|
|
4978
|
-
|
|
4979
|
-
/**
|
|
4980
|
-
|
|
4981
|
-
/** Payment was fully refunded. */
|
|
4982
|
-
REFUNDED = "REFUNDED",
|
|
4983
|
-
/** Part of the payment amount was refunded. */
|
|
4984
|
-
PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
|
|
4985
|
-
/** Funds are held on the buyer's payment method but haven't been captured. Capture them with [Capture Authorized Payments](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/capture-authorized-payments) or release them with [Void Authorized Payments](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/void-authorized-payments). An authorized payment can't be refunded until it's captured. */
|
|
4986
|
-
AUTHORIZED = "AUTHORIZED",
|
|
4987
|
-
/**
|
|
4988
|
-
* Payment was voided, releasing whatever it held or consumed: an authorization on the buyer's payment method, a gift card balance, or membership credits.
|
|
4989
|
-
*
|
|
4990
|
-
* Gift card and membership payments don't support partial refunds, so a full refund of one is reported as `VOIDED` rather than `REFUNDED`.
|
|
4991
|
-
*/
|
|
4992
|
-
VOIDED = "VOIDED"
|
|
5042
|
+
interface Refundability extends RefundabilityAdditionalRefundabilityInfoOneOf {
|
|
5043
|
+
/** Reason why payment is not refundable. */
|
|
5044
|
+
nonRefundableReason?: NonRefundableReasonWithLiterals;
|
|
5045
|
+
/** Reason why payment is only refundable manually. */
|
|
5046
|
+
manuallyRefundableReason?: ManuallyRefundableReasonWithLiterals;
|
|
5047
|
+
/** Payment ID. */
|
|
5048
|
+
paymentId?: string;
|
|
5049
|
+
/** Payment refundability status. */
|
|
5050
|
+
refundabilityStatus?: RefundableStatusWithLiterals;
|
|
5051
|
+
/** Link to payment provider dashboard. */
|
|
5052
|
+
providerLink?: string | null;
|
|
4993
5053
|
}
|
|
4994
|
-
/** @
|
|
4995
|
-
|
|
4996
|
-
|
|
4997
|
-
|
|
5054
|
+
/** @oneof */
|
|
5055
|
+
interface RefundabilityAdditionalRefundabilityInfoOneOf {
|
|
5056
|
+
/** Reason why payment is not refundable. */
|
|
5057
|
+
nonRefundableReason?: NonRefundableReasonWithLiterals;
|
|
5058
|
+
/** Reason why payment is only refundable manually. */
|
|
5059
|
+
manuallyRefundableReason?: ManuallyRefundableReasonWithLiterals;
|
|
4998
5060
|
}
|
|
4999
|
-
declare enum
|
|
5000
|
-
|
|
5001
|
-
|
|
5002
|
-
|
|
5003
|
-
EXPIRED = "EXPIRED"
|
|
5061
|
+
declare enum RefundableStatus {
|
|
5062
|
+
NOT_REFUNDABLE = "NOT_REFUNDABLE",
|
|
5063
|
+
MANUAL = "MANUAL",
|
|
5064
|
+
REFUNDABLE = "REFUNDABLE"
|
|
5004
5065
|
}
|
|
5005
5066
|
/** @enumType */
|
|
5006
|
-
type
|
|
5007
|
-
|
|
5008
|
-
|
|
5009
|
-
|
|
5010
|
-
|
|
5011
|
-
|
|
5012
|
-
|
|
5013
|
-
|
|
5014
|
-
|
|
5015
|
-
|
|
5016
|
-
|
|
5017
|
-
|
|
5018
|
-
|
|
5067
|
+
type RefundableStatusWithLiterals = RefundableStatus | 'NOT_REFUNDABLE' | 'MANUAL' | 'REFUNDABLE';
|
|
5068
|
+
declare enum NonRefundableReason {
|
|
5069
|
+
NONE = "NONE",
|
|
5070
|
+
ALREADY_REFUNDED = "ALREADY_REFUNDED",
|
|
5071
|
+
PROVIDER_IS_DOWN = "PROVIDER_IS_DOWN",
|
|
5072
|
+
INTERNAL_ERROR = "INTERNAL_ERROR",
|
|
5073
|
+
NOT_PAID = "NOT_PAID",
|
|
5074
|
+
ACCESS_DENIED = "ACCESS_DENIED",
|
|
5075
|
+
ZERO_PRICE = "ZERO_PRICE",
|
|
5076
|
+
DISABLED_BY_PROVIDER = "DISABLED_BY_PROVIDER",
|
|
5077
|
+
PENDING_REFUND = "PENDING_REFUND",
|
|
5078
|
+
FORBIDDEN = "FORBIDDEN",
|
|
5079
|
+
TRANSACTION_NOT_FOUND = "TRANSACTION_NOT_FOUND",
|
|
5080
|
+
ORDER_IS_PENDING = "ORDER_IS_PENDING",
|
|
5081
|
+
ORDER_IS_REJECTED = "ORDER_IS_REJECTED"
|
|
5019
5082
|
}
|
|
5020
5083
|
/** @enumType */
|
|
5021
|
-
type
|
|
5022
|
-
|
|
5023
|
-
|
|
5024
|
-
|
|
5025
|
-
|
|
5026
|
-
|
|
5027
|
-
MERCHANT_REQUEST = "MERCHANT_REQUEST",
|
|
5028
|
-
/** Other payment with the same chargeCorrelationId failed and caused rollback of all payments with same chargeCorrelationId. */
|
|
5029
|
-
OTHER_PAYMENT_FAILURE = "OTHER_PAYMENT_FAILURE"
|
|
5084
|
+
type NonRefundableReasonWithLiterals = NonRefundableReason | 'NONE' | 'ALREADY_REFUNDED' | 'PROVIDER_IS_DOWN' | 'INTERNAL_ERROR' | 'NOT_PAID' | 'ACCESS_DENIED' | 'ZERO_PRICE' | 'DISABLED_BY_PROVIDER' | 'PENDING_REFUND' | 'FORBIDDEN' | 'TRANSACTION_NOT_FOUND' | 'ORDER_IS_PENDING' | 'ORDER_IS_REJECTED';
|
|
5085
|
+
declare enum ManuallyRefundableReason {
|
|
5086
|
+
EXPIRED = "EXPIRED",
|
|
5087
|
+
NOT_SUPPORTED = "NOT_SUPPORTED",
|
|
5088
|
+
OFFLINE = "OFFLINE",
|
|
5089
|
+
REQUIRES_CARD_READER = "REQUIRES_CARD_READER"
|
|
5030
5090
|
}
|
|
5031
5091
|
/** @enumType */
|
|
5032
|
-
type
|
|
5033
|
-
interface
|
|
5034
|
-
|
|
5035
|
-
|
|
5036
|
-
|
|
5092
|
+
type ManuallyRefundableReasonWithLiterals = ManuallyRefundableReason | 'EXPIRED' | 'NOT_SUPPORTED' | 'OFFLINE' | 'REQUIRES_CARD_READER';
|
|
5093
|
+
interface CreatePaymentGatewayOrderRequest {
|
|
5094
|
+
/**
|
|
5095
|
+
* Ecom order ID.
|
|
5096
|
+
* @minLength 1
|
|
5097
|
+
* @maxLength 100
|
|
5098
|
+
*/
|
|
5099
|
+
ecomOrderId: string;
|
|
5100
|
+
/** Information about the user who initiated the payment. */
|
|
5101
|
+
chargedBy?: ChargedBy;
|
|
5037
5102
|
}
|
|
5038
|
-
interface
|
|
5103
|
+
interface ChargedBy {
|
|
5039
5104
|
/**
|
|
5040
|
-
*
|
|
5105
|
+
* ID - id of the user who initiated the payment
|
|
5041
5106
|
* @format GUID
|
|
5042
|
-
* @readonly
|
|
5043
5107
|
*/
|
|
5044
5108
|
id?: string;
|
|
5045
5109
|
/**
|
|
5046
|
-
*
|
|
5047
|
-
* @
|
|
5110
|
+
* Full name - name of the user who initiated the payment
|
|
5111
|
+
* @minLength 1
|
|
5112
|
+
* @maxLength 200
|
|
5048
5113
|
*/
|
|
5049
|
-
|
|
5050
|
-
|
|
5051
|
-
|
|
5114
|
+
fullName?: string | null;
|
|
5115
|
+
}
|
|
5116
|
+
interface CreatePaymentGatewayOrderResponse {
|
|
5117
|
+
/** ID of the order created in the payment gateway */
|
|
5118
|
+
paymentGatewayOrderId?: string;
|
|
5119
|
+
}
|
|
5120
|
+
interface ChargeMembershipsRequest {
|
|
5121
|
+
/**
|
|
5122
|
+
* Order ID.
|
|
5123
|
+
* @minLength 1
|
|
5124
|
+
* @maxLength 100
|
|
5125
|
+
*/
|
|
5126
|
+
ecomOrderId: string;
|
|
5127
|
+
/**
|
|
5128
|
+
* The member id. Do not attempt to get it from the request context, since in some cases the caller is not a member
|
|
5129
|
+
* but a user which is using the membership on behalf of the a member
|
|
5130
|
+
* @format GUID
|
|
5131
|
+
*/
|
|
5132
|
+
memberId: string;
|
|
5052
5133
|
/**
|
|
5053
|
-
*
|
|
5054
|
-
* @
|
|
5055
|
-
* @
|
|
5134
|
+
* List of items to be paid by memberships
|
|
5135
|
+
* @minSize 1
|
|
5136
|
+
* @maxSize 300
|
|
5056
5137
|
*/
|
|
5057
|
-
|
|
5138
|
+
membershipCharges?: MembershipChargeItem[];
|
|
5139
|
+
}
|
|
5140
|
+
interface MembershipChargeItem {
|
|
5058
5141
|
/**
|
|
5059
|
-
*
|
|
5060
|
-
* @
|
|
5142
|
+
* The id of used membership
|
|
5143
|
+
* @minLength 1
|
|
5144
|
+
* @maxLength 100
|
|
5061
5145
|
*/
|
|
5062
|
-
|
|
5146
|
+
membershipId?: string;
|
|
5063
5147
|
/**
|
|
5064
|
-
* ID of the
|
|
5148
|
+
* ID of the application providing this payment option
|
|
5065
5149
|
* @format GUID
|
|
5066
|
-
* @readonly
|
|
5067
|
-
* @immutable
|
|
5068
5150
|
*/
|
|
5069
|
-
|
|
5070
|
-
|
|
5071
|
-
|
|
5151
|
+
appId?: string;
|
|
5152
|
+
/** The name of used membership */
|
|
5153
|
+
membershipName?: MembershipName;
|
|
5154
|
+
/** Additional data about this membership */
|
|
5155
|
+
membershipAdditionalData?: Record<string, any> | null;
|
|
5156
|
+
/** Catalog and item reference info. */
|
|
5157
|
+
catalogReference?: CatalogReference;
|
|
5158
|
+
/** Properties of the service. When relevant, contains information such as date and number of participants. */
|
|
5159
|
+
serviceProperties?: ServiceProperties;
|
|
5072
5160
|
/**
|
|
5073
|
-
*
|
|
5074
|
-
*
|
|
5075
|
-
*
|
|
5161
|
+
* Usually would be the same as catalogReference.catalogItemId
|
|
5162
|
+
* For cases when these are not the same, this field would return the actual id of the item in the catalog
|
|
5163
|
+
* For example, for Wix bookings, catalogReference.catalogItemId is the booking id, and this value is being set to be the service id
|
|
5164
|
+
* @minLength 1
|
|
5165
|
+
* @maxLength 36
|
|
5076
5166
|
*/
|
|
5077
|
-
|
|
5167
|
+
rootCatalogItemId?: string | null;
|
|
5078
5168
|
/**
|
|
5079
|
-
*
|
|
5080
|
-
* @
|
|
5169
|
+
* line item id of Checkout/Order line item
|
|
5170
|
+
* @minLength 1
|
|
5171
|
+
* @maxLength 100
|
|
5081
5172
|
*/
|
|
5082
|
-
|
|
5083
|
-
|
|
5084
|
-
|
|
5085
|
-
/** Optional details of current refund status. */
|
|
5086
|
-
refundStatusInfo?: RefundStatusInfo;
|
|
5173
|
+
lineItemId?: string;
|
|
5174
|
+
}
|
|
5175
|
+
interface MembershipName {
|
|
5087
5176
|
/**
|
|
5088
|
-
*
|
|
5089
|
-
*
|
|
5090
|
-
* @format GUID
|
|
5177
|
+
* Membership name.
|
|
5178
|
+
* @maxLength 100
|
|
5091
5179
|
*/
|
|
5092
|
-
|
|
5093
|
-
/** ID of the refund in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for external refunds. */
|
|
5094
|
-
providerRefundId?: string | null;
|
|
5180
|
+
original?: string;
|
|
5095
5181
|
/**
|
|
5096
|
-
*
|
|
5097
|
-
* @
|
|
5182
|
+
* Translated membership name. Defaults to `original` when not provided.
|
|
5183
|
+
* @maxLength 100
|
|
5098
5184
|
*/
|
|
5099
|
-
|
|
5185
|
+
translated?: string | null;
|
|
5100
5186
|
}
|
|
5101
|
-
|
|
5102
|
-
declare enum RefundStatus {
|
|
5103
|
-
/** Refund was initiated on payment provider side. PENDING status was assigned by provider. */
|
|
5104
|
-
PENDING = "PENDING",
|
|
5105
|
-
/** Refund transaction succeeded. */
|
|
5106
|
-
SUCCEEDED = "SUCCEEDED",
|
|
5107
|
-
/** Refund transaction failed. */
|
|
5108
|
-
FAILED = "FAILED",
|
|
5109
|
-
/** Refund request acknowledged, and will be executed soon. */
|
|
5110
|
-
SCHEDULED = "SCHEDULED",
|
|
5111
|
-
/** Refund was initiated on payment provider side. */
|
|
5112
|
-
STARTED = "STARTED"
|
|
5187
|
+
interface ChargeMembershipsResponse {
|
|
5113
5188
|
}
|
|
5114
|
-
|
|
5115
|
-
type RefundStatusWithLiterals = RefundStatus | 'PENDING' | 'SUCCEEDED' | 'FAILED' | 'SCHEDULED' | 'STARTED';
|
|
5116
|
-
interface RefundStatusInfo {
|
|
5189
|
+
interface TriggerRefundRequest {
|
|
5117
5190
|
/**
|
|
5118
|
-
*
|
|
5119
|
-
*
|
|
5120
|
-
* Learn more about [reason codes](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/reason-codes).
|
|
5191
|
+
* The order this refund related to
|
|
5121
5192
|
* @minLength 1
|
|
5122
|
-
* @maxLength
|
|
5193
|
+
* @maxLength 100
|
|
5123
5194
|
*/
|
|
5124
|
-
|
|
5195
|
+
ecomOrderId: string;
|
|
5125
5196
|
/**
|
|
5126
|
-
*
|
|
5127
|
-
* @
|
|
5128
|
-
* @
|
|
5197
|
+
* Refund operations information
|
|
5198
|
+
* @minSize 1
|
|
5199
|
+
* @maxSize 1
|
|
5129
5200
|
*/
|
|
5130
|
-
|
|
5131
|
-
|
|
5132
|
-
|
|
5133
|
-
/**
|
|
5134
|
-
|
|
5135
|
-
/** Pending refund amount - the portion of `requestedRefund` that is still pending. */
|
|
5136
|
-
pendingRefund?: Price;
|
|
5137
|
-
/** Refunded amount - the portion of `requestedRefund` that refunded successfully. */
|
|
5138
|
-
refunded?: Price;
|
|
5139
|
-
/** Failed refund amount - the portion of `requestedRefund` that failed. */
|
|
5140
|
-
failedRefundAmount?: Price;
|
|
5141
|
-
/** Whether at least one refund transaction is still in `"PENDING"` status. */
|
|
5142
|
-
pending?: boolean;
|
|
5143
|
-
/** Breakdown of refunded items. Available only after refund is complete. */
|
|
5144
|
-
breakdown?: RefundItemsBreakdown;
|
|
5201
|
+
payments: PaymentRefund[];
|
|
5202
|
+
/** Business model of a refund */
|
|
5203
|
+
details?: RefundDetails;
|
|
5204
|
+
/** Side effect details related to refund */
|
|
5205
|
+
sideEffects?: RefundSideEffects;
|
|
5145
5206
|
}
|
|
5146
|
-
interface
|
|
5207
|
+
interface PaymentRefund {
|
|
5147
5208
|
/**
|
|
5148
|
-
*
|
|
5149
|
-
* @
|
|
5209
|
+
* Specific payment within the order to refund
|
|
5210
|
+
* @format GUID
|
|
5150
5211
|
*/
|
|
5151
|
-
|
|
5152
|
-
|
|
5153
|
-
|
|
5212
|
+
paymentId?: string;
|
|
5213
|
+
/** Refund amount. Not relevant for membership and gift card refunds. */
|
|
5214
|
+
amount?: Price;
|
|
5154
5215
|
/**
|
|
5155
|
-
*
|
|
5156
|
-
*
|
|
5216
|
+
* Whether refund is made externally and manually (on the payment provider's side)
|
|
5217
|
+
* 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.
|
|
5218
|
+
* When true, the payment will only be *marked* as refunded, and no actual refund will be performed.
|
|
5157
5219
|
*/
|
|
5158
|
-
|
|
5159
|
-
/** Total refunded amount for the line item. */
|
|
5160
|
-
totalRefundedAmount?: Price;
|
|
5220
|
+
externalRefund?: boolean;
|
|
5161
5221
|
}
|
|
5162
|
-
interface
|
|
5222
|
+
interface RefundSideEffects {
|
|
5223
|
+
/** Inventory restock details as part of this refund. */
|
|
5224
|
+
restockInfo?: RestockInfo;
|
|
5225
|
+
/** Whether to send a refund confirmation email to the customer. */
|
|
5226
|
+
sendOrderRefundedEmail?: boolean;
|
|
5163
5227
|
/**
|
|
5164
|
-
*
|
|
5228
|
+
* Custom message added to the refund confirmation email.
|
|
5165
5229
|
* @minLength 1
|
|
5166
|
-
* @maxLength
|
|
5230
|
+
* @maxLength 1000
|
|
5167
5231
|
*/
|
|
5168
|
-
|
|
5232
|
+
customMessage?: string | null;
|
|
5233
|
+
}
|
|
5234
|
+
interface RestockInfo {
|
|
5235
|
+
/** Restock type. */
|
|
5236
|
+
type?: RestockTypeWithLiterals;
|
|
5169
5237
|
/**
|
|
5170
|
-
*
|
|
5238
|
+
* Restocked line items and quantities. Only relevant for `{"type": "SOME_ITEMS"}`.
|
|
5171
5239
|
* @maxSize 300
|
|
5172
5240
|
*/
|
|
5173
|
-
|
|
5174
|
-
/** Should include shipping in refund calculation */
|
|
5175
|
-
refundShipping?: boolean;
|
|
5241
|
+
items?: RestockItem[];
|
|
5176
5242
|
}
|
|
5177
|
-
|
|
5243
|
+
declare enum RestockType {
|
|
5244
|
+
NO_ITEMS = "NO_ITEMS",
|
|
5245
|
+
ALL_ITEMS = "ALL_ITEMS",
|
|
5246
|
+
SOME_ITEMS = "SOME_ITEMS"
|
|
5247
|
+
}
|
|
5248
|
+
/** @enumType */
|
|
5249
|
+
type RestockTypeWithLiterals = RestockType | 'NO_ITEMS' | 'ALL_ITEMS' | 'SOME_ITEMS';
|
|
5250
|
+
interface RestockItem {
|
|
5178
5251
|
/**
|
|
5179
|
-
* ID of the line item being
|
|
5252
|
+
* ID of the line item being restocked.
|
|
5180
5253
|
* @format GUID
|
|
5181
5254
|
*/
|
|
5182
|
-
|
|
5255
|
+
lineItemId?: string;
|
|
5183
5256
|
/**
|
|
5184
|
-
*
|
|
5257
|
+
* Line item quantity being restocked.
|
|
5185
5258
|
* @min 1
|
|
5186
5259
|
* @max 100000
|
|
5187
5260
|
*/
|
|
5188
5261
|
quantity?: number;
|
|
5189
5262
|
}
|
|
5190
|
-
interface
|
|
5191
|
-
/**
|
|
5192
|
-
|
|
5193
|
-
/**
|
|
5194
|
-
|
|
5195
|
-
/**
|
|
5196
|
-
|
|
5197
|
-
/** Total cost of the order (without tax) */
|
|
5198
|
-
subtotal?: Price;
|
|
5199
|
-
/** Total shipping cost for order */
|
|
5200
|
-
shipping?: Price;
|
|
5201
|
-
/** Previous refund given on that order */
|
|
5202
|
-
previouslyRefundedAmount?: Price;
|
|
5203
|
-
/**
|
|
5204
|
-
* The refundable items of that order
|
|
5205
|
-
* @maxSize 300
|
|
5206
|
-
*/
|
|
5207
|
-
items?: CalculateRefundItemResponse[];
|
|
5263
|
+
interface TriggerRefundResponse {
|
|
5264
|
+
/** All order's transactions after the refunds were added */
|
|
5265
|
+
orderTransactions?: OrderTransactions;
|
|
5266
|
+
/** Created refund ID */
|
|
5267
|
+
refundId?: string | null;
|
|
5268
|
+
/** Payment ID's that the refund execution had failed for */
|
|
5269
|
+
failedPaymentIds?: ItemMetadata[];
|
|
5208
5270
|
}
|
|
5209
|
-
|
|
5271
|
+
/**
|
|
5272
|
+
* A record of all payments and refunds associated with an order.
|
|
5273
|
+
*
|
|
5274
|
+
* Use order transactions to track payment status, add payment records, process refunds, and monitor chargebacks.
|
|
5275
|
+
*/
|
|
5276
|
+
interface OrderTransactions {
|
|
5210
5277
|
/**
|
|
5211
|
-
*
|
|
5278
|
+
* Order ID.
|
|
5212
5279
|
* @format GUID
|
|
5213
5280
|
*/
|
|
5214
|
-
|
|
5215
|
-
/** Refundable amount for requested quantity of items (price of requested quantity of items without tax and discount) */
|
|
5216
|
-
price?: Price;
|
|
5217
|
-
}
|
|
5218
|
-
interface VoidAuthorizedPaymentsRequest {
|
|
5281
|
+
orderId?: string;
|
|
5219
5282
|
/**
|
|
5220
|
-
*
|
|
5221
|
-
* @
|
|
5222
|
-
* @maxLength 100
|
|
5283
|
+
* Record of payments made to the merchant.
|
|
5284
|
+
* @maxSize 100
|
|
5223
5285
|
*/
|
|
5224
|
-
|
|
5286
|
+
payments?: Payment[];
|
|
5225
5287
|
/**
|
|
5226
|
-
*
|
|
5227
|
-
* @
|
|
5228
|
-
* @maxSize 100
|
|
5229
|
-
* @format GUID
|
|
5288
|
+
* Record of refunds made to the buyer.
|
|
5289
|
+
* @maxSize 300
|
|
5230
5290
|
*/
|
|
5231
|
-
|
|
5232
|
-
}
|
|
5233
|
-
interface VoidAuthorizedPaymentsResponse {
|
|
5234
|
-
/** All order's transactions after the void was triggered */
|
|
5235
|
-
orderTransactions?: OrderTransactions;
|
|
5291
|
+
refunds?: Refund[];
|
|
5236
5292
|
}
|
|
5237
|
-
interface
|
|
5293
|
+
interface Payment extends PaymentPaymentDetailsOneOf, PaymentReceiptInfoOneOf, PaymentStatusDetailsOneOf {
|
|
5294
|
+
/** Regular payment details. */
|
|
5295
|
+
regularPaymentDetails?: RegularPaymentDetails;
|
|
5296
|
+
/** Gift card payment details. */
|
|
5297
|
+
giftcardPaymentDetails?: GiftCardPaymentDetails;
|
|
5298
|
+
/** Membership payment details. */
|
|
5299
|
+
membershipPaymentDetails?: MembershipPaymentDetails;
|
|
5300
|
+
/**
|
|
5301
|
+
* Payment ID.
|
|
5302
|
+
* @format GUID
|
|
5303
|
+
* @readonly
|
|
5304
|
+
*/
|
|
5305
|
+
id?: string | null;
|
|
5306
|
+
/** 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. */
|
|
5307
|
+
createdDate?: Date | null;
|
|
5238
5308
|
/**
|
|
5239
|
-
*
|
|
5240
|
-
* @
|
|
5241
|
-
* @maxLength 100
|
|
5309
|
+
* Date and time the payment was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
|
|
5310
|
+
* @readonly
|
|
5242
5311
|
*/
|
|
5243
|
-
|
|
5312
|
+
updatedDate?: Date | null;
|
|
5313
|
+
/** Payment amount. */
|
|
5314
|
+
amount?: Price;
|
|
5244
5315
|
/**
|
|
5245
|
-
*
|
|
5246
|
-
*
|
|
5247
|
-
*
|
|
5316
|
+
* Whether refunds for this payment are disabled.
|
|
5317
|
+
* + `true`: This payment is not refundable.
|
|
5318
|
+
* + `false`: This payment may be refunded. However, this ultimately depends on the payment provider.
|
|
5248
5319
|
*/
|
|
5249
|
-
|
|
5250
|
-
}
|
|
5251
|
-
interface PaymentCapture {
|
|
5320
|
+
refundDisabled?: boolean;
|
|
5252
5321
|
/**
|
|
5253
|
-
*
|
|
5254
|
-
*
|
|
5322
|
+
* Whether receipt generation is allowed for this payment.
|
|
5323
|
+
* + `true`: This payment supports receipt generation.
|
|
5324
|
+
* + `false`: This payment doesn't support receipt generation, or a receipt was already generated.
|
|
5325
|
+
* @readonly
|
|
5255
5326
|
*/
|
|
5256
|
-
|
|
5327
|
+
supportReceiptGeneration?: boolean;
|
|
5328
|
+
/** Details about cash rounding applied to this payment, when relevant. */
|
|
5329
|
+
cashRounding?: CashRoundingDetails;
|
|
5257
5330
|
/**
|
|
5258
|
-
*
|
|
5259
|
-
*
|
|
5331
|
+
* Overall payment status.
|
|
5332
|
+
*
|
|
5333
|
+
* Gift card and membership payments support only `APPROVED`, `PENDING`, `CANCELED`, `DECLINED`, and `VOIDED`. The remaining values apply to regular payments.
|
|
5260
5334
|
*/
|
|
5261
|
-
|
|
5262
|
-
}
|
|
5263
|
-
interface CaptureAuthorizedPaymentsResponse {
|
|
5264
|
-
/** All order's transactions after the capture was triggered */
|
|
5265
|
-
orderTransactions?: OrderTransactions;
|
|
5266
|
-
}
|
|
5267
|
-
interface ChargeSavedPaymentMethodRequest {
|
|
5335
|
+
status?: PaymentStatusWithLiterals;
|
|
5268
5336
|
/**
|
|
5269
|
-
*
|
|
5270
|
-
* @
|
|
5271
|
-
* @maxLength 100
|
|
5337
|
+
* ID linking this payment to the charge request that created it. Matches the `idempotencyKey` sent in the Charge Order request.
|
|
5338
|
+
* @format GUID
|
|
5272
5339
|
*/
|
|
5273
|
-
|
|
5274
|
-
/** Amount to be charged */
|
|
5275
|
-
amount?: Price;
|
|
5340
|
+
chargeCorrelationId?: string | null;
|
|
5276
5341
|
}
|
|
5277
|
-
|
|
5278
|
-
|
|
5279
|
-
|
|
5342
|
+
/** @oneof */
|
|
5343
|
+
interface PaymentPaymentDetailsOneOf {
|
|
5344
|
+
/** Regular payment details. */
|
|
5345
|
+
regularPaymentDetails?: RegularPaymentDetails;
|
|
5346
|
+
/** Gift card payment details. */
|
|
5347
|
+
giftcardPaymentDetails?: GiftCardPaymentDetails;
|
|
5348
|
+
/** Membership payment details. */
|
|
5349
|
+
membershipPaymentDetails?: MembershipPaymentDetails;
|
|
5280
5350
|
}
|
|
5281
|
-
|
|
5282
|
-
|
|
5283
|
-
orderId?: string;
|
|
5351
|
+
/** @oneof */
|
|
5352
|
+
interface PaymentReceiptInfoOneOf {
|
|
5284
5353
|
}
|
|
5285
|
-
|
|
5354
|
+
/** @oneof */
|
|
5355
|
+
interface PaymentStatusDetailsOneOf {
|
|
5286
5356
|
}
|
|
5287
|
-
interface
|
|
5357
|
+
interface RegularPaymentDetails extends RegularPaymentDetailsPaymentMethodDetailsOneOf {
|
|
5358
|
+
/** Credit card details. */
|
|
5359
|
+
creditCardDetails?: CreditCardPaymentMethodDetails;
|
|
5288
5360
|
/**
|
|
5289
|
-
*
|
|
5361
|
+
* Wix Payments order ID.
|
|
5290
5362
|
* @maxLength 100
|
|
5291
5363
|
*/
|
|
5292
|
-
|
|
5293
|
-
}
|
|
5294
|
-
interface SendBuyerPaymentsReceivedEmailResponse {
|
|
5295
|
-
}
|
|
5296
|
-
interface SendBuyerPickupConfirmationEmailRequest {
|
|
5364
|
+
paymentOrderId?: string | null;
|
|
5297
5365
|
/**
|
|
5298
|
-
*
|
|
5366
|
+
* Payment gateway's transaction ID.
|
|
5367
|
+
* This field is only returned when the value of `offline_payment` is `false`.
|
|
5299
5368
|
* @maxLength 100
|
|
5300
5369
|
*/
|
|
5301
|
-
|
|
5302
|
-
}
|
|
5303
|
-
interface SendBuyerPickupConfirmationEmailResponse {
|
|
5304
|
-
}
|
|
5305
|
-
interface BulkSendBuyerPickupConfirmationEmailsRequest {
|
|
5370
|
+
gatewayTransactionId?: string | null;
|
|
5306
5371
|
/**
|
|
5307
|
-
*
|
|
5308
|
-
*
|
|
5309
|
-
*
|
|
5372
|
+
* Payment method.
|
|
5373
|
+
* Deprecated. Use `paymentMethodName.buyerLanguageName` instead.
|
|
5374
|
+
* Non-exhaustive list of supported values:
|
|
5375
|
+
* + `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`
|
|
5376
|
+
* @maxLength 150
|
|
5377
|
+
* @deprecated Payment method.
|
|
5378
|
+
* Deprecated. Use `paymentMethodName.buyerLanguageName` instead.
|
|
5379
|
+
* Non-exhaustive list of supported values:
|
|
5380
|
+
* + `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`
|
|
5381
|
+
* @replacedBy payment_method_name
|
|
5382
|
+
* @targetRemovalDate 2026-07-01
|
|
5310
5383
|
*/
|
|
5311
|
-
|
|
5312
|
-
}
|
|
5313
|
-
interface BulkSendBuyerPickupConfirmationEmailsResponse {
|
|
5314
|
-
}
|
|
5315
|
-
interface SendBuyerShippingConfirmationEmailRequest {
|
|
5384
|
+
paymentMethod?: string | null;
|
|
5316
5385
|
/**
|
|
5317
|
-
*
|
|
5386
|
+
* Transaction ID in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for offline payments.
|
|
5318
5387
|
* @maxLength 100
|
|
5319
5388
|
*/
|
|
5320
|
-
|
|
5321
|
-
|
|
5322
|
-
|
|
5323
|
-
}
|
|
5324
|
-
interface BulkSendBuyerShippingConfirmationEmailsRequest {
|
|
5389
|
+
providerTransactionId?: string | null;
|
|
5390
|
+
/** Whether the payment was made offline. For example, when using cash or when marked as paid in the Business Manager. */
|
|
5391
|
+
offlinePayment?: boolean;
|
|
5325
5392
|
/**
|
|
5326
|
-
*
|
|
5327
|
-
* @
|
|
5328
|
-
* @
|
|
5393
|
+
* Payment status.
|
|
5394
|
+
* @deprecated Payment status.
|
|
5395
|
+
* @replacedBy payment.status
|
|
5396
|
+
* @targetRemovalDate 2026-11-01
|
|
5329
5397
|
*/
|
|
5330
|
-
|
|
5398
|
+
status?: TransactionStatusWithLiterals;
|
|
5399
|
+
/** Whether there is a payment agreement that allows for future charges. */
|
|
5400
|
+
savedPaymentMethod?: boolean;
|
|
5401
|
+
/** Authorization details. */
|
|
5402
|
+
authorizationDetails?: AuthorizationDetails;
|
|
5403
|
+
/**
|
|
5404
|
+
* Record of chargebacks made by the buyer.
|
|
5405
|
+
* @maxSize 6
|
|
5406
|
+
*/
|
|
5407
|
+
chargebacks?: Chargeback[];
|
|
5408
|
+
/** Platform fee amount associated with this payment. */
|
|
5409
|
+
platformFee?: Price;
|
|
5410
|
+
/**
|
|
5411
|
+
* Payment method with buyer and optional owner translations.
|
|
5412
|
+
* Non-exhaustive list of supported values:
|
|
5413
|
+
* + `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`
|
|
5414
|
+
*/
|
|
5415
|
+
paymentMethodName?: PaymentMethodName;
|
|
5331
5416
|
}
|
|
5332
|
-
|
|
5417
|
+
/** @oneof */
|
|
5418
|
+
interface RegularPaymentDetailsPaymentMethodDetailsOneOf {
|
|
5419
|
+
/** Credit card details. */
|
|
5420
|
+
creditCardDetails?: CreditCardPaymentMethodDetails;
|
|
5333
5421
|
}
|
|
5334
|
-
|
|
5422
|
+
declare enum TransactionStatus {
|
|
5423
|
+
UNDEFINED = "UNDEFINED",
|
|
5424
|
+
APPROVED = "APPROVED",
|
|
5425
|
+
PENDING = "PENDING",
|
|
5426
|
+
PENDING_MERCHANT = "PENDING_MERCHANT",
|
|
5427
|
+
CANCELED = "CANCELED",
|
|
5428
|
+
DECLINED = "DECLINED",
|
|
5429
|
+
REFUNDED = "REFUNDED",
|
|
5430
|
+
PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
|
|
5431
|
+
AUTHORIZED = "AUTHORIZED",
|
|
5432
|
+
VOIDED = "VOIDED"
|
|
5433
|
+
}
|
|
5434
|
+
/** @enumType */
|
|
5435
|
+
type TransactionStatusWithLiterals = TransactionStatus | 'UNDEFINED' | 'APPROVED' | 'PENDING' | 'PENDING_MERCHANT' | 'CANCELED' | 'DECLINED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'AUTHORIZED' | 'VOIDED';
|
|
5436
|
+
interface CreditCardPaymentMethodDetails {
|
|
5335
5437
|
/**
|
|
5336
|
-
*
|
|
5438
|
+
* The last 4 digits of the card number.
|
|
5439
|
+
* @maxLength 4
|
|
5440
|
+
*/
|
|
5441
|
+
lastFourDigits?: string | null;
|
|
5442
|
+
/**
|
|
5443
|
+
* Card issuer's brand.
|
|
5337
5444
|
* @maxLength 100
|
|
5338
5445
|
*/
|
|
5339
|
-
|
|
5340
|
-
}
|
|
5341
|
-
interface SendMerchantOrderReceivedNotificationResponse {
|
|
5446
|
+
brand?: string | null;
|
|
5342
5447
|
}
|
|
5343
|
-
interface
|
|
5448
|
+
interface AuthorizationDetails {
|
|
5344
5449
|
/**
|
|
5345
|
-
*
|
|
5346
|
-
* @
|
|
5347
|
-
* @maxLength 100
|
|
5450
|
+
* Whether the authorized payment is of a delayed capture.
|
|
5451
|
+
* @readonly
|
|
5348
5452
|
*/
|
|
5349
|
-
|
|
5453
|
+
delayedCapture?: boolean;
|
|
5454
|
+
/** Date and time the payment was authorized in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
5455
|
+
authorizedDate?: Date | null;
|
|
5350
5456
|
/**
|
|
5351
|
-
*
|
|
5352
|
-
*
|
|
5353
|
-
* @
|
|
5457
|
+
* List of captures associated with payment
|
|
5458
|
+
* In case of failed it can be replaced with new one with PENDING or SUCCESS statuses
|
|
5459
|
+
* @maxSize 1
|
|
5354
5460
|
*/
|
|
5355
|
-
|
|
5356
|
-
/**
|
|
5357
|
-
|
|
5461
|
+
captures?: AuthorizationCapture[];
|
|
5462
|
+
/** Void associated with payment */
|
|
5463
|
+
void?: AuthorizationVoid;
|
|
5464
|
+
/** Scheduled action for this transaction */
|
|
5465
|
+
scheduledAction?: V1ScheduledAction;
|
|
5466
|
+
}
|
|
5467
|
+
interface AuthorizationCapture {
|
|
5358
5468
|
/**
|
|
5359
|
-
*
|
|
5469
|
+
* Capture ID.
|
|
5360
5470
|
* @format GUID
|
|
5471
|
+
* @readonly
|
|
5361
5472
|
*/
|
|
5362
|
-
|
|
5473
|
+
id?: string | null;
|
|
5474
|
+
/** Status of this capture action */
|
|
5475
|
+
status?: AuthorizationCaptureStatusWithLiterals;
|
|
5476
|
+
/**
|
|
5477
|
+
* Amount of this capture
|
|
5478
|
+
* @immutable
|
|
5479
|
+
*/
|
|
5480
|
+
amount?: Price;
|
|
5481
|
+
/** Date and time the capture was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
5482
|
+
createdDate?: Date | null;
|
|
5483
|
+
/** In case of status is FAILED may contain failure details */
|
|
5484
|
+
failureDetails?: AuthorizationActionFailureDetails;
|
|
5485
|
+
}
|
|
5486
|
+
declare enum AuthorizationCaptureStatus {
|
|
5487
|
+
/** Capture operation still in progress. */
|
|
5488
|
+
PENDING = "PENDING",
|
|
5489
|
+
/** Capture operation succeeded. */
|
|
5490
|
+
SUCCEEDED = "SUCCEEDED",
|
|
5491
|
+
/** Capture operation failed. */
|
|
5492
|
+
FAILED = "FAILED"
|
|
5493
|
+
}
|
|
5494
|
+
/** @enumType */
|
|
5495
|
+
type AuthorizationCaptureStatusWithLiterals = AuthorizationCaptureStatus | 'PENDING' | 'SUCCEEDED' | 'FAILED';
|
|
5496
|
+
interface AuthorizationActionFailureDetails {
|
|
5497
|
+
/** @maxLength 100 */
|
|
5498
|
+
failureCode?: string;
|
|
5499
|
+
}
|
|
5500
|
+
interface AuthorizationVoid {
|
|
5501
|
+
/** Status of this void action */
|
|
5502
|
+
status?: AuthorizationVoidStatusWithLiterals;
|
|
5503
|
+
/** Date and time the void was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
|
|
5504
|
+
voidedDate?: Date | null;
|
|
5505
|
+
/** In case of status is FAILED may contain failure details */
|
|
5506
|
+
failureDetails?: AuthorizationActionFailureDetails;
|
|
5507
|
+
/** Reason of void action */
|
|
5508
|
+
reason?: ReasonWithLiterals;
|
|
5509
|
+
}
|
|
5510
|
+
declare enum AuthorizationVoidStatus {
|
|
5511
|
+
/** Void operation still in progress. */
|
|
5512
|
+
PENDING = "PENDING",
|
|
5513
|
+
/** Void operation succeeded. */
|
|
5514
|
+
SUCCEEDED = "SUCCEEDED",
|
|
5515
|
+
/** Void operation failed. */
|
|
5516
|
+
FAILED = "FAILED"
|
|
5517
|
+
}
|
|
5518
|
+
/** @enumType */
|
|
5519
|
+
type AuthorizationVoidStatusWithLiterals = AuthorizationVoidStatus | 'PENDING' | 'SUCCEEDED' | 'FAILED';
|
|
5520
|
+
/** Reason the authorization was voided. */
|
|
5521
|
+
declare enum Reason {
|
|
5522
|
+
/** Authorization was voided by user. */
|
|
5523
|
+
MANUAL = "MANUAL",
|
|
5524
|
+
/** Authorization passed execution date. */
|
|
5525
|
+
SCHEDULED = "SCHEDULED"
|
|
5363
5526
|
}
|
|
5364
|
-
|
|
5527
|
+
/** @enumType */
|
|
5528
|
+
type ReasonWithLiterals = Reason | 'MANUAL' | 'SCHEDULED';
|
|
5529
|
+
interface V1ScheduledAction {
|
|
5530
|
+
/** Type of the action. */
|
|
5531
|
+
actionType?: ActionTypeWithLiterals;
|
|
5532
|
+
/** The date and time of the action. */
|
|
5533
|
+
executionDate?: Date | null;
|
|
5365
5534
|
}
|
|
5366
|
-
|
|
5535
|
+
declare enum ActionType {
|
|
5536
|
+
VOID = "VOID",
|
|
5537
|
+
CAPTURE = "CAPTURE"
|
|
5538
|
+
}
|
|
5539
|
+
/** @enumType */
|
|
5540
|
+
type ActionTypeWithLiterals = ActionType | 'VOID' | 'CAPTURE';
|
|
5541
|
+
interface Chargeback {
|
|
5367
5542
|
/**
|
|
5368
|
-
*
|
|
5543
|
+
* Chargeback ID.
|
|
5369
5544
|
* @format GUID
|
|
5545
|
+
* @readonly
|
|
5546
|
+
* @immutable
|
|
5370
5547
|
*/
|
|
5371
|
-
|
|
5548
|
+
id?: string;
|
|
5372
5549
|
/**
|
|
5373
|
-
*
|
|
5374
|
-
* @
|
|
5550
|
+
* Date and time the chargeback 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.
|
|
5551
|
+
* @readonly
|
|
5552
|
+
* @immutable
|
|
5375
5553
|
*/
|
|
5376
|
-
|
|
5554
|
+
createdDate?: Date | null;
|
|
5377
5555
|
/**
|
|
5378
|
-
*
|
|
5379
|
-
* @
|
|
5380
|
-
* @maxLength 1000
|
|
5556
|
+
* Date and time the chargeback was updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Defaults to current time when not provided.
|
|
5557
|
+
* @readonly
|
|
5381
5558
|
*/
|
|
5382
|
-
|
|
5383
|
-
}
|
|
5384
|
-
interface SendRefundEmailResponse {
|
|
5385
|
-
}
|
|
5386
|
-
interface SendFulfillmentEmailRequest {
|
|
5387
|
-
/** @format GUID */
|
|
5388
|
-
orderId?: string;
|
|
5389
|
-
/** @format GUID */
|
|
5390
|
-
fulfillerId?: string;
|
|
5391
|
-
}
|
|
5392
|
-
interface SendFulfillmentEmailResponse {
|
|
5393
|
-
}
|
|
5394
|
-
interface SendMerchantOrderReceivedPushRequest {
|
|
5559
|
+
updatedDate?: Date | null;
|
|
5395
5560
|
/**
|
|
5396
|
-
*
|
|
5397
|
-
* @
|
|
5561
|
+
* Amount.
|
|
5562
|
+
* @readonly
|
|
5563
|
+
* @immutable
|
|
5398
5564
|
*/
|
|
5399
|
-
|
|
5400
|
-
}
|
|
5401
|
-
interface SendMerchantOrderReceivedPushResponse {
|
|
5402
|
-
}
|
|
5403
|
-
interface PreviewEmailByTypeRequest {
|
|
5404
|
-
emailType?: PreviewEmailTypeWithLiterals;
|
|
5405
|
-
}
|
|
5406
|
-
declare enum PreviewEmailType {
|
|
5407
|
-
ORDER_PLACED = "ORDER_PLACED",
|
|
5408
|
-
DOWNLOAD_LINKS = "DOWNLOAD_LINKS",
|
|
5409
|
-
ORDER_SHIPPED = "ORDER_SHIPPED",
|
|
5410
|
-
ORDER_READY_FOR_PICKUP = "ORDER_READY_FOR_PICKUP"
|
|
5411
|
-
}
|
|
5412
|
-
/** @enumType */
|
|
5413
|
-
type PreviewEmailTypeWithLiterals = PreviewEmailType | 'ORDER_PLACED' | 'DOWNLOAD_LINKS' | 'ORDER_SHIPPED' | 'ORDER_READY_FOR_PICKUP';
|
|
5414
|
-
interface PreviewEmailByTypeResponse {
|
|
5415
|
-
emailPreview?: string;
|
|
5416
|
-
}
|
|
5417
|
-
interface PreviewRefundEmailRequest {
|
|
5565
|
+
amount?: Price;
|
|
5418
5566
|
/**
|
|
5419
|
-
*
|
|
5420
|
-
* @
|
|
5567
|
+
* Reversal amount. Present only when status is REVERSED.
|
|
5568
|
+
* @readonly
|
|
5421
5569
|
*/
|
|
5422
|
-
|
|
5423
|
-
/** Refund amount */
|
|
5424
|
-
refundAmount?: Price;
|
|
5425
|
-
/** Refund business details */
|
|
5426
|
-
details?: RefundDetails;
|
|
5570
|
+
reversalAmount?: Price;
|
|
5427
5571
|
/**
|
|
5428
|
-
*
|
|
5429
|
-
*
|
|
5430
|
-
*
|
|
5572
|
+
* Status.
|
|
5573
|
+
*
|
|
5574
|
+
* Default: `"APPROVED"`.
|
|
5431
5575
|
*/
|
|
5432
|
-
|
|
5576
|
+
status?: ChargebackStatusWithLiterals;
|
|
5433
5577
|
/**
|
|
5434
|
-
*
|
|
5578
|
+
* External chargeback ID.
|
|
5435
5579
|
* @format GUID
|
|
5580
|
+
* @readonly
|
|
5581
|
+
* @immutable
|
|
5436
5582
|
*/
|
|
5437
|
-
|
|
5583
|
+
externalId?: string | null;
|
|
5438
5584
|
}
|
|
5439
|
-
|
|
5440
|
-
|
|
5585
|
+
declare enum ChargebackStatus {
|
|
5586
|
+
/** Chargeback was approved. */
|
|
5587
|
+
APPROVED = "APPROVED",
|
|
5588
|
+
/** Chargeback was reversed. */
|
|
5589
|
+
REVERSED = "REVERSED"
|
|
5441
5590
|
}
|
|
5442
|
-
|
|
5591
|
+
/** @enumType */
|
|
5592
|
+
type ChargebackStatusWithLiterals = ChargebackStatus | 'APPROVED' | 'REVERSED';
|
|
5593
|
+
interface PaymentMethodName {
|
|
5443
5594
|
/**
|
|
5444
|
-
*
|
|
5445
|
-
* @maxLength
|
|
5595
|
+
* Translated payment method name in buyer language.
|
|
5596
|
+
* @maxLength 150
|
|
5446
5597
|
*/
|
|
5447
|
-
|
|
5598
|
+
buyerLanguageName?: string | null;
|
|
5448
5599
|
/**
|
|
5449
|
-
*
|
|
5450
|
-
* @
|
|
5451
|
-
* @maxLength 1000
|
|
5600
|
+
* Translated payment method name in site owner language.
|
|
5601
|
+
* @maxLength 150
|
|
5452
5602
|
*/
|
|
5453
|
-
|
|
5454
|
-
}
|
|
5455
|
-
interface PreviewCancelEmailResponse {
|
|
5456
|
-
emailPreview?: string;
|
|
5457
|
-
}
|
|
5458
|
-
interface PreviewCancelRefundEmailRequest {
|
|
5603
|
+
siteLanguageName?: string | null;
|
|
5459
5604
|
/**
|
|
5460
|
-
*
|
|
5461
|
-
*
|
|
5605
|
+
* User-provided payment method name.
|
|
5606
|
+
*
|
|
5607
|
+
* When set, takes precedence over `buyerLanguageName` and `siteLanguageName`.
|
|
5462
5608
|
*/
|
|
5463
|
-
|
|
5609
|
+
userDefinedName?: UserDefinedPaymentMethodName;
|
|
5610
|
+
}
|
|
5611
|
+
interface GiftCardPaymentDetails {
|
|
5464
5612
|
/**
|
|
5465
|
-
*
|
|
5466
|
-
* @
|
|
5467
|
-
* @maxLength 1000
|
|
5613
|
+
* Gift card payment ID.
|
|
5614
|
+
* @maxLength 100
|
|
5468
5615
|
*/
|
|
5469
|
-
|
|
5470
|
-
/** Refund amount */
|
|
5471
|
-
refundAmount?: Price;
|
|
5616
|
+
giftCardPaymentId?: string;
|
|
5472
5617
|
/**
|
|
5473
|
-
*
|
|
5618
|
+
* ID of the app that created the gift card.
|
|
5474
5619
|
* @format GUID
|
|
5475
5620
|
*/
|
|
5476
|
-
|
|
5477
|
-
}
|
|
5478
|
-
interface PreviewCancelRefundEmailResponse {
|
|
5479
|
-
emailPreview?: string;
|
|
5480
|
-
}
|
|
5481
|
-
interface PreviewBuyerPaymentsReceivedEmailRequest {
|
|
5482
|
-
}
|
|
5483
|
-
interface PreviewBuyerPaymentsReceivedEmailResponse {
|
|
5484
|
-
emailPreview?: string;
|
|
5485
|
-
}
|
|
5486
|
-
interface PreviewBuyerConfirmationEmailRequest {
|
|
5487
|
-
}
|
|
5488
|
-
interface PreviewBuyerConfirmationEmailResponse {
|
|
5489
|
-
emailPreview?: string;
|
|
5490
|
-
}
|
|
5491
|
-
interface PreviewBuyerPickupConfirmationEmailRequest {
|
|
5492
|
-
}
|
|
5493
|
-
interface PreviewBuyerPickupConfirmationEmailResponse {
|
|
5494
|
-
emailPreview?: string;
|
|
5495
|
-
}
|
|
5496
|
-
interface PreviewShippingConfirmationEmailRequest {
|
|
5497
|
-
}
|
|
5498
|
-
interface PreviewShippingConfirmationEmailResponse {
|
|
5499
|
-
emailPreview?: string;
|
|
5500
|
-
}
|
|
5501
|
-
interface PreviewResendDownloadLinksEmailRequest {
|
|
5502
|
-
}
|
|
5503
|
-
interface PreviewResendDownloadLinksEmailResponse {
|
|
5504
|
-
emailPreview?: string;
|
|
5505
|
-
}
|
|
5506
|
-
interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {
|
|
5507
|
-
/** Emitted on a meta site creation. */
|
|
5508
|
-
siteCreated?: SiteCreated;
|
|
5509
|
-
/** Emitted on a meta site transfer completion. */
|
|
5510
|
-
siteTransferred?: SiteTransferred;
|
|
5511
|
-
/** Emitted on a meta site deletion. */
|
|
5512
|
-
siteDeleted?: SiteDeleted;
|
|
5513
|
-
/** Emitted on a meta site restoration. */
|
|
5514
|
-
siteUndeleted?: SiteUndeleted;
|
|
5515
|
-
/** Emitted on the first* publish of the meta site (* switching from unpublished to published state). */
|
|
5516
|
-
sitePublished?: SitePublished;
|
|
5517
|
-
/** Emitted on a meta site unpublish. */
|
|
5518
|
-
siteUnpublished?: SiteUnpublished;
|
|
5519
|
-
/** Emitted when meta site is marked as template. */
|
|
5520
|
-
siteMarkedAsTemplate?: SiteMarkedAsTemplate;
|
|
5521
|
-
/** Emitted when meta site is marked as a WixSite. */
|
|
5522
|
-
siteMarkedAsWixSite?: SiteMarkedAsWixSite;
|
|
5523
|
-
/** Emitted when an application is provisioned (installed). */
|
|
5524
|
-
serviceProvisioned?: ServiceProvisioned;
|
|
5525
|
-
/** Emitted when an application is removed (uninstalled). */
|
|
5526
|
-
serviceRemoved?: ServiceRemoved;
|
|
5527
|
-
/** Emitted when meta site name (URL slug) is changed. */
|
|
5528
|
-
siteRenamedPayload?: SiteRenamed;
|
|
5529
|
-
/** Emitted when meta site was permanently deleted. */
|
|
5530
|
-
hardDeleted?: SiteHardDeleted;
|
|
5531
|
-
/** Emitted on a namespace change. */
|
|
5532
|
-
namespaceChanged?: NamespaceChanged;
|
|
5533
|
-
/** Emitted when Studio is attached. */
|
|
5534
|
-
studioAssigned?: StudioAssigned;
|
|
5535
|
-
/** Emitted when Studio is detached. */
|
|
5536
|
-
studioUnassigned?: StudioUnassigned;
|
|
5537
|
-
/**
|
|
5538
|
-
* Emitted when one of the URLs is changed. After this event you may call `urls-server` to fetch
|
|
5539
|
-
* the actual URL.
|
|
5540
|
-
*
|
|
5541
|
-
* See: https://wix.slack.com/archives/C0UHEBPFT/p1732520791210559?thread_ts=1732027914.294059&cid=C0UHEBPFT
|
|
5542
|
-
* See: https://wix.slack.com/archives/C0UHEBPFT/p1744115197619459
|
|
5543
|
-
*/
|
|
5544
|
-
urlChanged?: SiteUrlChanged;
|
|
5545
|
-
/** Site is marked as PurgedExternally */
|
|
5546
|
-
sitePurgedExternally?: SitePurgedExternally;
|
|
5547
|
-
/** Emitted when Odeditor is attached. */
|
|
5548
|
-
odeditorAssigned?: OdeditorAssigned;
|
|
5549
|
-
/** Emitted when Odeditor is detached. */
|
|
5550
|
-
odeditorUnassigned?: OdeditorUnassigned;
|
|
5551
|
-
/** Emitted when Picasso is attached. */
|
|
5552
|
-
picassoAssigned?: PicassoAssigned;
|
|
5553
|
-
/** Emitted when Picasso is detached. */
|
|
5554
|
-
picassoUnassigned?: PicassoUnassigned;
|
|
5555
|
-
/** Emitted when Wixel is attached. */
|
|
5556
|
-
wixelAssigned?: WixelAssigned;
|
|
5557
|
-
/** Emitted when Wixel is detached. */
|
|
5558
|
-
wixelUnassigned?: WixelUnassigned;
|
|
5559
|
-
/** Emitted when StudioTwo is attached. */
|
|
5560
|
-
studioTwoAssigned?: StudioTwoAssigned;
|
|
5561
|
-
/** Emitted when StudioTwo is detached. */
|
|
5562
|
-
studioTwoUnassigned?: StudioTwoUnassigned;
|
|
5563
|
-
/** Emitted when media from user domain is enabled. */
|
|
5564
|
-
userDomainMediaEnabled?: UserDomainMediaEnabled;
|
|
5565
|
-
/** Emitted when media from user domain is disabled. */
|
|
5566
|
-
userDomainMediaDisabled?: UserDomainMediaDisabled;
|
|
5567
|
-
/** Emitted when Editorless is attached. */
|
|
5568
|
-
editorlessAssigned?: EditorlessAssigned;
|
|
5569
|
-
/** Emitted when Editorless is detached. */
|
|
5570
|
-
editorlessUnassigned?: EditorlessUnassigned;
|
|
5621
|
+
appId?: string;
|
|
5571
5622
|
/**
|
|
5572
|
-
*
|
|
5573
|
-
* @
|
|
5623
|
+
* Whether the gift card is voided.
|
|
5624
|
+
* @readonly
|
|
5625
|
+
* @deprecated Whether the gift card is voided.
|
|
5626
|
+
* @replacedBy payment.status
|
|
5627
|
+
* @targetRemovalDate 2026-11-01
|
|
5574
5628
|
*/
|
|
5575
|
-
|
|
5576
|
-
/** A meta site version. Monotonically increasing. */
|
|
5577
|
-
version?: string;
|
|
5578
|
-
/** A timestamp of the event. */
|
|
5579
|
-
timestamp?: string;
|
|
5629
|
+
voided?: boolean;
|
|
5580
5630
|
/**
|
|
5581
|
-
*
|
|
5582
|
-
*
|
|
5583
|
-
* @
|
|
5631
|
+
* Gift card code with all but the last four characters masked. For example, `************QXY1`.
|
|
5632
|
+
* @maxLength 30
|
|
5633
|
+
* @immutable
|
|
5584
5634
|
*/
|
|
5585
|
-
|
|
5635
|
+
obfuscatedCode?: string | null;
|
|
5586
5636
|
}
|
|
5587
|
-
|
|
5588
|
-
interface MetaSiteSpecialEventPayloadOneOf {
|
|
5589
|
-
/** Emitted on a meta site creation. */
|
|
5590
|
-
siteCreated?: SiteCreated;
|
|
5591
|
-
/** Emitted on a meta site transfer completion. */
|
|
5592
|
-
siteTransferred?: SiteTransferred;
|
|
5593
|
-
/** Emitted on a meta site deletion. */
|
|
5594
|
-
siteDeleted?: SiteDeleted;
|
|
5595
|
-
/** Emitted on a meta site restoration. */
|
|
5596
|
-
siteUndeleted?: SiteUndeleted;
|
|
5597
|
-
/** Emitted on the first* publish of the meta site (* switching from unpublished to published state). */
|
|
5598
|
-
sitePublished?: SitePublished;
|
|
5599
|
-
/** Emitted on a meta site unpublish. */
|
|
5600
|
-
siteUnpublished?: SiteUnpublished;
|
|
5601
|
-
/** Emitted when meta site is marked as template. */
|
|
5602
|
-
siteMarkedAsTemplate?: SiteMarkedAsTemplate;
|
|
5603
|
-
/** Emitted when meta site is marked as a WixSite. */
|
|
5604
|
-
siteMarkedAsWixSite?: SiteMarkedAsWixSite;
|
|
5605
|
-
/** Emitted when an application is provisioned (installed). */
|
|
5606
|
-
serviceProvisioned?: ServiceProvisioned;
|
|
5607
|
-
/** Emitted when an application is removed (uninstalled). */
|
|
5608
|
-
serviceRemoved?: ServiceRemoved;
|
|
5609
|
-
/** Emitted when meta site name (URL slug) is changed. */
|
|
5610
|
-
siteRenamedPayload?: SiteRenamed;
|
|
5611
|
-
/** Emitted when meta site was permanently deleted. */
|
|
5612
|
-
hardDeleted?: SiteHardDeleted;
|
|
5613
|
-
/** Emitted on a namespace change. */
|
|
5614
|
-
namespaceChanged?: NamespaceChanged;
|
|
5615
|
-
/** Emitted when Studio is attached. */
|
|
5616
|
-
studioAssigned?: StudioAssigned;
|
|
5617
|
-
/** Emitted when Studio is detached. */
|
|
5618
|
-
studioUnassigned?: StudioUnassigned;
|
|
5637
|
+
interface MembershipPaymentDetails {
|
|
5619
5638
|
/**
|
|
5620
|
-
*
|
|
5621
|
-
*
|
|
5622
|
-
*
|
|
5623
|
-
* See: https://wix.slack.com/archives/C0UHEBPFT/p1732520791210559?thread_ts=1732027914.294059&cid=C0UHEBPFT
|
|
5624
|
-
* See: https://wix.slack.com/archives/C0UHEBPFT/p1744115197619459
|
|
5639
|
+
* Membership ID.
|
|
5640
|
+
* @maxLength 200
|
|
5625
5641
|
*/
|
|
5626
|
-
|
|
5627
|
-
/** Site is marked as PurgedExternally */
|
|
5628
|
-
sitePurgedExternally?: SitePurgedExternally;
|
|
5629
|
-
/** Emitted when Odeditor is attached. */
|
|
5630
|
-
odeditorAssigned?: OdeditorAssigned;
|
|
5631
|
-
/** Emitted when Odeditor is detached. */
|
|
5632
|
-
odeditorUnassigned?: OdeditorUnassigned;
|
|
5633
|
-
/** Emitted when Picasso is attached. */
|
|
5634
|
-
picassoAssigned?: PicassoAssigned;
|
|
5635
|
-
/** Emitted when Picasso is detached. */
|
|
5636
|
-
picassoUnassigned?: PicassoUnassigned;
|
|
5637
|
-
/** Emitted when Wixel is attached. */
|
|
5638
|
-
wixelAssigned?: WixelAssigned;
|
|
5639
|
-
/** Emitted when Wixel is detached. */
|
|
5640
|
-
wixelUnassigned?: WixelUnassigned;
|
|
5641
|
-
/** Emitted when StudioTwo is attached. */
|
|
5642
|
-
studioTwoAssigned?: StudioTwoAssigned;
|
|
5643
|
-
/** Emitted when StudioTwo is detached. */
|
|
5644
|
-
studioTwoUnassigned?: StudioTwoUnassigned;
|
|
5645
|
-
/** Emitted when media from user domain is enabled. */
|
|
5646
|
-
userDomainMediaEnabled?: UserDomainMediaEnabled;
|
|
5647
|
-
/** Emitted when media from user domain is disabled. */
|
|
5648
|
-
userDomainMediaDisabled?: UserDomainMediaDisabled;
|
|
5649
|
-
/** Emitted when Editorless is attached. */
|
|
5650
|
-
editorlessAssigned?: EditorlessAssigned;
|
|
5651
|
-
/** Emitted when Editorless is detached. */
|
|
5652
|
-
editorlessUnassigned?: EditorlessUnassigned;
|
|
5653
|
-
}
|
|
5654
|
-
interface Asset {
|
|
5642
|
+
membershipId?: string;
|
|
5655
5643
|
/**
|
|
5656
|
-
*
|
|
5657
|
-
* @
|
|
5644
|
+
* ID of the line item this membership applies to.
|
|
5645
|
+
* @minLength 1
|
|
5646
|
+
* @maxLength 100
|
|
5658
5647
|
*/
|
|
5659
|
-
|
|
5648
|
+
lineItemId?: string;
|
|
5660
5649
|
/**
|
|
5661
|
-
*
|
|
5662
|
-
* @
|
|
5650
|
+
* Payment status.
|
|
5651
|
+
* @deprecated Payment status.
|
|
5652
|
+
* @replacedBy payment.status
|
|
5653
|
+
* @targetRemovalDate 2026-11-01
|
|
5663
5654
|
*/
|
|
5664
|
-
|
|
5665
|
-
/**
|
|
5666
|
-
|
|
5655
|
+
status?: MembershipPaymentStatusWithLiterals;
|
|
5656
|
+
/** Membership name. */
|
|
5657
|
+
name?: MembershipName;
|
|
5658
|
+
/**
|
|
5659
|
+
* The transaction ID in the membership system. Can be used to void the transaction.
|
|
5660
|
+
* @minLength 1
|
|
5661
|
+
* @maxLength 100
|
|
5662
|
+
*/
|
|
5663
|
+
externalTransactionId?: string | null;
|
|
5664
|
+
/**
|
|
5665
|
+
* Whether the membership is voided.
|
|
5666
|
+
* @readonly
|
|
5667
|
+
* @deprecated Whether the membership is voided.
|
|
5668
|
+
* @replacedBy payment.status
|
|
5669
|
+
* @targetRemovalDate 2026-11-01
|
|
5670
|
+
*/
|
|
5671
|
+
voided?: boolean;
|
|
5672
|
+
/**
|
|
5673
|
+
* ID of the application providing this payment option.
|
|
5674
|
+
* @format GUID
|
|
5675
|
+
*/
|
|
5676
|
+
providerAppId?: string;
|
|
5677
|
+
/** Details of a membership that does not yet exist, allowing the payment to be held before the membership is created. */
|
|
5678
|
+
futureMembership?: FutureMembershipDetails;
|
|
5667
5679
|
}
|
|
5668
|
-
declare enum
|
|
5669
|
-
|
|
5670
|
-
|
|
5671
|
-
|
|
5672
|
-
|
|
5673
|
-
|
|
5680
|
+
declare enum MembershipPaymentStatus {
|
|
5681
|
+
/** Payment was charged. */
|
|
5682
|
+
CHARGED = "CHARGED",
|
|
5683
|
+
/** The attempt to charge the payment failed, for example, due to lack of credits. */
|
|
5684
|
+
CHARGE_FAILED = "CHARGE_FAILED",
|
|
5685
|
+
/** Payment is pending. */
|
|
5686
|
+
CHARGE_PENDING = "CHARGE_PENDING",
|
|
5687
|
+
/** Payment was voided. */
|
|
5688
|
+
VOIDED = "VOIDED"
|
|
5674
5689
|
}
|
|
5675
5690
|
/** @enumType */
|
|
5676
|
-
type
|
|
5677
|
-
interface
|
|
5691
|
+
type MembershipPaymentStatusWithLiterals = MembershipPaymentStatus | 'CHARGED' | 'CHARGE_FAILED' | 'CHARGE_PENDING' | 'VOIDED';
|
|
5692
|
+
interface FutureMembershipDetails {
|
|
5678
5693
|
/**
|
|
5679
|
-
*
|
|
5680
|
-
* @
|
|
5694
|
+
* ID of the plan line item in the order from which the membership will be created.
|
|
5695
|
+
* @format GUID
|
|
5681
5696
|
*/
|
|
5682
|
-
|
|
5697
|
+
lineItemId?: string;
|
|
5683
5698
|
/**
|
|
5684
|
-
*
|
|
5685
|
-
* @
|
|
5699
|
+
* ID of the benefit the future membership will grant.
|
|
5700
|
+
* @maxLength 200
|
|
5686
5701
|
*/
|
|
5687
|
-
|
|
5688
|
-
|
|
5689
|
-
|
|
5702
|
+
benefitId?: string;
|
|
5703
|
+
}
|
|
5704
|
+
interface WixReceiptInfo {
|
|
5690
5705
|
/**
|
|
5691
|
-
*
|
|
5692
|
-
*
|
|
5693
|
-
* In case of a creation from a template it's a template id.
|
|
5694
|
-
* In case of a site duplication ("Save As" in dashboard or duplicate in UM) it's an id of a source site.
|
|
5706
|
+
* Receipt ID
|
|
5695
5707
|
* @format GUID
|
|
5696
5708
|
*/
|
|
5697
|
-
|
|
5709
|
+
receiptId?: string;
|
|
5698
5710
|
/**
|
|
5699
|
-
*
|
|
5700
|
-
* @
|
|
5711
|
+
* Display number of receipt
|
|
5712
|
+
* @minLength 1
|
|
5713
|
+
* @maxLength 40
|
|
5701
5714
|
*/
|
|
5702
|
-
|
|
5703
|
-
/** A namespace. */
|
|
5704
|
-
namespace?: NamespaceWithLiterals;
|
|
5705
|
-
}
|
|
5706
|
-
declare enum SiteCreatedContext {
|
|
5707
|
-
/** A valid option, we don't expose all reasons why site might be created. */
|
|
5708
|
-
OTHER = "OTHER",
|
|
5709
|
-
/** A meta site was created from template. */
|
|
5710
|
-
FROM_TEMPLATE = "FROM_TEMPLATE",
|
|
5711
|
-
/** A meta site was created by copying of the transfferred meta site. */
|
|
5712
|
-
DUPLICATE_BY_SITE_TRANSFER = "DUPLICATE_BY_SITE_TRANSFER",
|
|
5713
|
-
/** A copy of existing meta site. */
|
|
5714
|
-
DUPLICATE = "DUPLICATE",
|
|
5715
|
-
/** A meta site was created as a transfferred site (copy of the original), old flow, should die soon. */
|
|
5716
|
-
OLD_SITE_TRANSFER = "OLD_SITE_TRANSFER",
|
|
5717
|
-
/** deprecated A meta site was created for Flash editor. */
|
|
5718
|
-
FLASH = "FLASH"
|
|
5715
|
+
displayNumber?: string | null;
|
|
5719
5716
|
}
|
|
5720
|
-
|
|
5721
|
-
type SiteCreatedContextWithLiterals = SiteCreatedContext | 'OTHER' | 'FROM_TEMPLATE' | 'DUPLICATE_BY_SITE_TRANSFER' | 'DUPLICATE' | 'OLD_SITE_TRANSFER' | 'FLASH';
|
|
5722
|
-
declare enum Namespace {
|
|
5723
|
-
UNKNOWN_NAMESPACE = "UNKNOWN_NAMESPACE",
|
|
5724
|
-
/** Default namespace for UGC sites. MetaSites with this namespace will be shown in a user's site list by default. */
|
|
5725
|
-
WIX = "WIX",
|
|
5726
|
-
/** 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. */
|
|
5727
|
-
SHOUT_OUT = "SHOUT_OUT",
|
|
5728
|
-
/** 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. */
|
|
5729
|
-
ALBUMS = "ALBUMS",
|
|
5730
|
-
/** 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. */
|
|
5731
|
-
WIX_STORES_TEST_DRIVE = "WIX_STORES_TEST_DRIVE",
|
|
5732
|
-
/** Hotels standalone (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5733
|
-
HOTELS = "HOTELS",
|
|
5734
|
-
/** 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. */
|
|
5735
|
-
CLUBS = "CLUBS",
|
|
5736
|
-
/** A partially created ADI website. MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5737
|
-
ONBOARDING_DRAFT = "ONBOARDING_DRAFT",
|
|
5717
|
+
interface ExternalReceiptInfo {
|
|
5738
5718
|
/**
|
|
5739
|
-
*
|
|
5740
|
-
*
|
|
5719
|
+
* External receipt ID
|
|
5720
|
+
* @maxLength 100
|
|
5741
5721
|
*/
|
|
5742
|
-
|
|
5743
|
-
/** 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. */
|
|
5744
|
-
LOGOS = "LOGOS",
|
|
5745
|
-
/** 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. */
|
|
5746
|
-
VIDEO_MAKER = "VIDEO_MAKER",
|
|
5747
|
-
/** MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5748
|
-
PARTNER_DASHBOARD = "PARTNER_DASHBOARD",
|
|
5749
|
-
/** MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5750
|
-
DEV_CENTER_COMPANY = "DEV_CENTER_COMPANY",
|
|
5722
|
+
receiptId?: string | null;
|
|
5751
5723
|
/**
|
|
5752
|
-
*
|
|
5753
|
-
*
|
|
5754
|
-
* Meta site with this namespace will *not* be shown in a user's site list by default.
|
|
5724
|
+
* ID of the app providing the receipt
|
|
5725
|
+
* @format GUID
|
|
5755
5726
|
*/
|
|
5756
|
-
|
|
5727
|
+
appId?: string | null;
|
|
5757
5728
|
/**
|
|
5758
|
-
*
|
|
5759
|
-
*
|
|
5760
|
-
*
|
|
5729
|
+
* Display number of receipt
|
|
5730
|
+
* @minLength 1
|
|
5731
|
+
* @maxLength 40
|
|
5761
5732
|
*/
|
|
5762
|
-
|
|
5763
|
-
|
|
5764
|
-
|
|
5765
|
-
/** It is to be used in the Business First efforts. */
|
|
5766
|
-
DASHBOARD_FIRST = "DASHBOARD_FIRST",
|
|
5767
|
-
/** Bookings business flow with no site. */
|
|
5768
|
-
ANYWHERE = "ANYWHERE",
|
|
5769
|
-
/** Namespace for Headless Backoffice with no editor */
|
|
5770
|
-
HEADLESS = "HEADLESS",
|
|
5733
|
+
displayNumber?: string | null;
|
|
5734
|
+
}
|
|
5735
|
+
interface CashRoundingDetails {
|
|
5771
5736
|
/**
|
|
5772
|
-
*
|
|
5773
|
-
*
|
|
5737
|
+
* Payment amount before cash rounding was applied.
|
|
5738
|
+
* When provided, balance and status calculations use this value instead of `amount`
|
|
5739
|
+
* to prevent false overpayment or underpayment due to rounding.
|
|
5774
5740
|
*/
|
|
5775
|
-
|
|
5776
|
-
/** Rise.ai Siteless account management for Gift Cards and Store Credit. */
|
|
5777
|
-
RISE = "RISE",
|
|
5741
|
+
unroundedAmount?: Price;
|
|
5778
5742
|
/**
|
|
5779
|
-
*
|
|
5780
|
-
*
|
|
5781
|
-
*
|
|
5743
|
+
* The difference between 'amount' and 'unroundedAmount' (amount minus unroundedAmount).
|
|
5744
|
+
* A positive value indicates the price was rounded up; a negative value indicates a round-down.
|
|
5745
|
+
* @readonly
|
|
5782
5746
|
*/
|
|
5783
|
-
|
|
5784
|
-
|
|
5785
|
-
|
|
5747
|
+
roundingAdjustment?: CashRounding;
|
|
5748
|
+
}
|
|
5749
|
+
declare enum PaymentStatus {
|
|
5750
|
+
/** Payment was charged successfully. */
|
|
5751
|
+
APPROVED = "APPROVED",
|
|
5752
|
+
/** Payment is being processed and hasn't been confirmed yet. */
|
|
5753
|
+
PENDING = "PENDING",
|
|
5754
|
+
/** Payment is awaiting confirmation. For an offline payment, the merchant must confirm they received it. For an online payment, the payment provider hasn't confirmed it, which typically means the merchant's provider account setup isn't complete. */
|
|
5755
|
+
PENDING_MERCHANT = "PENDING_MERCHANT",
|
|
5756
|
+
/** Payment was canceled before it was charged. */
|
|
5757
|
+
CANCELED = "CANCELED",
|
|
5758
|
+
/** Payment was declined by the payment provider. */
|
|
5759
|
+
DECLINED = "DECLINED",
|
|
5760
|
+
/** Payment was fully refunded. */
|
|
5761
|
+
REFUNDED = "REFUNDED",
|
|
5762
|
+
/** Part of the payment amount was refunded. */
|
|
5763
|
+
PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
|
|
5764
|
+
/** Funds are held on the buyer's payment method but haven't been captured. Capture them with [Capture Authorized Payments](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/capture-authorized-payments) or release them with [Void Authorized Payments](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/void-authorized-payments). An authorized payment can't be refunded until it's captured. */
|
|
5765
|
+
AUTHORIZED = "AUTHORIZED",
|
|
5786
5766
|
/**
|
|
5787
|
-
*
|
|
5788
|
-
*
|
|
5767
|
+
* Payment was voided, releasing whatever it held or consumed: an authorization on the buyer's payment method, a gift card balance, or membership credits.
|
|
5768
|
+
*
|
|
5769
|
+
* Gift card and membership payments don't support partial refunds, so a full refund of one is reported as `VOIDED` rather than `REFUNDED`.
|
|
5789
5770
|
*/
|
|
5790
|
-
|
|
5791
|
-
|
|
5792
|
-
|
|
5793
|
-
|
|
5794
|
-
|
|
5771
|
+
VOIDED = "VOIDED"
|
|
5772
|
+
}
|
|
5773
|
+
/** @enumType */
|
|
5774
|
+
type PaymentStatusWithLiterals = PaymentStatus | 'APPROVED' | 'PENDING' | 'PENDING_MERCHANT' | 'CANCELED' | 'DECLINED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'AUTHORIZED' | 'VOIDED';
|
|
5775
|
+
interface CanceledStatusDetails {
|
|
5776
|
+
reason?: CanceledReasonWithLiterals;
|
|
5777
|
+
}
|
|
5778
|
+
declare enum CanceledReason {
|
|
5779
|
+
/** Other payment with the same chargeCorrelationId failed before current payment started. */
|
|
5780
|
+
OTHER_PAYMENT_FAILURE = "OTHER_PAYMENT_FAILURE",
|
|
5781
|
+
/** Payment was not completed by user and expired. */
|
|
5782
|
+
EXPIRED = "EXPIRED"
|
|
5783
|
+
}
|
|
5784
|
+
/** @enumType */
|
|
5785
|
+
type CanceledReasonWithLiterals = CanceledReason | 'OTHER_PAYMENT_FAILURE' | 'EXPIRED';
|
|
5786
|
+
interface DeclinedStatusDetails {
|
|
5787
|
+
reason?: DeclinedReasonWithLiterals;
|
|
5788
|
+
}
|
|
5789
|
+
declare enum DeclinedReason {
|
|
5790
|
+
/** Corresponding charge failed. */
|
|
5791
|
+
CHARGE_FAILED = "CHARGE_FAILED",
|
|
5792
|
+
/** Payment details expired. */
|
|
5793
|
+
EXPIRED = "EXPIRED",
|
|
5794
|
+
/** Insufficient funds. */
|
|
5795
|
+
INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
|
|
5796
|
+
/** Gift card was disabled before charge was attempted. */
|
|
5797
|
+
GIFT_CARD_DISABLED = "GIFT_CARD_DISABLED"
|
|
5798
|
+
}
|
|
5799
|
+
/** @enumType */
|
|
5800
|
+
type DeclinedReasonWithLiterals = DeclinedReason | 'CHARGE_FAILED' | 'EXPIRED' | 'INSUFFICIENT_FUNDS' | 'GIFT_CARD_DISABLED';
|
|
5801
|
+
interface VoidedStatusDetails {
|
|
5802
|
+
reason?: VoidedReasonWithLiterals;
|
|
5803
|
+
}
|
|
5804
|
+
declare enum VoidedReason {
|
|
5805
|
+
/** Payment was voided by merchant request. */
|
|
5806
|
+
MERCHANT_REQUEST = "MERCHANT_REQUEST",
|
|
5807
|
+
/** Other payment with the same chargeCorrelationId failed and caused rollback of all payments with same chargeCorrelationId. */
|
|
5808
|
+
OTHER_PAYMENT_FAILURE = "OTHER_PAYMENT_FAILURE"
|
|
5809
|
+
}
|
|
5810
|
+
/** @enumType */
|
|
5811
|
+
type VoidedReasonWithLiterals = VoidedReason | 'MERCHANT_REQUEST' | 'OTHER_PAYMENT_FAILURE';
|
|
5812
|
+
interface PaymentStatusDetails extends PaymentStatusDetailsStatusDetailsOneOf {
|
|
5813
|
+
}
|
|
5814
|
+
/** @oneof */
|
|
5815
|
+
interface PaymentStatusDetailsStatusDetailsOneOf {
|
|
5816
|
+
}
|
|
5817
|
+
interface Refund {
|
|
5795
5818
|
/**
|
|
5796
|
-
*
|
|
5797
|
-
*
|
|
5819
|
+
* Refund ID.
|
|
5820
|
+
* @format GUID
|
|
5821
|
+
* @readonly
|
|
5798
5822
|
*/
|
|
5799
|
-
|
|
5800
|
-
/** Standalone forms (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5801
|
-
STANDALONE_FORMS = "STANDALONE_FORMS",
|
|
5802
|
-
/** Standalone events (siteless). MetaSites with this namespace will *not* be shown in a user's site list by default. */
|
|
5803
|
-
STANDALONE_EVENTS = "STANDALONE_EVENTS",
|
|
5804
|
-
/** MIMIR - Siteless account for MIMIR Ai Job runner. */
|
|
5805
|
-
MIMIR = "MIMIR",
|
|
5806
|
-
/** Wix Twins platform. */
|
|
5807
|
-
TWINS = "TWINS",
|
|
5808
|
-
/** Wix Nano. */
|
|
5809
|
-
NANO = "NANO",
|
|
5810
|
-
/** Base44 headless sites. */
|
|
5811
|
-
BASE44 = "BASE44",
|
|
5812
|
-
/** Wix Channels Sites */
|
|
5813
|
-
CHANNELS = "CHANNELS",
|
|
5814
|
-
/** Nautilus platform. */
|
|
5815
|
-
NAUTILUS = "NAUTILUS",
|
|
5823
|
+
id?: string;
|
|
5816
5824
|
/**
|
|
5817
|
-
*
|
|
5818
|
-
*
|
|
5825
|
+
* List of transactions.
|
|
5826
|
+
* @maxSize 50
|
|
5819
5827
|
*/
|
|
5820
|
-
|
|
5821
|
-
/**
|
|
5822
|
-
|
|
5828
|
+
transactions?: RefundTransaction[];
|
|
5829
|
+
/** Refund business details. */
|
|
5830
|
+
details?: RefundDetails;
|
|
5823
5831
|
/**
|
|
5824
|
-
*
|
|
5825
|
-
*
|
|
5832
|
+
* 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.
|
|
5833
|
+
* @readonly
|
|
5834
|
+
* @immutable
|
|
5826
5835
|
*/
|
|
5827
|
-
|
|
5836
|
+
createdDate?: Date | null;
|
|
5828
5837
|
/**
|
|
5829
|
-
*
|
|
5830
|
-
*
|
|
5831
|
-
* (theme, typography, assets) which is rolled out to the BrandKit's connected sites.
|
|
5832
|
-
* MetaSites with this namespace will *not* be shown in a user's site list by default.
|
|
5838
|
+
* Aggregated refund summary.
|
|
5839
|
+
* @readonly
|
|
5833
5840
|
*/
|
|
5834
|
-
|
|
5841
|
+
summary?: AggregatedRefundSummary;
|
|
5835
5842
|
/**
|
|
5836
|
-
*
|
|
5837
|
-
*
|
|
5843
|
+
* ID of the app that initiated this refund.
|
|
5844
|
+
* @format GUID
|
|
5845
|
+
* @readonly
|
|
5846
|
+
* @immutable
|
|
5838
5847
|
*/
|
|
5839
|
-
|
|
5848
|
+
requestingServiceAppId?: string | null;
|
|
5840
5849
|
}
|
|
5841
|
-
|
|
5842
|
-
type NamespaceWithLiterals = Namespace | 'UNKNOWN_NAMESPACE' | 'WIX' | 'SHOUT_OUT' | 'ALBUMS' | 'WIX_STORES_TEST_DRIVE' | 'HOTELS' | 'CLUBS' | 'ONBOARDING_DRAFT' | 'DEV_SITE' | 'LOGOS' | 'VIDEO_MAKER' | 'PARTNER_DASHBOARD' | 'DEV_CENTER_COMPANY' | 'HTML_DRAFT' | 'SITELESS_BUSINESS' | 'CREATOR_ECONOMY' | 'DASHBOARD_FIRST' | 'ANYWHERE' | 'HEADLESS' | 'ACCOUNT_MASTER_CMS' | 'RISE' | 'BRANDED_FIRST' | 'NOWNIA' | 'UGC_TEMPLATE' | 'CODUX' | 'MEDIA_DESIGN_CREATOR' | 'SHARED_BLOG_ENTERPRISE' | 'STANDALONE_FORMS' | 'STANDALONE_EVENTS' | 'MIMIR' | 'TWINS' | 'NANO' | 'BASE44' | 'CHANNELS' | 'NAUTILUS' | 'SYMPHONY' | 'NAUTILUS_APPS' | 'VIBU' | 'ENTERPRISE_BRAND_KIT' | 'DEV_CENTER_DEV_SITE';
|
|
5843
|
-
/** Site transferred to another user. */
|
|
5844
|
-
interface SiteTransferred {
|
|
5850
|
+
interface RefundTransaction {
|
|
5845
5851
|
/**
|
|
5846
|
-
*
|
|
5852
|
+
* ID of the payment associated with this refund.
|
|
5847
5853
|
* @format GUID
|
|
5854
|
+
* @immutable
|
|
5848
5855
|
*/
|
|
5849
|
-
|
|
5856
|
+
paymentId?: string;
|
|
5850
5857
|
/**
|
|
5851
|
-
*
|
|
5852
|
-
* @
|
|
5858
|
+
* Refund amount.
|
|
5859
|
+
* @immutable
|
|
5853
5860
|
*/
|
|
5854
|
-
|
|
5855
|
-
|
|
5856
|
-
|
|
5857
|
-
|
|
5858
|
-
|
|
5859
|
-
deleteContext?: DeleteContext;
|
|
5860
|
-
}
|
|
5861
|
-
interface DeleteContext {
|
|
5862
|
-
/** When the meta site was deleted. */
|
|
5863
|
-
dateDeleted?: Date | null;
|
|
5864
|
-
/** A status. */
|
|
5865
|
-
deleteStatus?: DeleteStatusWithLiterals;
|
|
5861
|
+
amount?: Price;
|
|
5862
|
+
/** Refund status. */
|
|
5863
|
+
refundStatus?: RefundStatusWithLiterals;
|
|
5864
|
+
/** Optional details of current refund status. */
|
|
5865
|
+
refundStatusInfo?: RefundStatusInfo;
|
|
5866
5866
|
/**
|
|
5867
|
-
*
|
|
5868
|
-
*
|
|
5867
|
+
* Payment gateway's refund ID.
|
|
5868
|
+
* This field is only returned when the value of `external_refund` is `false`.
|
|
5869
|
+
* @format GUID
|
|
5869
5870
|
*/
|
|
5870
|
-
|
|
5871
|
+
gatewayRefundId?: string | null;
|
|
5872
|
+
/** ID of the refund in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for external refunds. */
|
|
5873
|
+
providerRefundId?: string | null;
|
|
5871
5874
|
/**
|
|
5872
|
-
*
|
|
5873
|
-
* @
|
|
5875
|
+
* Whether refund was made externally and manually on the payment provider's side.
|
|
5876
|
+
* @immutable
|
|
5874
5877
|
*/
|
|
5875
|
-
|
|
5878
|
+
externalRefund?: boolean;
|
|
5876
5879
|
}
|
|
5877
|
-
|
|
5878
|
-
|
|
5879
|
-
|
|
5880
|
-
|
|
5881
|
-
|
|
5882
|
-
|
|
5880
|
+
/** Refund transaction status. */
|
|
5881
|
+
declare enum RefundStatus {
|
|
5882
|
+
/** Refund was initiated on payment provider side. PENDING status was assigned by provider. */
|
|
5883
|
+
PENDING = "PENDING",
|
|
5884
|
+
/** Refund transaction succeeded. */
|
|
5885
|
+
SUCCEEDED = "SUCCEEDED",
|
|
5886
|
+
/** Refund transaction failed. */
|
|
5887
|
+
FAILED = "FAILED",
|
|
5888
|
+
/** Refund request acknowledged, and will be executed soon. */
|
|
5889
|
+
SCHEDULED = "SCHEDULED",
|
|
5890
|
+
/** Refund was initiated on payment provider side. */
|
|
5891
|
+
STARTED = "STARTED"
|
|
5883
5892
|
}
|
|
5884
5893
|
/** @enumType */
|
|
5885
|
-
type
|
|
5886
|
-
|
|
5887
|
-
interface SiteUndeleted {
|
|
5888
|
-
}
|
|
5889
|
-
/** First publish of a meta site. Or subsequent publish after unpublish. */
|
|
5890
|
-
interface SitePublished {
|
|
5891
|
-
}
|
|
5892
|
-
interface SiteUnpublished {
|
|
5894
|
+
type RefundStatusWithLiterals = RefundStatus | 'PENDING' | 'SUCCEEDED' | 'FAILED' | 'SCHEDULED' | 'STARTED';
|
|
5895
|
+
interface RefundStatusInfo {
|
|
5893
5896
|
/**
|
|
5894
|
-
*
|
|
5895
|
-
*
|
|
5896
|
-
*
|
|
5897
|
+
* Reason code for the refund's current status.
|
|
5898
|
+
*
|
|
5899
|
+
* Learn more about [reason codes](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/reason-codes).
|
|
5900
|
+
* @minLength 1
|
|
5901
|
+
* @maxLength 10
|
|
5897
5902
|
*/
|
|
5898
|
-
|
|
5899
|
-
|
|
5900
|
-
|
|
5901
|
-
|
|
5902
|
-
|
|
5903
|
+
paymentGatewayReasonCode?: string | null;
|
|
5904
|
+
/**
|
|
5905
|
+
* Free text explanation of current refund status.
|
|
5906
|
+
* @minLength 1
|
|
5907
|
+
* @maxLength 1000
|
|
5908
|
+
*/
|
|
5909
|
+
description?: string | null;
|
|
5903
5910
|
}
|
|
5904
|
-
|
|
5905
|
-
|
|
5906
|
-
|
|
5907
|
-
|
|
5908
|
-
|
|
5909
|
-
|
|
5910
|
-
|
|
5911
|
-
|
|
5912
|
-
|
|
5913
|
-
|
|
5914
|
-
|
|
5915
|
-
|
|
5916
|
-
|
|
5917
|
-
|
|
5918
|
-
|
|
5919
|
-
interface ServiceProvisioned {
|
|
5911
|
+
interface AggregatedRefundSummary {
|
|
5912
|
+
/** Total amount requested for refund. */
|
|
5913
|
+
requestedRefund?: Price;
|
|
5914
|
+
/** Pending refund amount - the portion of `requestedRefund` that is still pending. */
|
|
5915
|
+
pendingRefund?: Price;
|
|
5916
|
+
/** Refunded amount - the portion of `requestedRefund` that refunded successfully. */
|
|
5917
|
+
refunded?: Price;
|
|
5918
|
+
/** Failed refund amount - the portion of `requestedRefund` that failed. */
|
|
5919
|
+
failedRefundAmount?: Price;
|
|
5920
|
+
/** Whether at least one refund transaction is still in `"PENDING"` status. */
|
|
5921
|
+
pending?: boolean;
|
|
5922
|
+
/** Breakdown of refunded items. Available only after refund is complete. */
|
|
5923
|
+
breakdown?: RefundItemsBreakdown;
|
|
5924
|
+
}
|
|
5925
|
+
interface RefundItemsBreakdown {
|
|
5920
5926
|
/**
|
|
5921
|
-
*
|
|
5922
|
-
* @
|
|
5927
|
+
* Refunded line items and the amount refunded for each.
|
|
5928
|
+
* @maxSize 300
|
|
5923
5929
|
*/
|
|
5924
|
-
|
|
5930
|
+
lineItems?: LineItemRefundSummary[];
|
|
5931
|
+
}
|
|
5932
|
+
interface LineItemRefundSummary {
|
|
5925
5933
|
/**
|
|
5926
|
-
*
|
|
5927
|
-
* @
|
|
5934
|
+
* ID of the refunded line item.
|
|
5935
|
+
* @format GUID
|
|
5928
5936
|
*/
|
|
5929
|
-
|
|
5937
|
+
lineItemId?: string;
|
|
5938
|
+
/** Total refunded amount for the line item. */
|
|
5939
|
+
totalRefundedAmount?: Price;
|
|
5940
|
+
}
|
|
5941
|
+
interface CalculateRefundRequest {
|
|
5930
5942
|
/**
|
|
5931
|
-
*
|
|
5932
|
-
* @
|
|
5943
|
+
* Order ID
|
|
5944
|
+
* @minLength 1
|
|
5945
|
+
* @maxLength 100
|
|
5933
5946
|
*/
|
|
5934
|
-
|
|
5947
|
+
ecomOrderId?: string;
|
|
5935
5948
|
/**
|
|
5936
|
-
*
|
|
5937
|
-
* @
|
|
5949
|
+
* Refunded line items and quantity
|
|
5950
|
+
* @maxSize 300
|
|
5938
5951
|
*/
|
|
5939
|
-
|
|
5952
|
+
refundItems?: CalculateRefundItemRequest[];
|
|
5953
|
+
/** Should include shipping in refund calculation */
|
|
5954
|
+
refundShipping?: boolean;
|
|
5955
|
+
}
|
|
5956
|
+
interface CalculateRefundItemRequest {
|
|
5940
5957
|
/**
|
|
5941
|
-
*
|
|
5958
|
+
* ID of the line item being refunded
|
|
5942
5959
|
* @format GUID
|
|
5943
5960
|
*/
|
|
5944
|
-
|
|
5945
|
-
}
|
|
5946
|
-
interface ServiceRemoved {
|
|
5961
|
+
id?: string;
|
|
5947
5962
|
/**
|
|
5948
|
-
*
|
|
5949
|
-
* @
|
|
5963
|
+
* How much of that line item is being refunded
|
|
5964
|
+
* @min 1
|
|
5965
|
+
* @max 100000
|
|
5950
5966
|
*/
|
|
5951
|
-
|
|
5967
|
+
quantity?: number;
|
|
5968
|
+
}
|
|
5969
|
+
interface CalculateRefundResponse {
|
|
5970
|
+
/** Total refundable amount */
|
|
5971
|
+
total?: Price;
|
|
5972
|
+
/** Tax cost of the order */
|
|
5973
|
+
tax?: Price;
|
|
5974
|
+
/** Discount given for this order */
|
|
5975
|
+
discount?: Price;
|
|
5976
|
+
/** Total cost of the order (without tax) */
|
|
5977
|
+
subtotal?: Price;
|
|
5978
|
+
/** Total shipping cost for order */
|
|
5979
|
+
shipping?: Price;
|
|
5980
|
+
/** Previous refund given on that order */
|
|
5981
|
+
previouslyRefundedAmount?: Price;
|
|
5952
5982
|
/**
|
|
5953
|
-
*
|
|
5954
|
-
* @
|
|
5983
|
+
* The refundable items of that order
|
|
5984
|
+
* @maxSize 300
|
|
5955
5985
|
*/
|
|
5956
|
-
|
|
5986
|
+
items?: CalculateRefundItemResponse[];
|
|
5987
|
+
}
|
|
5988
|
+
interface CalculateRefundItemResponse {
|
|
5957
5989
|
/**
|
|
5958
|
-
*
|
|
5959
|
-
* @
|
|
5990
|
+
* Line item ID
|
|
5991
|
+
* @format GUID
|
|
5960
5992
|
*/
|
|
5961
|
-
|
|
5993
|
+
id?: string;
|
|
5994
|
+
/** Refundable amount for requested quantity of items (price of requested quantity of items without tax and discount) */
|
|
5995
|
+
price?: Price;
|
|
5962
5996
|
}
|
|
5963
|
-
|
|
5964
|
-
interface SiteRenamed {
|
|
5997
|
+
interface VoidAuthorizedPaymentsRequest {
|
|
5965
5998
|
/**
|
|
5966
|
-
*
|
|
5967
|
-
* @
|
|
5999
|
+
* Wix eCommerce order ID
|
|
6000
|
+
* @minLength 1
|
|
6001
|
+
* @maxLength 100
|
|
5968
6002
|
*/
|
|
5969
|
-
|
|
6003
|
+
ecomOrderId: string;
|
|
5970
6004
|
/**
|
|
5971
|
-
*
|
|
5972
|
-
* @
|
|
6005
|
+
* Payment IDs
|
|
6006
|
+
* @minSize 1
|
|
6007
|
+
* @maxSize 100
|
|
6008
|
+
* @format GUID
|
|
5973
6009
|
*/
|
|
5974
|
-
|
|
5975
|
-
}
|
|
5976
|
-
/**
|
|
5977
|
-
* Hard deletion of the meta site.
|
|
5978
|
-
*
|
|
5979
|
-
* Could not be restored. Therefore it's desirable to cleanup data.
|
|
5980
|
-
*/
|
|
5981
|
-
interface SiteHardDeleted {
|
|
5982
|
-
/** A deletion context. */
|
|
5983
|
-
deleteContext?: DeleteContext;
|
|
5984
|
-
}
|
|
5985
|
-
interface NamespaceChanged {
|
|
5986
|
-
/** A previous namespace. */
|
|
5987
|
-
oldNamespace?: NamespaceWithLiterals;
|
|
5988
|
-
/** A new namespace. */
|
|
5989
|
-
newNamespace?: NamespaceWithLiterals;
|
|
5990
|
-
}
|
|
5991
|
-
/** Assigned Studio editor */
|
|
5992
|
-
interface StudioAssigned {
|
|
5993
|
-
}
|
|
5994
|
-
/** Unassigned Studio editor */
|
|
5995
|
-
interface StudioUnassigned {
|
|
6010
|
+
paymentIds: string[];
|
|
5996
6011
|
}
|
|
5997
|
-
|
|
5998
|
-
|
|
5999
|
-
|
|
6000
|
-
* This is an internal event, it's not propagated in special events, because it's non-actionable. If you need to keep up
|
|
6001
|
-
* with sites and its urls, you need to listen to another topic/event. Read about it:
|
|
6002
|
-
*
|
|
6003
|
-
* https://bo.wix.com/wix-docs/rest/meta-site/meta-site---urls-service
|
|
6004
|
-
*/
|
|
6005
|
-
interface SiteUrlChanged {
|
|
6012
|
+
interface VoidAuthorizedPaymentsResponse {
|
|
6013
|
+
/** All order's transactions after the void was triggered */
|
|
6014
|
+
orderTransactions?: OrderTransactions;
|
|
6006
6015
|
}
|
|
6007
|
-
|
|
6008
|
-
* Used at the end of the deletion flow for both draft sites and when a user deletes a site.
|
|
6009
|
-
* Consumed by other teams to remove relevant data.
|
|
6010
|
-
*/
|
|
6011
|
-
interface SitePurgedExternally {
|
|
6016
|
+
interface CaptureAuthorizedPaymentsRequest {
|
|
6012
6017
|
/**
|
|
6013
|
-
*
|
|
6018
|
+
* Wix eCommerce order ID
|
|
6019
|
+
* @minLength 1
|
|
6020
|
+
* @maxLength 100
|
|
6021
|
+
*/
|
|
6022
|
+
ecomOrderId: string;
|
|
6023
|
+
/**
|
|
6024
|
+
* Capture payments information
|
|
6025
|
+
* @minSize 1
|
|
6014
6026
|
* @maxSize 100
|
|
6015
|
-
* @deprecated
|
|
6016
|
-
* @targetRemovalDate 2025-04-15
|
|
6017
6027
|
*/
|
|
6018
|
-
|
|
6019
|
-
}
|
|
6020
|
-
/** Assigned Odeditor */
|
|
6021
|
-
interface OdeditorAssigned {
|
|
6022
|
-
}
|
|
6023
|
-
/** Unassigned Odeditor */
|
|
6024
|
-
interface OdeditorUnassigned {
|
|
6025
|
-
}
|
|
6026
|
-
/** Assigned Picasso editor */
|
|
6027
|
-
interface PicassoAssigned {
|
|
6028
|
-
}
|
|
6029
|
-
/** Unassigned Picasso */
|
|
6030
|
-
interface PicassoUnassigned {
|
|
6031
|
-
}
|
|
6032
|
-
/** Assigned Wixel */
|
|
6033
|
-
interface WixelAssigned {
|
|
6034
|
-
}
|
|
6035
|
-
/** Unassigned Wixel */
|
|
6036
|
-
interface WixelUnassigned {
|
|
6037
|
-
}
|
|
6038
|
-
/** Assigned StudioTwo */
|
|
6039
|
-
interface StudioTwoAssigned {
|
|
6040
|
-
}
|
|
6041
|
-
/** Unassigned StudioTwo */
|
|
6042
|
-
interface StudioTwoUnassigned {
|
|
6043
|
-
}
|
|
6044
|
-
/** Media from user domain is enabled. */
|
|
6045
|
-
interface UserDomainMediaEnabled {
|
|
6046
|
-
}
|
|
6047
|
-
/** Media from user domain is disabled. */
|
|
6048
|
-
interface UserDomainMediaDisabled {
|
|
6049
|
-
}
|
|
6050
|
-
/** Assigned Editorless */
|
|
6051
|
-
interface EditorlessAssigned {
|
|
6052
|
-
}
|
|
6053
|
-
/** Unassigned Editorless */
|
|
6054
|
-
interface EditorlessUnassigned {
|
|
6028
|
+
payments: PaymentCapture[];
|
|
6055
6029
|
}
|
|
6056
|
-
interface
|
|
6030
|
+
interface PaymentCapture {
|
|
6031
|
+
/**
|
|
6032
|
+
* Payment ID
|
|
6033
|
+
* @format GUID
|
|
6034
|
+
*/
|
|
6035
|
+
paymentId?: string | null;
|
|
6036
|
+
/**
|
|
6037
|
+
* Capture amount.
|
|
6038
|
+
* If not provided - full authorized amount will be captured.
|
|
6039
|
+
*/
|
|
6040
|
+
amount?: Price;
|
|
6057
6041
|
}
|
|
6058
|
-
interface
|
|
6059
|
-
|
|
6042
|
+
interface CaptureAuthorizedPaymentsResponse {
|
|
6043
|
+
/** All order's transactions after the capture was triggered */
|
|
6044
|
+
orderTransactions?: OrderTransactions;
|
|
6060
6045
|
}
|
|
6061
|
-
interface
|
|
6062
|
-
/**
|
|
6063
|
-
|
|
6064
|
-
|
|
6065
|
-
|
|
6046
|
+
interface ChargeSavedPaymentMethodRequest {
|
|
6047
|
+
/**
|
|
6048
|
+
* Ecom Order ID.
|
|
6049
|
+
* @minLength 1
|
|
6050
|
+
* @maxLength 100
|
|
6051
|
+
*/
|
|
6052
|
+
ecomOrderId?: string;
|
|
6053
|
+
/** Amount to be charged */
|
|
6054
|
+
amount?: Price;
|
|
6066
6055
|
}
|
|
6067
|
-
|
|
6068
|
-
|
|
6069
|
-
|
|
6056
|
+
interface ChargeSavedPaymentMethodResponse {
|
|
6057
|
+
/** Payment gateway's order ID (e.g Wix Payments) */
|
|
6058
|
+
paymentGatewayOrderId?: string;
|
|
6070
6059
|
}
|
|
6071
|
-
|
|
6072
|
-
|
|
6073
|
-
|
|
6074
|
-
|
|
6060
|
+
interface V1TriggerReindexRequest {
|
|
6061
|
+
/** @format GUID */
|
|
6062
|
+
metasiteId?: string;
|
|
6063
|
+
/**
|
|
6064
|
+
* @minLength 1
|
|
6065
|
+
* @maxLength 100
|
|
6066
|
+
* @maxSize 100
|
|
6067
|
+
*/
|
|
6068
|
+
orderIds?: string[];
|
|
6075
6069
|
}
|
|
6076
|
-
interface
|
|
6070
|
+
interface V1TriggerReindexResponse {
|
|
6077
6071
|
}
|
|
6078
|
-
interface
|
|
6079
|
-
|
|
6072
|
+
interface V1TriggerReindexOrderRequest {
|
|
6073
|
+
/** @format GUID */
|
|
6074
|
+
metasiteId?: string;
|
|
6075
|
+
/**
|
|
6076
|
+
* @minLength 1
|
|
6077
|
+
* @maxLength 100
|
|
6078
|
+
*/
|
|
6079
|
+
orderId?: string;
|
|
6080
6080
|
}
|
|
6081
6081
|
interface DiffmatokyPayload {
|
|
6082
6082
|
left?: string;
|