straumur-web-component 2.0.0-alpha.21 → 2.0.0-alpha.23

package/dist/index.d.cts

@@ -135,16 +135,16 @@ type StraumurWebBaseConfiguration = {
     placeholders?: Placeholders;
     locale?: PublicLocale;
     localizations?: Partial<Record<Language, Partial<Record<TranslationKey, string>>>>;
-    instantPayments?: UniqueInstantPayments;
+    instantPayments?: InstantPaymentMethod[];
     hideSubmitButton?: boolean;
     onCardValidityChanged?: (isValid: boolean, isActive: boolean) => void;
     allowedPaymentMethods?: PaymentMethod[];
     /**
-     * Top-to-bottom order of the payment-method options. Tokens: "card", "storedcard", "googlepay",
-     * "applepay", and "instantpayments" (the express wallet row). A wallet listed in `instantPayments`
-     * renders only inside the "instantpayments" slot, never standalone, so its standalone token here is
-     * effectively ignored. Any available method you omit is appended in the default order. Defaults to
-     * ["instantpayments", "storedcard", "card", "googlepay", "applepay"].
+     * Top-to-bottom order of the payment-method options. Tokens: "card", "storedcard", "kortalan",
+     * "googlepay", "applepay", and "instantpayments" (the express row). A method listed in
+     * `instantPayments` renders only inside the "instantpayments" slot, never standalone, so its
+     * standalone token here is effectively ignored. Any available method you omit is appended in the
+     * default order. Defaults to ["instantpayments", "storedcard", "card", "kortalan", "googlepay", "applepay"].
      */
     orderPaymentMethods?: PaymentMethodOrder[];
     /**
@@ -202,6 +202,12 @@ type PaymentFlowResult = {
      * instead of the generic localized one (advanced mode only).
      */
     errorMessage?: string;
+    /**
+     * The per-attempt reference from the /payment response. In advanced mode the host surfaces it here so the
+     * component can auto-attach it to a native (in-component) 3DS /details continuation. Redirect continuations
+     * pass it explicitly via submitDetails instead.
+     */
+    paymentCheckoutReference?: string;
 };
 interface PaymentFlow {
     submitPayment(data: AdvancedSubmitState["data"]): Promise<PaymentFlowResult>;
@@ -214,7 +220,13 @@ type ResultMessage = {
 } | {
     text: string;
 };
-type UniqueInstantPayments = [Extract<PaymentMethod, "googlepay">] | [Extract<PaymentMethod, "applepay">] | [Extract<PaymentMethod, "googlepay">, Extract<PaymentMethod, "applepay">] | [Extract<PaymentMethod, "applepay">, Extract<PaymentMethod, "googlepay">];
+/**
+ * A payment method that can be placed in `instantPayments` to render as an express button at the top
+ * of the widget: the two Adyen wallets and Kortalán (a redirect method). Duplicates are ignored at
+ * runtime (the instant strip dedupes), so this is a plain array rather than a unique-tuple union —
+ * enumerating every permutation of three methods is unmaintainable.
+ */
+type InstantPaymentMethod = Extract<PaymentMethod, "googlepay" | "applepay" | "kortalan">;
 type StraumurCheckoutConfiguration = {
     mode: "session" | "advanced";
     sessionId?: string;
@@ -226,7 +238,7 @@ type StraumurCheckoutConfiguration = {
     placeholders?: Placeholders;
     locale: Language;
     customLocalizations?: Partial<Record<Language, Partial<Record<TranslationKey, string>>>>;
-    instantPayments?: UniqueInstantPayments;
+    instantPayments?: InstantPaymentMethod[];
     hideSubmitButton?: boolean;
     onCardValidityChanged?: (isValid: boolean, isActive: boolean) => void;
     allowedPaymentMethods?: PaymentMethod[];

package/dist/index.d.ts

@@ -135,16 +135,16 @@ type StraumurWebBaseConfiguration = {
     placeholders?: Placeholders;
     locale?: PublicLocale;
     localizations?: Partial<Record<Language, Partial<Record<TranslationKey, string>>>>;
-    instantPayments?: UniqueInstantPayments;
+    instantPayments?: InstantPaymentMethod[];
     hideSubmitButton?: boolean;
     onCardValidityChanged?: (isValid: boolean, isActive: boolean) => void;
     allowedPaymentMethods?: PaymentMethod[];
     /**
-     * Top-to-bottom order of the payment-method options. Tokens: "card", "storedcard", "googlepay",
-     * "applepay", and "instantpayments" (the express wallet row). A wallet listed in `instantPayments`
-     * renders only inside the "instantpayments" slot, never standalone, so its standalone token here is
-     * effectively ignored. Any available method you omit is appended in the default order. Defaults to
-     * ["instantpayments", "storedcard", "card", "googlepay", "applepay"].
+     * Top-to-bottom order of the payment-method options. Tokens: "card", "storedcard", "kortalan",
+     * "googlepay", "applepay", and "instantpayments" (the express row). A method listed in
+     * `instantPayments` renders only inside the "instantpayments" slot, never standalone, so its
+     * standalone token here is effectively ignored. Any available method you omit is appended in the
+     * default order. Defaults to ["instantpayments", "storedcard", "card", "kortalan", "googlepay", "applepay"].
      */
     orderPaymentMethods?: PaymentMethodOrder[];
     /**
@@ -202,6 +202,12 @@ type PaymentFlowResult = {
      * instead of the generic localized one (advanced mode only).
      */
     errorMessage?: string;
+    /**
+     * The per-attempt reference from the /payment response. In advanced mode the host surfaces it here so the
+     * component can auto-attach it to a native (in-component) 3DS /details continuation. Redirect continuations
+     * pass it explicitly via submitDetails instead.
+     */
+    paymentCheckoutReference?: string;
 };
 interface PaymentFlow {
     submitPayment(data: AdvancedSubmitState["data"]): Promise<PaymentFlowResult>;
@@ -214,7 +220,13 @@ type ResultMessage = {
 } | {
     text: string;
 };
-type UniqueInstantPayments = [Extract<PaymentMethod, "googlepay">] | [Extract<PaymentMethod, "applepay">] | [Extract<PaymentMethod, "googlepay">, Extract<PaymentMethod, "applepay">] | [Extract<PaymentMethod, "applepay">, Extract<PaymentMethod, "googlepay">];
+/**
+ * A payment method that can be placed in `instantPayments` to render as an express button at the top
+ * of the widget: the two Adyen wallets and Kortalán (a redirect method). Duplicates are ignored at
+ * runtime (the instant strip dedupes), so this is a plain array rather than a unique-tuple union —
+ * enumerating every permutation of three methods is unmaintainable.
+ */
+type InstantPaymentMethod = Extract<PaymentMethod, "googlepay" | "applepay" | "kortalan">;
 type StraumurCheckoutConfiguration = {
     mode: "session" | "advanced";
     sessionId?: string;
@@ -226,7 +238,7 @@ type StraumurCheckoutConfiguration = {
     placeholders?: Placeholders;
     locale: Language;
     customLocalizations?: Partial<Record<Language, Partial<Record<TranslationKey, string>>>>;
-    instantPayments?: UniqueInstantPayments;
+    instantPayments?: InstantPaymentMethod[];
     hideSubmitButton?: boolean;
     onCardValidityChanged?: (isValid: boolean, isActive: boolean) => void;
     allowedPaymentMethods?: PaymentMethod[];