@wix/auto_sdk_pricing-plans_orders 1.0.142 → 1.0.143
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/index.d.ts +129 -129
- package/build/cjs/index.js +508 -508
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +791 -791
- package/build/cjs/index.typings.js +405 -405
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +488 -488
- package/build/cjs/meta.js +329 -329
- package/build/cjs/meta.js.map +1 -1
- package/build/es/index.d.mts +129 -129
- package/build/es/index.mjs +508 -508
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +791 -791
- package/build/es/index.typings.mjs +405 -405
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +488 -488
- package/build/es/meta.mjs +329 -329
- package/build/es/meta.mjs.map +1 -1
- package/build/internal/cjs/index.d.ts +129 -129
- package/build/internal/cjs/index.typings.d.ts +817 -817
- package/build/internal/cjs/meta.d.ts +505 -505
- package/build/internal/es/index.d.mts +129 -129
- package/build/internal/es/index.typings.d.mts +817 -817
- package/build/internal/es/meta.d.mts +505 -505
- package/package.json +3 -3
|
@@ -626,345 +626,314 @@ interface ActionEvent {
|
|
|
626
626
|
}
|
|
627
627
|
interface Empty {
|
|
628
628
|
}
|
|
629
|
-
interface
|
|
630
|
-
/**
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
629
|
+
interface CreateOnlineOrderRequest {
|
|
630
|
+
/**
|
|
631
|
+
* Plan ID.
|
|
632
|
+
* @format GUID
|
|
633
|
+
*/
|
|
634
|
+
planId: string;
|
|
635
|
+
/**
|
|
636
|
+
* Start date and time for the plan of the online order in a `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
|
|
637
|
+
*
|
|
638
|
+
* Default: Current date and time.
|
|
639
|
+
*/
|
|
640
|
+
startDate?: Date | null;
|
|
641
|
+
/**
|
|
642
|
+
* Coupon code to apply.
|
|
643
|
+
* @minLength 1
|
|
644
|
+
* @maxLength 20
|
|
645
|
+
*/
|
|
646
|
+
couponCode?: string | null;
|
|
647
|
+
/** Provided if checkout is initiated on buyer's behalf. */
|
|
648
|
+
onBehalf?: OnBehalf;
|
|
649
|
+
/**
|
|
650
|
+
* Submission ID of the form submitted with this order.
|
|
651
|
+
*
|
|
652
|
+
* The submission must belong to the form attached to the plan, and that form must belong to the Pricing Plans namespace.
|
|
653
|
+
* An invalid submission ID is dropped and the order is created without a submission.
|
|
654
|
+
* @format GUID
|
|
655
|
+
*/
|
|
656
|
+
submissionId?: string | null;
|
|
636
657
|
}
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
/**
|
|
644
|
-
|
|
645
|
-
/** Number of the payment cycle will be 0 when the order is in the free trial period. In other cases, the cycle number starts from 1. */
|
|
646
|
-
cycleNumber?: number;
|
|
658
|
+
interface OnBehalf {
|
|
659
|
+
/**
|
|
660
|
+
* Member ID.
|
|
661
|
+
* @format GUID
|
|
662
|
+
*/
|
|
663
|
+
memberId?: string;
|
|
664
|
+
/** Method by which checkout is initiated. */
|
|
665
|
+
orderMethod?: OrderMethodWithLiterals;
|
|
647
666
|
}
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
/** Order that is canceled, effective at the end of the current payment cycle. */
|
|
667
|
+
interface CreateOnlineOrderResponse {
|
|
668
|
+
/** Created online order. */
|
|
651
669
|
order?: Order;
|
|
652
670
|
}
|
|
653
|
-
interface
|
|
654
|
-
/**
|
|
655
|
-
|
|
671
|
+
interface CouponsError {
|
|
672
|
+
/** Coupon code. */
|
|
673
|
+
couponCode?: string;
|
|
674
|
+
/** Plan ID. */
|
|
675
|
+
planId?: string;
|
|
656
676
|
}
|
|
657
|
-
interface
|
|
677
|
+
interface CreateGuestOnlineOrderRequest {
|
|
658
678
|
/**
|
|
659
|
-
*
|
|
679
|
+
* Plan ID.
|
|
660
680
|
* @format GUID
|
|
661
681
|
*/
|
|
662
|
-
|
|
682
|
+
planId?: string;
|
|
663
683
|
/**
|
|
664
|
-
*
|
|
684
|
+
* Start date for the ordered plan.
|
|
665
685
|
*
|
|
666
|
-
* Default:
|
|
686
|
+
* Default: Current date
|
|
667
687
|
*/
|
|
668
|
-
|
|
688
|
+
startDate?: Date | null;
|
|
689
|
+
/**
|
|
690
|
+
* Coupon code to apply.
|
|
691
|
+
* @minLength 1
|
|
692
|
+
* @maxLength 20
|
|
693
|
+
*/
|
|
694
|
+
couponCode?: string | null;
|
|
695
|
+
/** Captcha data to prove you are not a robot */
|
|
696
|
+
captcha?: Captcha;
|
|
697
|
+
/** Visitor info */
|
|
698
|
+
guest?: Guest;
|
|
699
|
+
/**
|
|
700
|
+
* Form submission id that was submitted together with the order
|
|
701
|
+
* @format GUID
|
|
702
|
+
*/
|
|
703
|
+
submissionId?: string | null;
|
|
669
704
|
}
|
|
670
|
-
|
|
671
|
-
/**
|
|
672
|
-
|
|
673
|
-
/** Doesn't return any order form submission data. */
|
|
674
|
-
BASIC = "BASIC",
|
|
675
|
-
/** Returns all order form submission data. */
|
|
676
|
-
FULL = "FULL"
|
|
705
|
+
interface Captcha {
|
|
706
|
+
/** Token from captcha */
|
|
707
|
+
token?: string;
|
|
677
708
|
}
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
709
|
+
interface Guest {
|
|
710
|
+
/**
|
|
711
|
+
* Email for checkout
|
|
712
|
+
* @format EMAIL
|
|
713
|
+
*/
|
|
714
|
+
email?: string;
|
|
715
|
+
}
|
|
716
|
+
interface CreateGuestOnlineOrderResponse {
|
|
681
717
|
/** Order. */
|
|
682
718
|
order?: Order;
|
|
683
719
|
}
|
|
684
|
-
interface
|
|
720
|
+
interface CreateOfflineOrderRequest {
|
|
685
721
|
/**
|
|
686
|
-
*
|
|
722
|
+
* ID of the plan being ordered, from the Plans API.
|
|
687
723
|
* @format GUID
|
|
688
724
|
*/
|
|
689
|
-
|
|
725
|
+
planId: string;
|
|
690
726
|
/**
|
|
691
|
-
*
|
|
727
|
+
* ID of the member ordering the plan, from the Members API.
|
|
692
728
|
* @format GUID
|
|
693
729
|
*/
|
|
694
|
-
|
|
695
|
-
/** Filter by whether or not the auto-renewal of recurring orders was canceled. */
|
|
696
|
-
autoRenewCanceled?: boolean | null;
|
|
697
|
-
/** Filter by order status. */
|
|
698
|
-
orderStatuses?: OrderStatusWithLiterals[];
|
|
699
|
-
/** Filter by payment status. */
|
|
700
|
-
paymentStatuses?: PaymentStatusWithLiterals[];
|
|
730
|
+
memberId: string;
|
|
701
731
|
/**
|
|
702
|
-
*
|
|
732
|
+
* Start date and time for the ordered plan in a `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
|
|
703
733
|
*
|
|
704
|
-
*
|
|
705
|
-
* @min 1
|
|
706
|
-
* @max 50
|
|
734
|
+
* Default: Current date and time.
|
|
707
735
|
*/
|
|
708
|
-
|
|
709
|
-
/** Number of orders to skip in the current sort order. */
|
|
710
|
-
offset?: number | null;
|
|
736
|
+
startDate?: Date | null;
|
|
711
737
|
/**
|
|
712
|
-
*
|
|
713
|
-
*
|
|
714
|
-
* Use `ASC` for ascending order or `DESC` for descending order.
|
|
738
|
+
* Whether the order is paid.
|
|
715
739
|
*
|
|
716
|
-
* Default: `
|
|
740
|
+
* Default: `false`
|
|
717
741
|
*/
|
|
718
|
-
|
|
742
|
+
paid?: boolean | null;
|
|
719
743
|
/**
|
|
720
|
-
*
|
|
744
|
+
* Coupon code to apply, from the Coupons API.
|
|
745
|
+
* @minLength 1
|
|
746
|
+
* @maxLength 20
|
|
747
|
+
*/
|
|
748
|
+
couponCode?: string | null;
|
|
749
|
+
/**
|
|
750
|
+
* Form submission ID that was submitted with the order.
|
|
721
751
|
*
|
|
722
|
-
*
|
|
752
|
+
* The submission must belong to the form attached to the plan, and that form must belong to the Pricing Plans namespace.
|
|
753
|
+
* An invalid submission ID is dropped and the order is created without a submission.
|
|
754
|
+
* @format GUID
|
|
723
755
|
*/
|
|
724
|
-
|
|
756
|
+
submissionId?: string | null;
|
|
725
757
|
}
|
|
726
|
-
interface
|
|
758
|
+
interface CreateOfflineOrderResponse {
|
|
759
|
+
/** Order. */
|
|
760
|
+
order?: Order;
|
|
761
|
+
}
|
|
762
|
+
interface CreateExternalOrderRequest {
|
|
727
763
|
/**
|
|
728
|
-
*
|
|
729
|
-
* @
|
|
764
|
+
* Plan ID.
|
|
765
|
+
* @format GUID
|
|
730
766
|
*/
|
|
731
|
-
|
|
732
|
-
/** Sort order. */
|
|
733
|
-
order?: SortOrderWithLiterals;
|
|
767
|
+
planId?: string;
|
|
734
768
|
/**
|
|
735
|
-
*
|
|
736
|
-
*
|
|
769
|
+
* Form submission id that was submitted together with the order
|
|
770
|
+
* @format GUID
|
|
737
771
|
*/
|
|
738
|
-
|
|
739
|
-
}
|
|
740
|
-
declare enum SortOrder {
|
|
741
|
-
ASC = "ASC",
|
|
742
|
-
DESC = "DESC"
|
|
743
|
-
}
|
|
744
|
-
/** @enumType */
|
|
745
|
-
type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
|
|
746
|
-
interface AddressLocation {
|
|
747
|
-
/** Address latitude. */
|
|
748
|
-
latitude?: number | null;
|
|
749
|
-
/** Address longitude. */
|
|
750
|
-
longitude?: number | null;
|
|
751
|
-
}
|
|
752
|
-
interface ListOrdersResponse {
|
|
753
|
-
/** List of orders. */
|
|
754
|
-
orders?: Order[];
|
|
755
|
-
/** Object containing paging-related data (number of orders returned, offset). */
|
|
756
|
-
pagingMetadata?: PagingMetadataV2;
|
|
772
|
+
submissionId?: string | null;
|
|
757
773
|
}
|
|
758
|
-
interface
|
|
759
|
-
/**
|
|
760
|
-
|
|
761
|
-
/** Offset that was requested. */
|
|
762
|
-
offset?: number | null;
|
|
763
|
-
/** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
|
|
764
|
-
total?: number | null;
|
|
765
|
-
/** Flag that indicates the server failed to calculate the `total` field. */
|
|
766
|
-
tooManyToCount?: boolean | null;
|
|
767
|
-
/** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
|
|
768
|
-
cursors?: Cursors;
|
|
774
|
+
interface CreateExternalOrderResponse {
|
|
775
|
+
/** Created order */
|
|
776
|
+
order?: Order;
|
|
769
777
|
}
|
|
770
|
-
interface
|
|
778
|
+
interface GetOnlineOrderPreviewRequest {
|
|
771
779
|
/**
|
|
772
|
-
*
|
|
773
|
-
* @
|
|
780
|
+
* Plan ID.
|
|
781
|
+
* @format GUID
|
|
774
782
|
*/
|
|
775
|
-
|
|
783
|
+
planId: string;
|
|
776
784
|
/**
|
|
777
|
-
*
|
|
778
|
-
*
|
|
785
|
+
* Start date and time for the plan of the order preview in a `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
|
|
786
|
+
*
|
|
787
|
+
* Default: Current date and time.
|
|
779
788
|
*/
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
789
|
+
startDate?: Date | null;
|
|
790
|
+
/**
|
|
791
|
+
* Coupon code to apply.
|
|
792
|
+
* @minLength 1
|
|
793
|
+
* @maxLength 20
|
|
794
|
+
*/
|
|
795
|
+
couponCode?: string | null;
|
|
783
796
|
}
|
|
784
|
-
interface
|
|
785
|
-
/**
|
|
786
|
-
|
|
787
|
-
/**
|
|
788
|
-
|
|
797
|
+
interface GetOnlineOrderPreviewResponse {
|
|
798
|
+
/** Order preview. This field is undefined if the member has already reached the purchase limit for the order's plan. */
|
|
799
|
+
order?: Order;
|
|
800
|
+
/** Whether the member has already reached purchase limit for the order's plan. */
|
|
801
|
+
purchaseLimitExceeded?: boolean;
|
|
789
802
|
}
|
|
790
|
-
interface
|
|
803
|
+
interface GetGuestOnlineOrderPreviewRequest {
|
|
791
804
|
/**
|
|
792
|
-
*
|
|
805
|
+
* Plan ID.
|
|
793
806
|
* @format GUID
|
|
794
807
|
*/
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
/**
|
|
803
|
-
|
|
808
|
+
planId?: string;
|
|
809
|
+
/**
|
|
810
|
+
* Start date for the ordered plan.
|
|
811
|
+
*
|
|
812
|
+
* Default: Current date
|
|
813
|
+
*/
|
|
814
|
+
startDate?: Date | null;
|
|
815
|
+
/**
|
|
816
|
+
* Coupon code to apply.
|
|
817
|
+
* @minLength 1
|
|
818
|
+
* @maxLength 20
|
|
819
|
+
*/
|
|
820
|
+
couponCode?: string | null;
|
|
821
|
+
/**
|
|
822
|
+
* Email for checkout
|
|
823
|
+
* @format EMAIL
|
|
824
|
+
*/
|
|
825
|
+
email?: string;
|
|
804
826
|
}
|
|
805
|
-
|
|
806
|
-
/**
|
|
807
|
-
|
|
808
|
-
/**
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
CANCELED = "CANCELED",
|
|
814
|
-
/** Ended orders can't be suspended. */
|
|
815
|
-
ENDED = "ENDED",
|
|
816
|
-
/** Paid for orders with future start dates can't be suspended. */
|
|
817
|
-
NOT_STARTED = "NOT_STARTED",
|
|
818
|
-
/** Order is already suspended. */
|
|
819
|
-
ALREADY_SUSPENDED = "ALREADY_SUSPENDED",
|
|
820
|
-
/** Orders based on recurring payments using older stripe versions can't be suspended. */
|
|
821
|
-
OLD_STRIPE = "OLD_STRIPE"
|
|
827
|
+
interface GetGuestOnlineOrderPreviewResponse {
|
|
828
|
+
/** Will be missing if limit is exceeded */
|
|
829
|
+
order?: Order;
|
|
830
|
+
/**
|
|
831
|
+
* Whether the purchase limit has already been reached for this plan by this email.
|
|
832
|
+
* Always false for plans without purchase limits.
|
|
833
|
+
*/
|
|
834
|
+
purchaseLimitExceeded?: boolean;
|
|
822
835
|
}
|
|
823
|
-
|
|
824
|
-
type ReasonNotSuspendableWithLiterals = ReasonNotSuspendable | 'UNDEFINED' | 'PENDING' | 'TRIAL' | 'CANCELED' | 'ENDED' | 'NOT_STARTED' | 'ALREADY_SUSPENDED' | 'OLD_STRIPE';
|
|
825
|
-
interface PostponeEndDateRequest {
|
|
836
|
+
interface GetOfflineOrderPreviewRequest {
|
|
826
837
|
/**
|
|
827
|
-
*
|
|
838
|
+
* ID of the plan of the previewed order, from the Plans API.
|
|
828
839
|
* @format GUID
|
|
829
840
|
*/
|
|
830
|
-
|
|
841
|
+
planId: string;
|
|
831
842
|
/**
|
|
832
|
-
*
|
|
843
|
+
* Member ID of the buyer the previewed order is for, from the Members API.
|
|
844
|
+
* @format GUID
|
|
845
|
+
*/
|
|
846
|
+
memberId: string;
|
|
847
|
+
/**
|
|
848
|
+
* Start date and time for plan of the previewed order in a `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
|
|
833
849
|
*
|
|
834
|
-
*
|
|
850
|
+
* Default: Current date and time.
|
|
835
851
|
*/
|
|
836
|
-
|
|
837
|
-
}
|
|
838
|
-
interface PostponeEndDateResponse {
|
|
839
|
-
}
|
|
840
|
-
interface OrderEndDatePostponed {
|
|
841
|
-
/** Order whose `endDate` was postponed. */
|
|
842
|
-
order?: Order;
|
|
843
|
-
}
|
|
844
|
-
interface CancelOrderRequest {
|
|
852
|
+
startDate?: Date | null;
|
|
845
853
|
/**
|
|
846
|
-
*
|
|
847
|
-
* @
|
|
854
|
+
* Coupon code to apply, from the Coupons API.
|
|
855
|
+
* @minLength 1
|
|
856
|
+
* @maxLength 20
|
|
848
857
|
*/
|
|
849
|
-
|
|
850
|
-
/** __Required.__ When the order will be canceled. One-time orders can only be canceled `IMMEDIATELY`. */
|
|
851
|
-
effectiveAt: CancellationEffectiveAtWithLiterals;
|
|
852
|
-
}
|
|
853
|
-
interface CancelOrderResponse {
|
|
858
|
+
couponCode?: string | null;
|
|
854
859
|
}
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
*
|
|
858
|
-
* To determine the specific reason of the cancellation check `order.cancellation.cause` field.
|
|
859
|
-
*/
|
|
860
|
-
interface OrderCanceled {
|
|
861
|
-
/** Canceled order. */
|
|
860
|
+
interface GetOfflineOrderPreviewResponse {
|
|
861
|
+
/** The previewed order, as if the plan had been ordered. */
|
|
862
862
|
order?: Order;
|
|
863
|
+
/**
|
|
864
|
+
* Whether this previewed order would exceed the permitted amount of purchases available
|
|
865
|
+
* for this plan for this buyer.
|
|
866
|
+
*
|
|
867
|
+
* Always `false` for plans that do not have purchase limits.
|
|
868
|
+
*/
|
|
869
|
+
purchaseLimitExceeded?: boolean;
|
|
863
870
|
}
|
|
864
|
-
interface
|
|
871
|
+
interface GetPricePreviewRequest {
|
|
865
872
|
/**
|
|
866
|
-
*
|
|
873
|
+
* ID of plan to preview.
|
|
867
874
|
* @format GUID
|
|
868
875
|
*/
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
876
|
+
planId: string;
|
|
877
|
+
/**
|
|
878
|
+
* Coupon code to apply, from the Coupons API.
|
|
879
|
+
* @minLength 1
|
|
880
|
+
* @maxLength 20
|
|
881
|
+
*/
|
|
882
|
+
couponCode?: string | null;
|
|
872
883
|
}
|
|
873
|
-
interface
|
|
874
|
-
/**
|
|
875
|
-
|
|
884
|
+
interface GetPricePreviewResponse {
|
|
885
|
+
/** Pricing details. */
|
|
886
|
+
prices?: SpannedPrice[];
|
|
876
887
|
}
|
|
877
|
-
interface
|
|
888
|
+
interface ChangeStartDateRequest {
|
|
878
889
|
/**
|
|
879
|
-
*
|
|
890
|
+
* Draft order ID.
|
|
880
891
|
* @format GUID
|
|
881
892
|
*/
|
|
882
|
-
|
|
893
|
+
orderId?: string;
|
|
894
|
+
/** New valid from date (timestamp). */
|
|
895
|
+
startDate?: Date | null;
|
|
883
896
|
}
|
|
884
|
-
interface
|
|
897
|
+
interface ChangeStartDateResponse {
|
|
898
|
+
/** Updated draft order. */
|
|
899
|
+
order?: Order;
|
|
885
900
|
}
|
|
886
|
-
interface
|
|
887
|
-
/**
|
|
901
|
+
interface OrderStartDateChanged {
|
|
902
|
+
/** Order whose `startDate` changed. */
|
|
888
903
|
order?: Order;
|
|
889
904
|
}
|
|
890
|
-
interface
|
|
905
|
+
interface ApplyCouponRequest {
|
|
891
906
|
/**
|
|
892
|
-
*
|
|
907
|
+
* Draft order ID.
|
|
893
908
|
* @format GUID
|
|
894
|
-
* @minSize 1
|
|
895
|
-
* @maxSize 100
|
|
896
909
|
*/
|
|
897
|
-
|
|
898
|
-
/**
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
/** Bulk action metadata. */
|
|
905
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
910
|
+
orderId?: string;
|
|
911
|
+
/**
|
|
912
|
+
* Coupon code to apply.
|
|
913
|
+
* @minLength 1
|
|
914
|
+
* @maxLength 20
|
|
915
|
+
*/
|
|
916
|
+
couponCode?: string;
|
|
906
917
|
}
|
|
907
|
-
interface
|
|
908
|
-
/**
|
|
909
|
-
itemMetadata?: ItemMetadata;
|
|
910
|
-
/** The order. */
|
|
918
|
+
interface ApplyCouponResponse {
|
|
919
|
+
/** Order with applied coupon and recalculated tax. */
|
|
911
920
|
order?: Order;
|
|
912
921
|
}
|
|
913
|
-
interface
|
|
914
|
-
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
915
|
-
_id?: string | null;
|
|
916
|
-
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
917
|
-
originalIndex?: number;
|
|
918
|
-
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
919
|
-
success?: boolean;
|
|
920
|
-
/** Details about the error in case of failure. */
|
|
921
|
-
error?: ApplicationError;
|
|
922
|
-
}
|
|
923
|
-
interface ApplicationError {
|
|
924
|
-
/** Error code. */
|
|
925
|
-
code?: string;
|
|
926
|
-
/** Description of the error. */
|
|
927
|
-
description?: string;
|
|
928
|
-
/** Data related to the error. */
|
|
929
|
-
data?: Record<string, any> | null;
|
|
930
|
-
}
|
|
931
|
-
interface BulkActionMetadata {
|
|
932
|
-
/** Number of items that were successfully processed. */
|
|
933
|
-
totalSuccesses?: number;
|
|
934
|
-
/** Number of items that couldn't be processed. */
|
|
935
|
-
totalFailures?: number;
|
|
936
|
-
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
937
|
-
undetailedFailures?: number;
|
|
938
|
-
}
|
|
939
|
-
interface ResumeOrderRequest {
|
|
922
|
+
interface SetSubmissionRequest {
|
|
940
923
|
/**
|
|
941
924
|
* Order ID.
|
|
942
925
|
* @format GUID
|
|
943
926
|
*/
|
|
944
|
-
|
|
945
|
-
}
|
|
946
|
-
interface ResumeOrderResponse {
|
|
947
|
-
}
|
|
948
|
-
interface OrderResumed {
|
|
949
|
-
/** Resumed order. */
|
|
950
|
-
order?: Order;
|
|
951
|
-
}
|
|
952
|
-
interface BulkResumeOrderRequest {
|
|
927
|
+
orderId?: string;
|
|
953
928
|
/**
|
|
954
|
-
*
|
|
929
|
+
* Submission ID.
|
|
955
930
|
* @format GUID
|
|
956
|
-
* @minSize 1
|
|
957
|
-
* @maxSize 100
|
|
958
931
|
*/
|
|
959
|
-
|
|
960
|
-
/** Set to true to return Order entity in response. */
|
|
961
|
-
returnFullEntity?: boolean;
|
|
932
|
+
submissionId?: string;
|
|
962
933
|
}
|
|
963
|
-
interface
|
|
964
|
-
/**
|
|
965
|
-
|
|
966
|
-
/** Bulk action metadata. */
|
|
967
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
934
|
+
interface SetSubmissionResponse {
|
|
935
|
+
/** Order with submission id */
|
|
936
|
+
order?: Order;
|
|
968
937
|
}
|
|
969
938
|
interface MessageEnvelope {
|
|
970
939
|
/**
|
|
@@ -1057,314 +1026,345 @@ interface AccountInfo {
|
|
|
1057
1026
|
*/
|
|
1058
1027
|
siteId?: string | null;
|
|
1059
1028
|
}
|
|
1060
|
-
interface
|
|
1061
|
-
/**
|
|
1062
|
-
|
|
1063
|
-
* @format GUID
|
|
1064
|
-
*/
|
|
1065
|
-
planId: string;
|
|
1066
|
-
/**
|
|
1067
|
-
* Start date and time for the plan of the online order in a `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
|
|
1068
|
-
*
|
|
1069
|
-
* Default: Current date and time.
|
|
1070
|
-
*/
|
|
1071
|
-
startDate?: Date | null;
|
|
1072
|
-
/**
|
|
1073
|
-
* Coupon code to apply.
|
|
1074
|
-
* @minLength 1
|
|
1075
|
-
* @maxLength 20
|
|
1076
|
-
*/
|
|
1077
|
-
couponCode?: string | null;
|
|
1078
|
-
/** Provided if checkout is initiated on buyer's behalf. */
|
|
1079
|
-
onBehalf?: OnBehalf;
|
|
1080
|
-
/**
|
|
1081
|
-
* Submission ID of the form submitted with this order.
|
|
1082
|
-
*
|
|
1083
|
-
* The submission must belong to the form attached to the plan, and that form must belong to the Pricing Plans namespace.
|
|
1084
|
-
* An invalid submission ID is dropped and the order is created without a submission.
|
|
1085
|
-
* @format GUID
|
|
1086
|
-
*/
|
|
1087
|
-
submissionId?: string | null;
|
|
1088
|
-
}
|
|
1089
|
-
interface OnBehalf {
|
|
1090
|
-
/**
|
|
1091
|
-
* Member ID.
|
|
1092
|
-
* @format GUID
|
|
1093
|
-
*/
|
|
1094
|
-
memberId?: string;
|
|
1095
|
-
/** Method by which checkout is initiated. */
|
|
1096
|
-
orderMethod?: OrderMethodWithLiterals;
|
|
1029
|
+
interface OrderPurchased {
|
|
1030
|
+
/** Order that was paid for. If a free or an offline order, the order that was created. */
|
|
1031
|
+
order?: Order;
|
|
1097
1032
|
}
|
|
1098
|
-
interface
|
|
1099
|
-
/**
|
|
1033
|
+
interface OrderStarted {
|
|
1034
|
+
/** Order that reached its `startDate`. */
|
|
1100
1035
|
order?: Order;
|
|
1101
1036
|
}
|
|
1102
|
-
|
|
1103
|
-
|
|
1104
|
-
|
|
1105
|
-
|
|
1106
|
-
|
|
1037
|
+
/**
|
|
1038
|
+
* Triggered at the start of a new payment cycle for an existing order.
|
|
1039
|
+
*
|
|
1040
|
+
* This webhook does not trigger at the initial start of an offline order.
|
|
1041
|
+
*/
|
|
1042
|
+
interface OrderCycleStarted {
|
|
1043
|
+
/** Order whose new cycle started. */
|
|
1044
|
+
order?: Order;
|
|
1045
|
+
/** Number of the payment cycle will be 0 when the order is in the free trial period. In other cases, the cycle number starts from 1. */
|
|
1046
|
+
cycleNumber?: number;
|
|
1107
1047
|
}
|
|
1108
|
-
|
|
1109
|
-
|
|
1110
|
-
|
|
1111
|
-
|
|
1112
|
-
|
|
1113
|
-
|
|
1114
|
-
/**
|
|
1115
|
-
|
|
1116
|
-
|
|
1117
|
-
|
|
1118
|
-
*/
|
|
1119
|
-
startDate?: Date | null;
|
|
1120
|
-
/**
|
|
1121
|
-
* Coupon code to apply.
|
|
1122
|
-
* @minLength 1
|
|
1123
|
-
* @maxLength 20
|
|
1124
|
-
*/
|
|
1125
|
-
couponCode?: string | null;
|
|
1126
|
-
/** Captcha data to prove you are not a robot */
|
|
1127
|
-
captcha?: Captcha;
|
|
1128
|
-
/** Visitor info */
|
|
1129
|
-
guest?: Guest;
|
|
1048
|
+
/** Emitted when a recurring order is canceled for the next payment cycle */
|
|
1049
|
+
interface OrderAutoRenewCanceled {
|
|
1050
|
+
/** Order that is canceled, effective at the end of the current payment cycle. */
|
|
1051
|
+
order?: Order;
|
|
1052
|
+
}
|
|
1053
|
+
interface OrderEnded {
|
|
1054
|
+
/** Order that ended. */
|
|
1055
|
+
order?: Order;
|
|
1056
|
+
}
|
|
1057
|
+
interface GetOrderRequest {
|
|
1130
1058
|
/**
|
|
1131
|
-
*
|
|
1059
|
+
* Order ID.
|
|
1132
1060
|
* @format GUID
|
|
1133
1061
|
*/
|
|
1134
|
-
|
|
1135
|
-
}
|
|
1136
|
-
interface Captcha {
|
|
1137
|
-
/** Token from captcha */
|
|
1138
|
-
token?: string;
|
|
1139
|
-
}
|
|
1140
|
-
interface Guest {
|
|
1062
|
+
_id: string;
|
|
1141
1063
|
/**
|
|
1142
|
-
*
|
|
1143
|
-
*
|
|
1064
|
+
* Predefined set of fields to return.
|
|
1065
|
+
*
|
|
1066
|
+
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
1144
1067
|
*/
|
|
1145
|
-
|
|
1068
|
+
fieldSet?: SetWithLiterals;
|
|
1146
1069
|
}
|
|
1147
|
-
|
|
1070
|
+
declare enum Set {
|
|
1071
|
+
/** Same behavior as `BASIC`.` */
|
|
1072
|
+
UNKNOWN_SET = "UNKNOWN_SET",
|
|
1073
|
+
/** Doesn't return any order form submission data. */
|
|
1074
|
+
BASIC = "BASIC",
|
|
1075
|
+
/** Returns all order form submission data. */
|
|
1076
|
+
FULL = "FULL"
|
|
1077
|
+
}
|
|
1078
|
+
/** @enumType */
|
|
1079
|
+
type SetWithLiterals = Set | 'UNKNOWN_SET' | 'BASIC' | 'FULL';
|
|
1080
|
+
interface GetOrderResponse {
|
|
1148
1081
|
/** Order. */
|
|
1149
1082
|
order?: Order;
|
|
1150
1083
|
}
|
|
1151
|
-
interface
|
|
1084
|
+
interface ListOrdersRequest {
|
|
1152
1085
|
/**
|
|
1153
|
-
*
|
|
1086
|
+
* Filter by a buyer's member ID, from the Members API.
|
|
1154
1087
|
* @format GUID
|
|
1155
1088
|
*/
|
|
1156
|
-
|
|
1089
|
+
buyerIds?: string[];
|
|
1157
1090
|
/**
|
|
1158
|
-
*
|
|
1091
|
+
* Filter by plan IDs, from the Plans API.
|
|
1159
1092
|
* @format GUID
|
|
1160
1093
|
*/
|
|
1161
|
-
|
|
1094
|
+
planIds?: string[];
|
|
1095
|
+
/** Filter by whether or not the auto-renewal of recurring orders was canceled. */
|
|
1096
|
+
autoRenewCanceled?: boolean | null;
|
|
1097
|
+
/** Filter by order status. */
|
|
1098
|
+
orderStatuses?: OrderStatusWithLiterals[];
|
|
1099
|
+
/** Filter by payment status. */
|
|
1100
|
+
paymentStatuses?: PaymentStatusWithLiterals[];
|
|
1162
1101
|
/**
|
|
1163
|
-
*
|
|
1102
|
+
* Number of orders to return. See Sorting and Paging for more information.
|
|
1164
1103
|
*
|
|
1165
|
-
*
|
|
1104
|
+
* Max: `50`
|
|
1105
|
+
* @min 1
|
|
1106
|
+
* @max 50
|
|
1166
1107
|
*/
|
|
1167
|
-
|
|
1108
|
+
limit?: number | null;
|
|
1109
|
+
/** Number of orders to skip in the current sort order. */
|
|
1110
|
+
offset?: number | null;
|
|
1168
1111
|
/**
|
|
1169
|
-
*
|
|
1112
|
+
* Sort order.
|
|
1170
1113
|
*
|
|
1171
|
-
*
|
|
1172
|
-
|
|
1173
|
-
|
|
1174
|
-
/**
|
|
1175
|
-
* Coupon code to apply, from the Coupons API.
|
|
1176
|
-
* @minLength 1
|
|
1177
|
-
* @maxLength 20
|
|
1114
|
+
* Use `ASC` for ascending order or `DESC` for descending order.
|
|
1115
|
+
*
|
|
1116
|
+
* Default: `DESC`.
|
|
1178
1117
|
*/
|
|
1179
|
-
|
|
1118
|
+
sorting?: Sorting;
|
|
1180
1119
|
/**
|
|
1181
|
-
*
|
|
1120
|
+
* Predefined set of fields to return.
|
|
1182
1121
|
*
|
|
1183
|
-
*
|
|
1184
|
-
* An invalid submission ID is dropped and the order is created without a submission.
|
|
1185
|
-
* @format GUID
|
|
1122
|
+
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
1186
1123
|
*/
|
|
1187
|
-
|
|
1188
|
-
}
|
|
1189
|
-
interface CreateOfflineOrderResponse {
|
|
1190
|
-
/** Order. */
|
|
1191
|
-
order?: Order;
|
|
1124
|
+
fieldSet?: SetWithLiterals;
|
|
1192
1125
|
}
|
|
1193
|
-
interface
|
|
1126
|
+
interface Sorting {
|
|
1194
1127
|
/**
|
|
1195
|
-
*
|
|
1196
|
-
* @
|
|
1128
|
+
* Name of the field to sort by.
|
|
1129
|
+
* @maxLength 512
|
|
1197
1130
|
*/
|
|
1198
|
-
|
|
1131
|
+
fieldName?: string;
|
|
1132
|
+
/** Sort order. */
|
|
1133
|
+
order?: SortOrderWithLiterals;
|
|
1199
1134
|
/**
|
|
1200
|
-
*
|
|
1201
|
-
*
|
|
1135
|
+
* Origin point for geo-distance sorting on a GEO field
|
|
1136
|
+
* results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
|
|
1202
1137
|
*/
|
|
1203
|
-
|
|
1138
|
+
origin?: AddressLocation;
|
|
1204
1139
|
}
|
|
1205
|
-
|
|
1206
|
-
|
|
1207
|
-
|
|
1140
|
+
declare enum SortOrder {
|
|
1141
|
+
ASC = "ASC",
|
|
1142
|
+
DESC = "DESC"
|
|
1208
1143
|
}
|
|
1209
|
-
|
|
1144
|
+
/** @enumType */
|
|
1145
|
+
type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
|
|
1146
|
+
interface AddressLocation {
|
|
1147
|
+
/** Address latitude. */
|
|
1148
|
+
latitude?: number | null;
|
|
1149
|
+
/** Address longitude. */
|
|
1150
|
+
longitude?: number | null;
|
|
1151
|
+
}
|
|
1152
|
+
interface ListOrdersResponse {
|
|
1153
|
+
/** List of orders. */
|
|
1154
|
+
orders?: Order[];
|
|
1155
|
+
/** Object containing paging-related data (number of orders returned, offset). */
|
|
1156
|
+
pagingMetadata?: PagingMetadataV2;
|
|
1157
|
+
}
|
|
1158
|
+
interface PagingMetadataV2 {
|
|
1159
|
+
/** Number of items returned in the response. */
|
|
1160
|
+
count?: number | null;
|
|
1161
|
+
/** Offset that was requested. */
|
|
1162
|
+
offset?: number | null;
|
|
1163
|
+
/** Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. */
|
|
1164
|
+
total?: number | null;
|
|
1165
|
+
/** Flag that indicates the server failed to calculate the `total` field. */
|
|
1166
|
+
tooManyToCount?: boolean | null;
|
|
1167
|
+
/** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
|
|
1168
|
+
cursors?: Cursors;
|
|
1169
|
+
}
|
|
1170
|
+
interface Cursors {
|
|
1210
1171
|
/**
|
|
1211
|
-
*
|
|
1212
|
-
* @
|
|
1172
|
+
* Cursor string pointing to the next page in the list of results.
|
|
1173
|
+
* @maxLength 16000
|
|
1213
1174
|
*/
|
|
1214
|
-
|
|
1175
|
+
next?: string | null;
|
|
1215
1176
|
/**
|
|
1216
|
-
*
|
|
1217
|
-
*
|
|
1218
|
-
* Default: Current date and time.
|
|
1177
|
+
* Cursor pointing to the previous page in the list of results.
|
|
1178
|
+
* @maxLength 16000
|
|
1219
1179
|
*/
|
|
1220
|
-
|
|
1180
|
+
prev?: string | null;
|
|
1181
|
+
}
|
|
1182
|
+
interface GetOrdersStatsRequest {
|
|
1183
|
+
}
|
|
1184
|
+
interface GetOrdersStatsResponse {
|
|
1185
|
+
/** Total number of orders. */
|
|
1186
|
+
totalOrderCount?: number;
|
|
1187
|
+
/** Number of active orders. */
|
|
1188
|
+
activeOrderCount?: number;
|
|
1189
|
+
}
|
|
1190
|
+
interface GetAvailableOrderActionsRequest {
|
|
1221
1191
|
/**
|
|
1222
|
-
*
|
|
1223
|
-
* @
|
|
1224
|
-
* @maxLength 20
|
|
1192
|
+
* Order ID.
|
|
1193
|
+
* @format GUID
|
|
1225
1194
|
*/
|
|
1226
|
-
|
|
1195
|
+
_id?: string;
|
|
1227
1196
|
}
|
|
1228
|
-
interface
|
|
1229
|
-
/**
|
|
1230
|
-
|
|
1231
|
-
/**
|
|
1232
|
-
|
|
1197
|
+
interface GetAvailableOrderActionsResponse {
|
|
1198
|
+
/** Whether the order can be suspended. */
|
|
1199
|
+
suspendable?: boolean;
|
|
1200
|
+
/** If the order cannot be suspended, a reason is returned here. */
|
|
1201
|
+
notSuspendableReason?: ReasonNotSuspendableWithLiterals;
|
|
1202
|
+
/** Whether the order can be canceled by the buyer. */
|
|
1203
|
+
cancelableByBuyer?: boolean;
|
|
1233
1204
|
}
|
|
1234
|
-
|
|
1205
|
+
declare enum ReasonNotSuspendable {
|
|
1206
|
+
/** Undefined reason. */
|
|
1207
|
+
UNDEFINED = "UNDEFINED",
|
|
1208
|
+
/** Saved in the database but is awaiting payment. Non-active orders can't be suspended. */
|
|
1209
|
+
PENDING = "PENDING",
|
|
1210
|
+
/** Trial orders can't be suspended. */
|
|
1211
|
+
TRIAL = "TRIAL",
|
|
1212
|
+
/** Canceled orders can't be suspended. */
|
|
1213
|
+
CANCELED = "CANCELED",
|
|
1214
|
+
/** Ended orders can't be suspended. */
|
|
1215
|
+
ENDED = "ENDED",
|
|
1216
|
+
/** Paid for orders with future start dates can't be suspended. */
|
|
1217
|
+
NOT_STARTED = "NOT_STARTED",
|
|
1218
|
+
/** Order is already suspended. */
|
|
1219
|
+
ALREADY_SUSPENDED = "ALREADY_SUSPENDED",
|
|
1220
|
+
/** Orders based on recurring payments using older stripe versions can't be suspended. */
|
|
1221
|
+
OLD_STRIPE = "OLD_STRIPE"
|
|
1222
|
+
}
|
|
1223
|
+
/** @enumType */
|
|
1224
|
+
type ReasonNotSuspendableWithLiterals = ReasonNotSuspendable | 'UNDEFINED' | 'PENDING' | 'TRIAL' | 'CANCELED' | 'ENDED' | 'NOT_STARTED' | 'ALREADY_SUSPENDED' | 'OLD_STRIPE';
|
|
1225
|
+
interface PostponeEndDateRequest {
|
|
1235
1226
|
/**
|
|
1236
|
-
*
|
|
1227
|
+
* Order ID.
|
|
1237
1228
|
* @format GUID
|
|
1238
1229
|
*/
|
|
1239
|
-
|
|
1230
|
+
_id: string;
|
|
1240
1231
|
/**
|
|
1241
|
-
*
|
|
1232
|
+
* New end date and time.
|
|
1242
1233
|
*
|
|
1243
|
-
*
|
|
1244
|
-
*/
|
|
1245
|
-
startDate?: Date | null;
|
|
1246
|
-
/**
|
|
1247
|
-
* Coupon code to apply.
|
|
1248
|
-
* @minLength 1
|
|
1249
|
-
* @maxLength 20
|
|
1250
|
-
*/
|
|
1251
|
-
couponCode?: string | null;
|
|
1252
|
-
/**
|
|
1253
|
-
* Email for checkout
|
|
1254
|
-
* @format EMAIL
|
|
1234
|
+
* Must be later than the current end date and time.
|
|
1255
1235
|
*/
|
|
1256
|
-
|
|
1236
|
+
endDate: Date | null;
|
|
1257
1237
|
}
|
|
1258
|
-
interface
|
|
1259
|
-
|
|
1238
|
+
interface PostponeEndDateResponse {
|
|
1239
|
+
}
|
|
1240
|
+
interface OrderEndDatePostponed {
|
|
1241
|
+
/** Order whose `endDate` was postponed. */
|
|
1260
1242
|
order?: Order;
|
|
1261
|
-
/**
|
|
1262
|
-
* Whether the purchase limit has already been reached for this plan by this email.
|
|
1263
|
-
* Always false for plans without purchase limits.
|
|
1264
|
-
*/
|
|
1265
|
-
purchaseLimitExceeded?: boolean;
|
|
1266
1243
|
}
|
|
1267
|
-
interface
|
|
1268
|
-
/**
|
|
1269
|
-
* ID of the plan of the previewed order, from the Plans API.
|
|
1270
|
-
* @format GUID
|
|
1271
|
-
*/
|
|
1272
|
-
planId: string;
|
|
1244
|
+
interface CancelOrderRequest {
|
|
1273
1245
|
/**
|
|
1274
|
-
*
|
|
1246
|
+
* Order ID.
|
|
1275
1247
|
* @format GUID
|
|
1276
1248
|
*/
|
|
1277
|
-
|
|
1278
|
-
/**
|
|
1279
|
-
|
|
1280
|
-
*
|
|
1281
|
-
* Default: Current date and time.
|
|
1282
|
-
*/
|
|
1283
|
-
startDate?: Date | null;
|
|
1284
|
-
/**
|
|
1285
|
-
* Coupon code to apply, from the Coupons API.
|
|
1286
|
-
* @minLength 1
|
|
1287
|
-
* @maxLength 20
|
|
1288
|
-
*/
|
|
1289
|
-
couponCode?: string | null;
|
|
1249
|
+
_id: string;
|
|
1250
|
+
/** __Required.__ When the order will be canceled. One-time orders can only be canceled `IMMEDIATELY`. */
|
|
1251
|
+
effectiveAt: CancellationEffectiveAtWithLiterals;
|
|
1290
1252
|
}
|
|
1291
|
-
interface
|
|
1292
|
-
|
|
1253
|
+
interface CancelOrderResponse {
|
|
1254
|
+
}
|
|
1255
|
+
/**
|
|
1256
|
+
* Emitted when an order is canceled immediately or when cycle ends for an order with canceled auto renewal
|
|
1257
|
+
*
|
|
1258
|
+
* To determine the specific reason of the cancellation check `order.cancellation.cause` field.
|
|
1259
|
+
*/
|
|
1260
|
+
interface OrderCanceled {
|
|
1261
|
+
/** Canceled order. */
|
|
1293
1262
|
order?: Order;
|
|
1294
|
-
/**
|
|
1295
|
-
* Whether this previewed order would exceed the permitted amount of purchases available
|
|
1296
|
-
* for this plan for this buyer.
|
|
1297
|
-
*
|
|
1298
|
-
* Always `false` for plans that do not have purchase limits.
|
|
1299
|
-
*/
|
|
1300
|
-
purchaseLimitExceeded?: boolean;
|
|
1301
1263
|
}
|
|
1302
|
-
interface
|
|
1264
|
+
interface MarkAsPaidRequest {
|
|
1303
1265
|
/**
|
|
1304
|
-
* ID
|
|
1266
|
+
* Order ID.
|
|
1305
1267
|
* @format GUID
|
|
1306
1268
|
*/
|
|
1307
|
-
|
|
1308
|
-
/**
|
|
1309
|
-
* Coupon code to apply, from the Coupons API.
|
|
1310
|
-
* @minLength 1
|
|
1311
|
-
* @maxLength 20
|
|
1312
|
-
*/
|
|
1313
|
-
couponCode?: string | null;
|
|
1269
|
+
_id: string;
|
|
1314
1270
|
}
|
|
1315
|
-
interface
|
|
1316
|
-
/** Pricing details. */
|
|
1317
|
-
prices?: SpannedPrice[];
|
|
1271
|
+
interface MarkAsPaidResponse {
|
|
1318
1272
|
}
|
|
1319
|
-
interface
|
|
1273
|
+
interface OrderMarkedAsPaid {
|
|
1274
|
+
/** Order that was marked as paid. */
|
|
1275
|
+
order?: Order;
|
|
1276
|
+
}
|
|
1277
|
+
interface PauseOrderRequest {
|
|
1320
1278
|
/**
|
|
1321
|
-
*
|
|
1279
|
+
* Order ID.
|
|
1322
1280
|
* @format GUID
|
|
1323
1281
|
*/
|
|
1324
|
-
|
|
1325
|
-
/** New valid from date (timestamp). */
|
|
1326
|
-
startDate?: Date | null;
|
|
1282
|
+
_id: string;
|
|
1327
1283
|
}
|
|
1328
|
-
interface
|
|
1329
|
-
/** Updated draft order. */
|
|
1330
|
-
order?: Order;
|
|
1284
|
+
interface PauseOrderResponse {
|
|
1331
1285
|
}
|
|
1332
|
-
interface
|
|
1333
|
-
/**
|
|
1286
|
+
interface OrderPaused {
|
|
1287
|
+
/** Paused order. */
|
|
1334
1288
|
order?: Order;
|
|
1335
1289
|
}
|
|
1336
|
-
interface
|
|
1290
|
+
interface BulkPauseOrderRequest {
|
|
1337
1291
|
/**
|
|
1338
|
-
*
|
|
1292
|
+
* List of Order IDs.
|
|
1339
1293
|
* @format GUID
|
|
1294
|
+
* @minSize 1
|
|
1295
|
+
* @maxSize 100
|
|
1340
1296
|
*/
|
|
1341
|
-
|
|
1342
|
-
/**
|
|
1343
|
-
|
|
1344
|
-
* @minLength 1
|
|
1345
|
-
* @maxLength 20
|
|
1346
|
-
*/
|
|
1347
|
-
couponCode?: string;
|
|
1297
|
+
ids?: string[];
|
|
1298
|
+
/** Set to true to return Order entity in response. */
|
|
1299
|
+
returnFullEntity?: boolean;
|
|
1348
1300
|
}
|
|
1349
|
-
interface
|
|
1350
|
-
/**
|
|
1301
|
+
interface BulkPauseOrderResponse {
|
|
1302
|
+
/** Orders that were paused. */
|
|
1303
|
+
results?: BulkOrderResult[];
|
|
1304
|
+
/** Bulk action metadata. */
|
|
1305
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1306
|
+
}
|
|
1307
|
+
interface BulkOrderResult {
|
|
1308
|
+
/** Item metadata */
|
|
1309
|
+
itemMetadata?: ItemMetadata;
|
|
1310
|
+
/** The order. */
|
|
1351
1311
|
order?: Order;
|
|
1352
1312
|
}
|
|
1353
|
-
interface
|
|
1313
|
+
interface ItemMetadata {
|
|
1314
|
+
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
1315
|
+
_id?: string | null;
|
|
1316
|
+
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
1317
|
+
originalIndex?: number;
|
|
1318
|
+
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
1319
|
+
success?: boolean;
|
|
1320
|
+
/** Details about the error in case of failure. */
|
|
1321
|
+
error?: ApplicationError;
|
|
1322
|
+
}
|
|
1323
|
+
interface ApplicationError {
|
|
1324
|
+
/** Error code. */
|
|
1325
|
+
code?: string;
|
|
1326
|
+
/** Description of the error. */
|
|
1327
|
+
description?: string;
|
|
1328
|
+
/** Data related to the error. */
|
|
1329
|
+
data?: Record<string, any> | null;
|
|
1330
|
+
}
|
|
1331
|
+
interface BulkActionMetadata {
|
|
1332
|
+
/** Number of items that were successfully processed. */
|
|
1333
|
+
totalSuccesses?: number;
|
|
1334
|
+
/** Number of items that couldn't be processed. */
|
|
1335
|
+
totalFailures?: number;
|
|
1336
|
+
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
1337
|
+
undetailedFailures?: number;
|
|
1338
|
+
}
|
|
1339
|
+
interface ResumeOrderRequest {
|
|
1354
1340
|
/**
|
|
1355
1341
|
* Order ID.
|
|
1356
1342
|
* @format GUID
|
|
1357
1343
|
*/
|
|
1358
|
-
|
|
1344
|
+
_id: string;
|
|
1345
|
+
}
|
|
1346
|
+
interface ResumeOrderResponse {
|
|
1347
|
+
}
|
|
1348
|
+
interface OrderResumed {
|
|
1349
|
+
/** Resumed order. */
|
|
1350
|
+
order?: Order;
|
|
1351
|
+
}
|
|
1352
|
+
interface BulkResumeOrderRequest {
|
|
1359
1353
|
/**
|
|
1360
|
-
*
|
|
1354
|
+
* List of Order IDs.
|
|
1361
1355
|
* @format GUID
|
|
1356
|
+
* @minSize 1
|
|
1357
|
+
* @maxSize 100
|
|
1362
1358
|
*/
|
|
1363
|
-
|
|
1359
|
+
ids?: string[];
|
|
1360
|
+
/** Set to true to return Order entity in response. */
|
|
1361
|
+
returnFullEntity?: boolean;
|
|
1364
1362
|
}
|
|
1365
|
-
interface
|
|
1366
|
-
/**
|
|
1367
|
-
|
|
1363
|
+
interface BulkResumeOrderResponse {
|
|
1364
|
+
/** Orders that were resumed. */
|
|
1365
|
+
results?: BulkOrderResult[];
|
|
1366
|
+
/** Bulk action metadata. */
|
|
1367
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
1368
1368
|
}
|
|
1369
1369
|
interface MemberGetOrderRequest {
|
|
1370
1370
|
/**
|
|
@@ -1780,16 +1780,12 @@ interface AccountInfoMetadata {
|
|
|
1780
1780
|
/** ID of the parent Wix account. Only included when 'accountId' belongs to a child account. */
|
|
1781
1781
|
parentAccountId?: string;
|
|
1782
1782
|
}
|
|
1783
|
-
interface
|
|
1784
|
-
|
|
1783
|
+
interface OrderCreatedEnvelope {
|
|
1784
|
+
entity: Order;
|
|
1785
1785
|
metadata: EventMetadata;
|
|
1786
1786
|
}
|
|
1787
1787
|
/**
|
|
1788
|
-
* Triggered when an order is
|
|
1789
|
-
*
|
|
1790
|
-
* This webhook is *not* triggered in the following scenarios:
|
|
1791
|
-
* + When an order is canceled and `effectiveAt` is set to `IMMEDIATELY`. Instead, at the time of cancellation, Order Canceled is triggered.
|
|
1792
|
-
* + When an order expires at the end of the current payment cycle because it was canceled and `effectiveAt` was set to `NEXT_PAYMENT_DATE`. Instead, at the time of expiration, Order Canceled and Order Ended are triggered.
|
|
1788
|
+
* Triggered when an order is created.
|
|
1793
1789
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1794
1790
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1795
1791
|
* @permissionScope Manage Orders
|
|
@@ -1802,21 +1798,17 @@ interface OrderAutoRenewCanceledEnvelope {
|
|
|
1802
1798
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1803
1799
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1804
1800
|
* @webhook
|
|
1805
|
-
* @eventType wix.pricing_plans.v2.
|
|
1806
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.
|
|
1807
|
-
* @slug
|
|
1801
|
+
* @eventType wix.pricing_plans.v2.order_created
|
|
1802
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.CheckoutService
|
|
1803
|
+
* @slug created
|
|
1808
1804
|
*/
|
|
1809
|
-
declare function
|
|
1810
|
-
interface
|
|
1811
|
-
data:
|
|
1805
|
+
declare function onOrderCreated(handler: (event: OrderCreatedEnvelope) => void | Promise<void>): void;
|
|
1806
|
+
interface OrderStartDateChangedEnvelope {
|
|
1807
|
+
data: OrderStartDateChanged;
|
|
1812
1808
|
metadata: EventMetadata;
|
|
1813
1809
|
}
|
|
1814
1810
|
/**
|
|
1815
|
-
* Triggered when an order is
|
|
1816
|
-
*
|
|
1817
|
-
* This webhook is triggered either immediately or at the end of the current payment cycle, as follows:
|
|
1818
|
-
* + If the order is canceled and `effectiveAt` is set to `IMMEDIATELY`, the webhook is triggered immediately when canceled.
|
|
1819
|
-
* + If the order is canceled and `effectiveAt` is set to `NEXT_PAYMENT_DATE`, the webhook is triggered at the end of the current payment cycle. In this case, the Order Auto Renew Canceled Webhook is triggered immediately.
|
|
1811
|
+
* Triggered when an order's `startDate` is changed.
|
|
1820
1812
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1821
1813
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1822
1814
|
* @permissionScope Manage Orders
|
|
@@ -1829,42 +1821,25 @@ interface OrderCanceledEnvelope {
|
|
|
1829
1821
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1830
1822
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1831
1823
|
* @webhook
|
|
1832
|
-
* @eventType wix.pricing_plans.v2.
|
|
1833
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.
|
|
1834
|
-
* @slug
|
|
1824
|
+
* @eventType wix.pricing_plans.v2.order_start_date_changed
|
|
1825
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.CheckoutService
|
|
1826
|
+
* @slug start_date_changed
|
|
1835
1827
|
*/
|
|
1836
|
-
declare function
|
|
1837
|
-
interface
|
|
1838
|
-
|
|
1828
|
+
declare function onOrderStartDateChanged(handler: (event: OrderStartDateChangedEnvelope) => void | Promise<void>): void;
|
|
1829
|
+
interface OrderUpdatedEnvelope {
|
|
1830
|
+
entity: Order;
|
|
1839
1831
|
metadata: EventMetadata;
|
|
1840
1832
|
}
|
|
1841
1833
|
/**
|
|
1842
|
-
* Triggered
|
|
1834
|
+
* Triggered for any of the following update events:
|
|
1843
1835
|
*
|
|
1844
|
-
*
|
|
1845
|
-
*
|
|
1846
|
-
*
|
|
1847
|
-
*
|
|
1848
|
-
*
|
|
1849
|
-
*
|
|
1850
|
-
*
|
|
1851
|
-
* @permissionScope Manage plans and orders of Pricing Plans
|
|
1852
|
-
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-PLANS-AND-ORDERS
|
|
1853
|
-
* @permissionScope Manage Events
|
|
1854
|
-
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1855
|
-
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1856
|
-
* @webhook
|
|
1857
|
-
* @eventType wix.pricing_plans.v2.order_cycle_started
|
|
1858
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
1859
|
-
* @slug cycle_started
|
|
1860
|
-
*/
|
|
1861
|
-
declare function onOrderCycleStarted(handler: (event: OrderCycleStartedEnvelope) => void | Promise<void>): void;
|
|
1862
|
-
interface OrderEndDatePostponedEnvelope {
|
|
1863
|
-
data: OrderEndDatePostponed;
|
|
1864
|
-
metadata: EventMetadata;
|
|
1865
|
-
}
|
|
1866
|
-
/**
|
|
1867
|
-
* Triggered when an order's `endDate` is postponed.
|
|
1836
|
+
* + Order is paid for. Order Purchased is also triggered.
|
|
1837
|
+
* + Order reaches its start date or end date. Order Started and Order Ended, respectively, are also triggered.
|
|
1838
|
+
* + New payment cycle of an order starts. Order Cycle Started is also triggered.
|
|
1839
|
+
* + Offline order is marked as paid. Order Marked As Paid is also triggered.
|
|
1840
|
+
* + End date of the order is postponed. Order End Date Postponed is also triggered
|
|
1841
|
+
* + Order is paused, or a paused order is resumed. Order Paused and Order Resumed, respectively, are also triggered.
|
|
1842
|
+
* + Order is canceled, either immediately or at the end of the payment cycle. Order Canceled and Order Auto Renew Canceled, respectively, are also triggered.
|
|
1868
1843
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1869
1844
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1870
1845
|
* @permissionScope Manage Orders
|
|
@@ -1877,44 +1852,21 @@ interface OrderEndDatePostponedEnvelope {
|
|
|
1877
1852
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1878
1853
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1879
1854
|
* @webhook
|
|
1880
|
-
* @eventType wix.pricing_plans.v2.
|
|
1881
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.
|
|
1882
|
-
* @slug
|
|
1855
|
+
* @eventType wix.pricing_plans.v2.order_updated
|
|
1856
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.CheckoutService
|
|
1857
|
+
* @slug updated
|
|
1883
1858
|
*/
|
|
1884
|
-
declare function
|
|
1885
|
-
interface
|
|
1886
|
-
data:
|
|
1859
|
+
declare function onOrderUpdated(handler: (event: OrderUpdatedEnvelope) => void | Promise<void>): void;
|
|
1860
|
+
interface OrderAutoRenewCanceledEnvelope {
|
|
1861
|
+
data: OrderAutoRenewCanceled;
|
|
1887
1862
|
metadata: EventMetadata;
|
|
1888
1863
|
}
|
|
1889
1864
|
/**
|
|
1890
|
-
* Triggered when an order
|
|
1865
|
+
* Triggered when an order is canceled and `effectiveAt` is set to `NEXT_PAYMENT_DATE`.
|
|
1891
1866
|
*
|
|
1892
|
-
* This webhook is triggered:
|
|
1893
|
-
* + When an order
|
|
1894
|
-
* + When an order
|
|
1895
|
-
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1896
|
-
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1897
|
-
* @permissionScope Manage Orders
|
|
1898
|
-
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-ORDERS
|
|
1899
|
-
* @permissionScope Read Orders
|
|
1900
|
-
* @permissionScopeId SCOPE.DC-PAIDPLANS.READ-ORDERS
|
|
1901
|
-
* @permissionScope Manage plans and orders of Pricing Plans
|
|
1902
|
-
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-PLANS-AND-ORDERS
|
|
1903
|
-
* @permissionScope Manage Events
|
|
1904
|
-
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1905
|
-
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1906
|
-
* @webhook
|
|
1907
|
-
* @eventType wix.pricing_plans.v2.order_ended
|
|
1908
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
1909
|
-
* @slug ended
|
|
1910
|
-
*/
|
|
1911
|
-
declare function onOrderEnded(handler: (event: OrderEndedEnvelope) => void | Promise<void>): void;
|
|
1912
|
-
interface OrderMarkedAsPaidEnvelope {
|
|
1913
|
-
data: OrderMarkedAsPaid;
|
|
1914
|
-
metadata: EventMetadata;
|
|
1915
|
-
}
|
|
1916
|
-
/**
|
|
1917
|
-
* Triggered when an offline order is marked as paid.
|
|
1867
|
+
* This webhook is *not* triggered in the following scenarios:
|
|
1868
|
+
* + When an order is canceled and `effectiveAt` is set to `IMMEDIATELY`. Instead, at the time of cancellation, Order Canceled is triggered.
|
|
1869
|
+
* + When an order expires at the end of the current payment cycle because it was canceled and `effectiveAt` was set to `NEXT_PAYMENT_DATE`. Instead, at the time of expiration, Order Canceled and Order Ended are triggered.
|
|
1918
1870
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1919
1871
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1920
1872
|
* @permissionScope Manage Orders
|
|
@@ -1927,17 +1879,21 @@ interface OrderMarkedAsPaidEnvelope {
|
|
|
1927
1879
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1928
1880
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1929
1881
|
* @webhook
|
|
1930
|
-
* @eventType wix.pricing_plans.v2.
|
|
1882
|
+
* @eventType wix.pricing_plans.v2.order_auto_renew_canceled
|
|
1931
1883
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
1932
|
-
* @slug
|
|
1884
|
+
* @slug auto_renew_canceled
|
|
1933
1885
|
*/
|
|
1934
|
-
declare function
|
|
1935
|
-
interface
|
|
1936
|
-
data:
|
|
1886
|
+
declare function onOrderAutoRenewCanceled(handler: (event: OrderAutoRenewCanceledEnvelope) => void | Promise<void>): void;
|
|
1887
|
+
interface OrderCanceledEnvelope {
|
|
1888
|
+
data: OrderCanceled;
|
|
1937
1889
|
metadata: EventMetadata;
|
|
1938
1890
|
}
|
|
1939
1891
|
/**
|
|
1940
|
-
* Triggered when an order is
|
|
1892
|
+
* Triggered when an order is canceled.
|
|
1893
|
+
*
|
|
1894
|
+
* This webhook is triggered either immediately or at the end of the current payment cycle, as follows:
|
|
1895
|
+
* + If the order is canceled and `effectiveAt` is set to `IMMEDIATELY`, the webhook is triggered immediately when canceled.
|
|
1896
|
+
* + If the order is canceled and `effectiveAt` is set to `NEXT_PAYMENT_DATE`, the webhook is triggered at the end of the current payment cycle. In this case, the Order Auto Renew Canceled Webhook is triggered immediately.
|
|
1941
1897
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1942
1898
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1943
1899
|
* @permissionScope Manage Orders
|
|
@@ -1950,21 +1906,19 @@ interface OrderPausedEnvelope {
|
|
|
1950
1906
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1951
1907
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1952
1908
|
* @webhook
|
|
1953
|
-
* @eventType wix.pricing_plans.v2.
|
|
1909
|
+
* @eventType wix.pricing_plans.v2.order_canceled
|
|
1954
1910
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
1955
|
-
* @slug
|
|
1911
|
+
* @slug canceled
|
|
1956
1912
|
*/
|
|
1957
|
-
declare function
|
|
1958
|
-
interface
|
|
1959
|
-
data:
|
|
1913
|
+
declare function onOrderCanceled(handler: (event: OrderCanceledEnvelope) => void | Promise<void>): void;
|
|
1914
|
+
interface OrderCycleStartedEnvelope {
|
|
1915
|
+
data: OrderCycleStarted;
|
|
1960
1916
|
metadata: EventMetadata;
|
|
1961
1917
|
}
|
|
1962
1918
|
/**
|
|
1963
|
-
* Triggered
|
|
1964
|
-
*
|
|
1965
|
-
*
|
|
1966
|
-
* + Offline order is created, even if not yet marked as paid.
|
|
1967
|
-
* + Free order is created.
|
|
1919
|
+
* Triggered at the start of a new payment cycle for an existing order.
|
|
1920
|
+
*
|
|
1921
|
+
* Not triggered at the initial start of an offline order.
|
|
1968
1922
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1969
1923
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1970
1924
|
* @permissionScope Manage Orders
|
|
@@ -1977,17 +1931,17 @@ interface OrderPurchasedEnvelope {
|
|
|
1977
1931
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
1978
1932
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
1979
1933
|
* @webhook
|
|
1980
|
-
* @eventType wix.pricing_plans.v2.
|
|
1934
|
+
* @eventType wix.pricing_plans.v2.order_cycle_started
|
|
1981
1935
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
1982
|
-
* @slug
|
|
1936
|
+
* @slug cycle_started
|
|
1983
1937
|
*/
|
|
1984
|
-
declare function
|
|
1985
|
-
interface
|
|
1986
|
-
data:
|
|
1938
|
+
declare function onOrderCycleStarted(handler: (event: OrderCycleStartedEnvelope) => void | Promise<void>): void;
|
|
1939
|
+
interface OrderEndDatePostponedEnvelope {
|
|
1940
|
+
data: OrderEndDatePostponed;
|
|
1987
1941
|
metadata: EventMetadata;
|
|
1988
1942
|
}
|
|
1989
1943
|
/**
|
|
1990
|
-
* Triggered when
|
|
1944
|
+
* Triggered when an order's `endDate` is postponed.
|
|
1991
1945
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
1992
1946
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
1993
1947
|
* @permissionScope Manage Orders
|
|
@@ -2000,17 +1954,21 @@ interface OrderResumedEnvelope {
|
|
|
2000
1954
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2001
1955
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2002
1956
|
* @webhook
|
|
2003
|
-
* @eventType wix.pricing_plans.v2.
|
|
1957
|
+
* @eventType wix.pricing_plans.v2.order_end_date_postponed
|
|
2004
1958
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2005
|
-
* @slug
|
|
1959
|
+
* @slug end_date_postponed
|
|
2006
1960
|
*/
|
|
2007
|
-
declare function
|
|
2008
|
-
interface
|
|
2009
|
-
data:
|
|
1961
|
+
declare function onOrderEndDatePostponed(handler: (event: OrderEndDatePostponedEnvelope) => void | Promise<void>): void;
|
|
1962
|
+
interface OrderEndedEnvelope {
|
|
1963
|
+
data: OrderEnded;
|
|
2010
1964
|
metadata: EventMetadata;
|
|
2011
1965
|
}
|
|
2012
1966
|
/**
|
|
2013
|
-
* Triggered when an order
|
|
1967
|
+
* Triggered when an order ends.
|
|
1968
|
+
*
|
|
1969
|
+
* This webhook is triggered:
|
|
1970
|
+
* + When an order expires at the end of the current payment cycle.
|
|
1971
|
+
* + When an order is canceled and `effectiveAt` is set to `IMMEDIATELY`.
|
|
2014
1972
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2015
1973
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2016
1974
|
* @permissionScope Manage Orders
|
|
@@ -2023,25 +1981,17 @@ interface OrderStartedEnvelope {
|
|
|
2023
1981
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2024
1982
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2025
1983
|
* @webhook
|
|
2026
|
-
* @eventType wix.pricing_plans.v2.
|
|
1984
|
+
* @eventType wix.pricing_plans.v2.order_ended
|
|
2027
1985
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2028
|
-
* @slug
|
|
1986
|
+
* @slug ended
|
|
2029
1987
|
*/
|
|
2030
|
-
declare function
|
|
2031
|
-
interface
|
|
2032
|
-
|
|
1988
|
+
declare function onOrderEnded(handler: (event: OrderEndedEnvelope) => void | Promise<void>): void;
|
|
1989
|
+
interface OrderMarkedAsPaidEnvelope {
|
|
1990
|
+
data: OrderMarkedAsPaid;
|
|
2033
1991
|
metadata: EventMetadata;
|
|
2034
1992
|
}
|
|
2035
1993
|
/**
|
|
2036
|
-
* Triggered
|
|
2037
|
-
*
|
|
2038
|
-
* + Order is paid for. Order Purchased is also triggered.
|
|
2039
|
-
* + Order reaches its start date or end date. Order Started and Order Ended, respectively, are also triggered.
|
|
2040
|
-
* + New payment cycle of an order starts. Order Cycle Started is also triggered.
|
|
2041
|
-
* + Offline order is marked as paid. Order Marked As Paid is also triggered.
|
|
2042
|
-
* + End date of the order is postponed. Order End Date Postponed is also triggered
|
|
2043
|
-
* + Order is paused, or a paused order is resumed. Order Paused and Order Resumed, respectively, are also triggered.
|
|
2044
|
-
* + Order is canceled, either immediately or at the end of the payment cycle. Order Canceled and Order Auto Renew Canceled, respectively, are also triggered.
|
|
1994
|
+
* Triggered when an offline order is marked as paid.
|
|
2045
1995
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2046
1996
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2047
1997
|
* @permissionScope Manage Orders
|
|
@@ -2054,17 +2004,17 @@ interface OrderUpdatedEnvelope {
|
|
|
2054
2004
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2055
2005
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2056
2006
|
* @webhook
|
|
2057
|
-
* @eventType wix.pricing_plans.v2.
|
|
2007
|
+
* @eventType wix.pricing_plans.v2.order_marked_as_paid
|
|
2058
2008
|
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2059
|
-
* @slug
|
|
2009
|
+
* @slug marked_as_paid
|
|
2060
2010
|
*/
|
|
2061
|
-
declare function
|
|
2062
|
-
interface
|
|
2063
|
-
|
|
2011
|
+
declare function onOrderMarkedAsPaid(handler: (event: OrderMarkedAsPaidEnvelope) => void | Promise<void>): void;
|
|
2012
|
+
interface OrderPausedEnvelope {
|
|
2013
|
+
data: OrderPaused;
|
|
2064
2014
|
metadata: EventMetadata;
|
|
2065
2015
|
}
|
|
2066
2016
|
/**
|
|
2067
|
-
* Triggered when an order is
|
|
2017
|
+
* Triggered when an order is paused.
|
|
2068
2018
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2069
2019
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2070
2020
|
* @permissionScope Manage Orders
|
|
@@ -2077,17 +2027,21 @@ interface OrderCreatedEnvelope {
|
|
|
2077
2027
|
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2078
2028
|
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2079
2029
|
* @webhook
|
|
2080
|
-
* @eventType wix.pricing_plans.v2.
|
|
2081
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.
|
|
2082
|
-
* @slug
|
|
2030
|
+
* @eventType wix.pricing_plans.v2.order_paused
|
|
2031
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2032
|
+
* @slug paused
|
|
2083
2033
|
*/
|
|
2084
|
-
declare function
|
|
2085
|
-
interface
|
|
2086
|
-
data:
|
|
2034
|
+
declare function onOrderPaused(handler: (event: OrderPausedEnvelope) => void | Promise<void>): void;
|
|
2035
|
+
interface OrderPurchasedEnvelope {
|
|
2036
|
+
data: OrderPurchased;
|
|
2087
2037
|
metadata: EventMetadata;
|
|
2088
2038
|
}
|
|
2089
2039
|
/**
|
|
2090
|
-
* Triggered
|
|
2040
|
+
* Triggered for any of the following purchase events:
|
|
2041
|
+
* + Order is paid in full.
|
|
2042
|
+
* + At least 1 order cycle payment is paid for.
|
|
2043
|
+
* + Offline order is created, even if not yet marked as paid.
|
|
2044
|
+
* + Free order is created.
|
|
2091
2045
|
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2092
2046
|
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2093
2047
|
* @permissionScope Manage Orders
|
|
@@ -2097,188 +2051,60 @@ interface OrderStartDateChangedEnvelope {
|
|
|
2097
2051
|
* @permissionScope Manage plans and orders of Pricing Plans
|
|
2098
2052
|
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-PLANS-AND-ORDERS
|
|
2099
2053
|
* @permissionScope Manage Events
|
|
2100
|
-
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2101
|
-
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2102
|
-
* @webhook
|
|
2103
|
-
* @eventType wix.pricing_plans.v2.
|
|
2104
|
-
* @serviceIdentifier com.wixpress.membership.v2.orders.
|
|
2105
|
-
* @slug
|
|
2106
|
-
*/
|
|
2107
|
-
declare function onOrderStartDateChanged(handler: (event: OrderStartDateChangedEnvelope) => void | Promise<void>): void;
|
|
2108
|
-
/**
|
|
2109
|
-
* Retrieves an order by ID.
|
|
2110
|
-
* @param _id - Order ID.
|
|
2111
|
-
* @public
|
|
2112
|
-
* @requiredField _id
|
|
2113
|
-
* @param options - Options to use when getting an order.
|
|
2114
|
-
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2115
|
-
* @applicableIdentity APP
|
|
2116
|
-
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.GetOrder
|
|
2117
|
-
*/
|
|
2118
|
-
declare function managementGetOrder(_id: string, options?: ManagementGetOrderOptions): Promise<NonNullablePaths<GetOrderResponse, `order._id` | `order.planId` | `order.subscriptionId` | `order.buyer.memberId` | `order.buyer.contactId` | `order.priceDetails.subscription.cycleDuration.unit` | `order.priceDetails.subtotal` | `order.priceDetails.discount` | `order.priceDetails.tax.name` | `order.priceDetails.tax.includedInPrice` | `order.priceDetails.tax.rate` | `order.priceDetails.tax.amount` | `order.priceDetails.total` | `order.priceDetails.planPrice` | `order.priceDetails.currency` | `order.priceDetails.coupon.code` | `order.priceDetails.coupon.amount` | `order.priceDetails.coupon._id` | `order.pricing.prices` | `order.pricing.prices.${number}.duration.cycleFrom` | `order.pricing.prices.${number}.price.subtotal` | `order.pricing.prices.${number}.price.discount` | `order.pricing.prices.${number}.price.total` | `order.pricing.prices.${number}.price.currency` | `order.pricing.prices.${number}.price.proration` | `order.type` | `order.status` | `order.cancellation.cause` | `order.cancellation.effectiveAt` | `order.lastPaymentStatus` | `order.pausePeriods` | `order.pausePeriods.${number}.status` | `order.currentCycle.index` | `order.planName` | `order.planDescription` | `order.planPrice`, 5>>;
|
|
2119
|
-
interface ManagementGetOrderOptions {
|
|
2120
|
-
/**
|
|
2121
|
-
* Predefined set of fields to return.
|
|
2122
|
-
*
|
|
2123
|
-
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
2124
|
-
*/
|
|
2125
|
-
fieldSet?: SetWithLiterals;
|
|
2126
|
-
}
|
|
2127
|
-
/**
|
|
2128
|
-
* Retrieves a list of up to 50 pricing plan orders and details, given the specified sorting and filtering.
|
|
2129
|
-
*
|
|
2130
|
-
* By default, this endpoint will retrieve all orders and return them sorted by `createdDate` in `DESC`, descending order.
|
|
2131
|
-
* `sort.fieldName` supports `endDate` and `createdDate` fields and defaults to `ASC`, ascending order.
|
|
2132
|
-
* @public
|
|
2133
|
-
* @param options - Filtering, sorting, and pagination options.
|
|
2134
|
-
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2135
|
-
* @applicableIdentity APP
|
|
2136
|
-
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.ListOrders
|
|
2137
|
-
*/
|
|
2138
|
-
declare function managementListOrders(options?: ManagementListOrdersOptions): Promise<NonNullablePaths<ListOrdersResponse, `orders` | `orders.${number}._id` | `orders.${number}.planId` | `orders.${number}.subscriptionId` | `orders.${number}.buyer.memberId` | `orders.${number}.buyer.contactId` | `orders.${number}.priceDetails.singlePaymentForDuration.unit` | `orders.${number}.priceDetails.subtotal` | `orders.${number}.priceDetails.discount` | `orders.${number}.priceDetails.tax.name` | `orders.${number}.priceDetails.tax.includedInPrice` | `orders.${number}.priceDetails.tax.rate` | `orders.${number}.priceDetails.tax.amount` | `orders.${number}.priceDetails.total` | `orders.${number}.priceDetails.planPrice` | `orders.${number}.priceDetails.currency` | `orders.${number}.priceDetails.coupon.code` | `orders.${number}.priceDetails.coupon.amount` | `orders.${number}.priceDetails.coupon._id` | `orders.${number}.type` | `orders.${number}.status` | `orders.${number}.cancellation.cause` | `orders.${number}.cancellation.effectiveAt` | `orders.${number}.lastPaymentStatus` | `orders.${number}.currentCycle.index` | `orders.${number}.planName` | `orders.${number}.planDescription` | `orders.${number}.planPrice`, 4>>;
|
|
2139
|
-
interface ManagementListOrdersOptions {
|
|
2140
|
-
/**
|
|
2141
|
-
* Filter by a buyer's member ID, from the Members API.
|
|
2142
|
-
* @format GUID
|
|
2143
|
-
*/
|
|
2144
|
-
buyerIds?: string[];
|
|
2145
|
-
/**
|
|
2146
|
-
* Filter by plan IDs, from the Plans API.
|
|
2147
|
-
* @format GUID
|
|
2148
|
-
*/
|
|
2149
|
-
planIds?: string[];
|
|
2150
|
-
/** Filter by whether or not the auto-renewal of recurring orders was canceled. */
|
|
2151
|
-
autoRenewCanceled?: boolean | null;
|
|
2152
|
-
/** Filter by order status. */
|
|
2153
|
-
orderStatuses?: OrderStatusWithLiterals[];
|
|
2154
|
-
/** Filter by payment status. */
|
|
2155
|
-
paymentStatuses?: PaymentStatusWithLiterals[];
|
|
2156
|
-
/**
|
|
2157
|
-
* Number of orders to return. See Sorting and Paging for more information.
|
|
2158
|
-
*
|
|
2159
|
-
* Max: `50`
|
|
2160
|
-
* @min 1
|
|
2161
|
-
* @max 50
|
|
2162
|
-
*/
|
|
2163
|
-
limit?: number | null;
|
|
2164
|
-
/** Number of orders to skip in the current sort order. */
|
|
2165
|
-
offset?: number | null;
|
|
2166
|
-
/**
|
|
2167
|
-
* Sort order.
|
|
2168
|
-
*
|
|
2169
|
-
* Use `ASC` for ascending order or `DESC` for descending order.
|
|
2170
|
-
*
|
|
2171
|
-
* Default: `DESC`.
|
|
2172
|
-
*/
|
|
2173
|
-
sorting?: Sorting;
|
|
2174
|
-
/**
|
|
2175
|
-
* Predefined set of fields to return.
|
|
2176
|
-
*
|
|
2177
|
-
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
2178
|
-
*/
|
|
2179
|
-
fieldSet?: SetWithLiterals;
|
|
2180
|
-
}
|
|
2181
|
-
/**
|
|
2182
|
-
* Extends the duration of a pricing plan order by postponing the order's `endDate`. Postponing the end date of an order does not impact payments.
|
|
2183
|
-
*
|
|
2184
|
-
* New `endDate` must be later than the order's current `endDate`. Can't postpone orders that are unlimited.
|
|
2185
|
-
* Can't postpone an order with `status`: `PAUSED`.
|
|
2186
|
-
* @param _id - Order ID.
|
|
2187
|
-
* @param endDate - New end date and time.
|
|
2188
|
-
*
|
|
2189
|
-
* Must be later than the current end date and time.
|
|
2190
|
-
* @public
|
|
2191
|
-
* @requiredField _id
|
|
2192
|
-
* @requiredField endDate
|
|
2193
|
-
* @param options - Options for postponing the end date of an order.
|
|
2194
|
-
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2195
|
-
* @applicableIdentity APP
|
|
2196
|
-
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.PostponeEndDate
|
|
2197
|
-
*/
|
|
2198
|
-
declare function postponeEndDate(_id: string, endDate: Date): Promise<void>;
|
|
2199
|
-
/**
|
|
2200
|
-
* Cancels an existing order.
|
|
2201
|
-
*
|
|
2202
|
-
* For orders with recurring payments, a cancellation can be set to occur either `IMMEDIATELY` or at the `NEXT_PAYMENT_DATE`.
|
|
2203
|
-
* For orders with one-time payments, a cancellation can only be set for `IMMEDIATELY`.
|
|
2204
|
-
*
|
|
2205
|
-
* #### Canceling during the free trial period.
|
|
2206
|
-
*
|
|
2207
|
-
* When a buyer cancels their order during the free trial period, the buyer's subscription expires at the end
|
|
2208
|
-
* of the free trial period and they will not be billed. The buyer may continue using the benefits until the end
|
|
2209
|
-
* of the free trial period.
|
|
2210
|
-
*
|
|
2211
|
-
* When a Wix user cancels an ordered plan during the free trial period, they choose whether to apply the cancellation
|
|
2212
|
-
* `IMMEDIATELY` or at the `NEXT_PAYMENT_DATE`. Canceling `IMMEDIATELY` will end the subscription for the buyer
|
|
2213
|
-
* immediately, even during the free trial period and the buyer won't be billed. Canceling at the
|
|
2214
|
-
* `NEXT_PAYMENT_DATE` allows the buyer to continue using the benefits of the subscription until the end of the free trial period.
|
|
2215
|
-
* Then, the subscription ends and the buyer is not billed.
|
|
2216
|
-
* @param _id - Order ID.
|
|
2217
|
-
* @param effectiveAt - __Required.__ When the order will be canceled. One-time orders can only be canceled `IMMEDIATELY`.
|
|
2218
|
-
* @public
|
|
2219
|
-
* @requiredField _id
|
|
2220
|
-
* @requiredField effectiveAt
|
|
2221
|
-
* @param options - Options for canceling orders.
|
|
2222
|
-
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2223
|
-
* @applicableIdentity APP
|
|
2224
|
-
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.CancelOrder
|
|
2225
|
-
*/
|
|
2226
|
-
declare function cancelOrder(_id: string, effectiveAt: CancellationEffectiveAtWithLiterals): Promise<void>;
|
|
2227
|
-
/**
|
|
2228
|
-
* Marks an offline order as paid.
|
|
2229
|
-
* > __Note__: Marking separate payment cycles as paid is not yet supported. The entire order will be marked as paid. Subsequent offline payments do trigger events and emails, but are not registered as additional offline payments.
|
|
2230
|
-
*
|
|
2231
|
-
* Marking an offline order as paid causes the following changes:
|
|
2232
|
-
* - The order's `lastPaymentStatus` changes to `"PAID"`.
|
|
2233
|
-
* - The order's status changes to either `"PENDING"` or `"ACTIVE"`, depending on the order's `startDate`.
|
|
2234
|
-
*
|
|
2235
|
-
* An error occurs if you attempt to:
|
|
2236
|
-
* - Mark an already-paid, offline order as paid. You cannot mark an offline order as paid twice.
|
|
2237
|
-
* - Mark an online order as paid. The Mark as Paid method is supported for offline orders only.
|
|
2238
|
-
* @param _id - Order ID.
|
|
2239
|
-
* @public
|
|
2240
|
-
* @requiredField _id
|
|
2241
|
-
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2242
|
-
* @applicableIdentity APP
|
|
2243
|
-
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.MarkAsPaid
|
|
2054
|
+
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2055
|
+
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2056
|
+
* @webhook
|
|
2057
|
+
* @eventType wix.pricing_plans.v2.order_purchased
|
|
2058
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2059
|
+
* @slug purchased
|
|
2244
2060
|
*/
|
|
2245
|
-
declare function
|
|
2061
|
+
declare function onOrderPurchased(handler: (event: OrderPurchasedEnvelope) => void | Promise<void>): void;
|
|
2062
|
+
interface OrderResumedEnvelope {
|
|
2063
|
+
data: OrderResumed;
|
|
2064
|
+
metadata: EventMetadata;
|
|
2065
|
+
}
|
|
2246
2066
|
/**
|
|
2247
|
-
*
|
|
2248
|
-
*
|
|
2249
|
-
*
|
|
2250
|
-
*
|
|
2251
|
-
*
|
|
2252
|
-
*
|
|
2253
|
-
*
|
|
2254
|
-
*
|
|
2255
|
-
* @
|
|
2256
|
-
* @
|
|
2257
|
-
* @
|
|
2258
|
-
* @permissionId PRICING_PLANS.
|
|
2259
|
-
* @
|
|
2260
|
-
* @
|
|
2067
|
+
* Triggered when a paused order is resumed.
|
|
2068
|
+
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2069
|
+
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2070
|
+
* @permissionScope Manage Orders
|
|
2071
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-ORDERS
|
|
2072
|
+
* @permissionScope Read Orders
|
|
2073
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.READ-ORDERS
|
|
2074
|
+
* @permissionScope Manage plans and orders of Pricing Plans
|
|
2075
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-PLANS-AND-ORDERS
|
|
2076
|
+
* @permissionScope Manage Events
|
|
2077
|
+
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2078
|
+
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2079
|
+
* @webhook
|
|
2080
|
+
* @eventType wix.pricing_plans.v2.order_resumed
|
|
2081
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2082
|
+
* @slug resumed
|
|
2261
2083
|
*/
|
|
2262
|
-
declare function
|
|
2084
|
+
declare function onOrderResumed(handler: (event: OrderResumedEnvelope) => void | Promise<void>): void;
|
|
2085
|
+
interface OrderStartedEnvelope {
|
|
2086
|
+
data: OrderStarted;
|
|
2087
|
+
metadata: EventMetadata;
|
|
2088
|
+
}
|
|
2263
2089
|
/**
|
|
2264
|
-
*
|
|
2265
|
-
*
|
|
2266
|
-
*
|
|
2267
|
-
*
|
|
2268
|
-
*
|
|
2269
|
-
*
|
|
2270
|
-
*
|
|
2271
|
-
*
|
|
2272
|
-
*
|
|
2273
|
-
*
|
|
2274
|
-
* @
|
|
2275
|
-
* @
|
|
2276
|
-
* @
|
|
2277
|
-
* @
|
|
2278
|
-
* @
|
|
2279
|
-
* @
|
|
2090
|
+
* Triggered when an order reaches its `startDate`. Applies to both purchased and free orders.
|
|
2091
|
+
* @permissionScope Manage_Wix_Rentals_App_Forms_submissions
|
|
2092
|
+
* @permissionScopeId SCOPE.RENTALS.MANAGE
|
|
2093
|
+
* @permissionScope Manage Orders
|
|
2094
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-ORDERS
|
|
2095
|
+
* @permissionScope Read Orders
|
|
2096
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.READ-ORDERS
|
|
2097
|
+
* @permissionScope Manage plans and orders of Pricing Plans
|
|
2098
|
+
* @permissionScopeId SCOPE.DC-PAIDPLANS.MANAGE-PLANS-AND-ORDERS
|
|
2099
|
+
* @permissionScope Manage Events
|
|
2100
|
+
* @permissionScopeId SCOPE.EVENTS.MANAGE-EVENTS
|
|
2101
|
+
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2102
|
+
* @webhook
|
|
2103
|
+
* @eventType wix.pricing_plans.v2.order_started
|
|
2104
|
+
* @serviceIdentifier com.wixpress.membership.v2.orders.OrderManagementService
|
|
2105
|
+
* @slug started
|
|
2280
2106
|
*/
|
|
2281
|
-
declare function
|
|
2107
|
+
declare function onOrderStarted(handler: (event: OrderStartedEnvelope) => void | Promise<void>): void;
|
|
2282
2108
|
/**
|
|
2283
2109
|
* Creates an online order for a site member.
|
|
2284
2110
|
*
|
|
@@ -2479,6 +2305,180 @@ interface GetPricePreviewOptions {
|
|
|
2479
2305
|
*/
|
|
2480
2306
|
couponCode?: string | null;
|
|
2481
2307
|
}
|
|
2308
|
+
/**
|
|
2309
|
+
* Retrieves an order by ID.
|
|
2310
|
+
* @param _id - Order ID.
|
|
2311
|
+
* @public
|
|
2312
|
+
* @requiredField _id
|
|
2313
|
+
* @param options - Options to use when getting an order.
|
|
2314
|
+
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2315
|
+
* @applicableIdentity APP
|
|
2316
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.GetOrder
|
|
2317
|
+
*/
|
|
2318
|
+
declare function managementGetOrder(_id: string, options?: ManagementGetOrderOptions): Promise<NonNullablePaths<GetOrderResponse, `order._id` | `order.planId` | `order.subscriptionId` | `order.buyer.memberId` | `order.buyer.contactId` | `order.priceDetails.subscription.cycleDuration.unit` | `order.priceDetails.subtotal` | `order.priceDetails.discount` | `order.priceDetails.tax.name` | `order.priceDetails.tax.includedInPrice` | `order.priceDetails.tax.rate` | `order.priceDetails.tax.amount` | `order.priceDetails.total` | `order.priceDetails.planPrice` | `order.priceDetails.currency` | `order.priceDetails.coupon.code` | `order.priceDetails.coupon.amount` | `order.priceDetails.coupon._id` | `order.pricing.prices` | `order.pricing.prices.${number}.duration.cycleFrom` | `order.pricing.prices.${number}.price.subtotal` | `order.pricing.prices.${number}.price.discount` | `order.pricing.prices.${number}.price.total` | `order.pricing.prices.${number}.price.currency` | `order.pricing.prices.${number}.price.proration` | `order.type` | `order.status` | `order.cancellation.cause` | `order.cancellation.effectiveAt` | `order.lastPaymentStatus` | `order.pausePeriods` | `order.pausePeriods.${number}.status` | `order.currentCycle.index` | `order.planName` | `order.planDescription` | `order.planPrice`, 5>>;
|
|
2319
|
+
interface ManagementGetOrderOptions {
|
|
2320
|
+
/**
|
|
2321
|
+
* Predefined set of fields to return.
|
|
2322
|
+
*
|
|
2323
|
+
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
2324
|
+
*/
|
|
2325
|
+
fieldSet?: SetWithLiterals;
|
|
2326
|
+
}
|
|
2327
|
+
/**
|
|
2328
|
+
* Retrieves a list of up to 50 pricing plan orders and details, given the specified sorting and filtering.
|
|
2329
|
+
*
|
|
2330
|
+
* By default, this endpoint will retrieve all orders and return them sorted by `createdDate` in `DESC`, descending order.
|
|
2331
|
+
* `sort.fieldName` supports `endDate` and `createdDate` fields and defaults to `ASC`, ascending order.
|
|
2332
|
+
* @public
|
|
2333
|
+
* @param options - Filtering, sorting, and pagination options.
|
|
2334
|
+
* @permissionId PRICING_PLANS.READ_ORDERS
|
|
2335
|
+
* @applicableIdentity APP
|
|
2336
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.ListOrders
|
|
2337
|
+
*/
|
|
2338
|
+
declare function managementListOrders(options?: ManagementListOrdersOptions): Promise<NonNullablePaths<ListOrdersResponse, `orders` | `orders.${number}._id` | `orders.${number}.planId` | `orders.${number}.subscriptionId` | `orders.${number}.buyer.memberId` | `orders.${number}.buyer.contactId` | `orders.${number}.priceDetails.singlePaymentForDuration.unit` | `orders.${number}.priceDetails.subtotal` | `orders.${number}.priceDetails.discount` | `orders.${number}.priceDetails.tax.name` | `orders.${number}.priceDetails.tax.includedInPrice` | `orders.${number}.priceDetails.tax.rate` | `orders.${number}.priceDetails.tax.amount` | `orders.${number}.priceDetails.total` | `orders.${number}.priceDetails.planPrice` | `orders.${number}.priceDetails.currency` | `orders.${number}.priceDetails.coupon.code` | `orders.${number}.priceDetails.coupon.amount` | `orders.${number}.priceDetails.coupon._id` | `orders.${number}.type` | `orders.${number}.status` | `orders.${number}.cancellation.cause` | `orders.${number}.cancellation.effectiveAt` | `orders.${number}.lastPaymentStatus` | `orders.${number}.currentCycle.index` | `orders.${number}.planName` | `orders.${number}.planDescription` | `orders.${number}.planPrice`, 4>>;
|
|
2339
|
+
interface ManagementListOrdersOptions {
|
|
2340
|
+
/**
|
|
2341
|
+
* Filter by a buyer's member ID, from the Members API.
|
|
2342
|
+
* @format GUID
|
|
2343
|
+
*/
|
|
2344
|
+
buyerIds?: string[];
|
|
2345
|
+
/**
|
|
2346
|
+
* Filter by plan IDs, from the Plans API.
|
|
2347
|
+
* @format GUID
|
|
2348
|
+
*/
|
|
2349
|
+
planIds?: string[];
|
|
2350
|
+
/** Filter by whether or not the auto-renewal of recurring orders was canceled. */
|
|
2351
|
+
autoRenewCanceled?: boolean | null;
|
|
2352
|
+
/** Filter by order status. */
|
|
2353
|
+
orderStatuses?: OrderStatusWithLiterals[];
|
|
2354
|
+
/** Filter by payment status. */
|
|
2355
|
+
paymentStatuses?: PaymentStatusWithLiterals[];
|
|
2356
|
+
/**
|
|
2357
|
+
* Number of orders to return. See Sorting and Paging for more information.
|
|
2358
|
+
*
|
|
2359
|
+
* Max: `50`
|
|
2360
|
+
* @min 1
|
|
2361
|
+
* @max 50
|
|
2362
|
+
*/
|
|
2363
|
+
limit?: number | null;
|
|
2364
|
+
/** Number of orders to skip in the current sort order. */
|
|
2365
|
+
offset?: number | null;
|
|
2366
|
+
/**
|
|
2367
|
+
* Sort order.
|
|
2368
|
+
*
|
|
2369
|
+
* Use `ASC` for ascending order or `DESC` for descending order.
|
|
2370
|
+
*
|
|
2371
|
+
* Default: `DESC`.
|
|
2372
|
+
*/
|
|
2373
|
+
sorting?: Sorting;
|
|
2374
|
+
/**
|
|
2375
|
+
* Predefined set of fields to return.
|
|
2376
|
+
*
|
|
2377
|
+
* Default: If `fieldSet` is omitted, no order form submission data is returned.
|
|
2378
|
+
*/
|
|
2379
|
+
fieldSet?: SetWithLiterals;
|
|
2380
|
+
}
|
|
2381
|
+
/**
|
|
2382
|
+
* Extends the duration of a pricing plan order by postponing the order's `endDate`. Postponing the end date of an order does not impact payments.
|
|
2383
|
+
*
|
|
2384
|
+
* New `endDate` must be later than the order's current `endDate`. Can't postpone orders that are unlimited.
|
|
2385
|
+
* Can't postpone an order with `status`: `PAUSED`.
|
|
2386
|
+
* @param _id - Order ID.
|
|
2387
|
+
* @param endDate - New end date and time.
|
|
2388
|
+
*
|
|
2389
|
+
* Must be later than the current end date and time.
|
|
2390
|
+
* @public
|
|
2391
|
+
* @requiredField _id
|
|
2392
|
+
* @requiredField endDate
|
|
2393
|
+
* @param options - Options for postponing the end date of an order.
|
|
2394
|
+
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2395
|
+
* @applicableIdentity APP
|
|
2396
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.PostponeEndDate
|
|
2397
|
+
*/
|
|
2398
|
+
declare function postponeEndDate(_id: string, endDate: Date): Promise<void>;
|
|
2399
|
+
/**
|
|
2400
|
+
* Cancels an existing order.
|
|
2401
|
+
*
|
|
2402
|
+
* For orders with recurring payments, a cancellation can be set to occur either `IMMEDIATELY` or at the `NEXT_PAYMENT_DATE`.
|
|
2403
|
+
* For orders with one-time payments, a cancellation can only be set for `IMMEDIATELY`.
|
|
2404
|
+
*
|
|
2405
|
+
* #### Canceling during the free trial period.
|
|
2406
|
+
*
|
|
2407
|
+
* When a buyer cancels their order during the free trial period, the buyer's subscription expires at the end
|
|
2408
|
+
* of the free trial period and they will not be billed. The buyer may continue using the benefits until the end
|
|
2409
|
+
* of the free trial period.
|
|
2410
|
+
*
|
|
2411
|
+
* When a Wix user cancels an ordered plan during the free trial period, they choose whether to apply the cancellation
|
|
2412
|
+
* `IMMEDIATELY` or at the `NEXT_PAYMENT_DATE`. Canceling `IMMEDIATELY` will end the subscription for the buyer
|
|
2413
|
+
* immediately, even during the free trial period and the buyer won't be billed. Canceling at the
|
|
2414
|
+
* `NEXT_PAYMENT_DATE` allows the buyer to continue using the benefits of the subscription until the end of the free trial period.
|
|
2415
|
+
* Then, the subscription ends and the buyer is not billed.
|
|
2416
|
+
* @param _id - Order ID.
|
|
2417
|
+
* @param effectiveAt - __Required.__ When the order will be canceled. One-time orders can only be canceled `IMMEDIATELY`.
|
|
2418
|
+
* @public
|
|
2419
|
+
* @requiredField _id
|
|
2420
|
+
* @requiredField effectiveAt
|
|
2421
|
+
* @param options - Options for canceling orders.
|
|
2422
|
+
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2423
|
+
* @applicableIdentity APP
|
|
2424
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.CancelOrder
|
|
2425
|
+
*/
|
|
2426
|
+
declare function cancelOrder(_id: string, effectiveAt: CancellationEffectiveAtWithLiterals): Promise<void>;
|
|
2427
|
+
/**
|
|
2428
|
+
* Marks an offline order as paid.
|
|
2429
|
+
* > __Note__: Marking separate payment cycles as paid is not yet supported. The entire order will be marked as paid. Subsequent offline payments do trigger events and emails, but are not registered as additional offline payments.
|
|
2430
|
+
*
|
|
2431
|
+
* Marking an offline order as paid causes the following changes:
|
|
2432
|
+
* - The order's `lastPaymentStatus` changes to `"PAID"`.
|
|
2433
|
+
* - The order's status changes to either `"PENDING"` or `"ACTIVE"`, depending on the order's `startDate`.
|
|
2434
|
+
*
|
|
2435
|
+
* An error occurs if you attempt to:
|
|
2436
|
+
* - Mark an already-paid, offline order as paid. You cannot mark an offline order as paid twice.
|
|
2437
|
+
* - Mark an online order as paid. The Mark as Paid method is supported for offline orders only.
|
|
2438
|
+
* @param _id - Order ID.
|
|
2439
|
+
* @public
|
|
2440
|
+
* @requiredField _id
|
|
2441
|
+
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2442
|
+
* @applicableIdentity APP
|
|
2443
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.MarkAsPaid
|
|
2444
|
+
*/
|
|
2445
|
+
declare function markAsPaid(_id: string): Promise<void>;
|
|
2446
|
+
/**
|
|
2447
|
+
* Pauses an order. Calling this method changes the order status to `"PAUSED"` and updates the `pausePeriods` array.
|
|
2448
|
+
*
|
|
2449
|
+
* Only orders with `status`: `ACTIVE` can be paused.
|
|
2450
|
+
* For orders with recurring payments, it also pauses the payment schedule. Buyers are not charged when an order is paused.
|
|
2451
|
+
* Pausing an order affects the end date of the order by adding the time the order is paused to the `endDate`.
|
|
2452
|
+
* The `endDate` and the `earliestEndDate` for the order are adjusted to include the pause period when the order is resumed.
|
|
2453
|
+
*
|
|
2454
|
+
* To resume a paused order, call Resume Order.
|
|
2455
|
+
* @param _id - Order ID.
|
|
2456
|
+
* @public
|
|
2457
|
+
* @requiredField _id
|
|
2458
|
+
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2459
|
+
* @applicableIdentity APP
|
|
2460
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.PauseOrder
|
|
2461
|
+
*/
|
|
2462
|
+
declare function pauseOrder(_id: string): Promise<void>;
|
|
2463
|
+
/**
|
|
2464
|
+
* Resumes a paused order. For orders with recurring payments, it also restarts the payment schedule.
|
|
2465
|
+
*
|
|
2466
|
+
* Resuming an order causes the following changes:
|
|
2467
|
+
* - The order status changes to `"ACTIVE"`.
|
|
2468
|
+
* - The `pausePeriods` array is updated.
|
|
2469
|
+
* - The `endDate` for the order is adjusted to include the pause period.
|
|
2470
|
+
* - For orders with recurring payments, the payment schedule is restarted.
|
|
2471
|
+
* - The `earliestEndDate` is adjusted to include the pause period. (This property is reserved for future use).
|
|
2472
|
+
*
|
|
2473
|
+
* To pause an order, call Pause Order.
|
|
2474
|
+
* @param _id - Order ID.
|
|
2475
|
+
* @public
|
|
2476
|
+
* @requiredField _id
|
|
2477
|
+
* @permissionId PRICING_PLANS.MANAGE_ORDERS
|
|
2478
|
+
* @applicableIdentity APP
|
|
2479
|
+
* @fqn com.wixpress.membership.v2.orders.OrderManagementService.ResumeOrder
|
|
2480
|
+
*/
|
|
2481
|
+
declare function resumeOrder(_id: string): Promise<void>;
|
|
2482
2482
|
/**
|
|
2483
2483
|
* Retrieves an order for the currently logged-in member by ID.
|
|
2484
2484
|
* @param _id - Order ID.
|