@funnelsgrove/payments 0.28.0 → 0.30.0

package/dist/generated/package-version.d.ts

@@ -1 +1 @@
-export declare const PAYMENTS_PACKAGE_VERSION = "0.28.0";
+export declare const PAYMENTS_PACKAGE_VERSION = "0.30.0";

package/dist/generated/package-version.js

@@ -1,2 +1,2 @@
 // Generated by scripts/generate-package-version.mjs.
-export const PAYMENTS_PACKAGE_VERSION = "0.28.0";
+export const PAYMENTS_PACKAGE_VERSION = "0.30.0";

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.js

@@ -3,8 +3,9 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { completePaywallCheckout } from '@funnelsgrove/runtime';
 import { publicAnalyticsSdk } from '@funnelsgrove/analytics';
 import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
-import { pollSolidgateCheckoutStatus, prepareSolidgateCheckout, } from '../services/solidgate.service.js';
+import { pollSolidgateCheckoutStatus, prepareSolidgateCheckout, SolidgateExistingSubscriptionError, } from '../services/solidgate.service.js';
 import { trackCheckoutCanceled, trackCheckoutFailureShown, } from '../../../services/checkoutObservability.service.js';
+import { solidgateDeclineMessage } from '../services/solidgateDeclineMessage.js';
 import { SolidgateCheckoutSummary } from './SolidgateCheckoutSummary.js';
 import { SolidgatePaymentForm } from './SolidgatePaymentForm.js';
 import { solidgateCheckoutDialogStyles } from './SolidgateCheckoutDialog.styles.js';
@@ -75,6 +76,7 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
     const [emailError, setEmailError] = useState(null);
     const [emailSubmitting, setEmailSubmitting] = useState(false);
     const [mountedPaymentAttemptId, setMountedPaymentAttemptId] = useState(null);
+    const declinedAttemptRef = useRef(null);
     const prepareAbortRef = useRef(null);
     const preparedRequestRef = useRef(null);
     const statusAbortRef = useRef(null);
@@ -105,6 +107,7 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
     const { discountKeyOrProviderId, failUrl, funnelPlanKey, paymentProfileId, providerPlanId, checkoutType, environment, funnelEndUserId, funnelId, idempotencyKey, offerSetId, returnUrl, runtimeConfig, successUrl, } = request;
     const checkoutKey = (retryRequest === null || retryRequest === void 0 ? void 0 : retryRequest.originalKey) === idempotencyKey
         ? retryRequest.key : idempotencyKey;
+    const retryAttemptId = (retryRequest === null || retryRequest === void 0 ? void 0 : retryRequest.originalKey) === idempotencyKey ? retryRequest.attemptId : request.retryAttemptId;
     const { apiBaseUrl, funnelId: runtimeFunnelId, funnelSdkPublishableKey, funnelVersionId, paymentsApiVersion, } = runtimeConfig || {};
     const hasRuntimeConfig = runtimeConfig !== undefined;
     const normalizedRequest = useMemo(() => ({
@@ -117,6 +120,7 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
         checkoutType: checkoutType || null,
         environment: environment || null,
         idempotencyKey: checkoutKey.trim(),
+        retryAttemptId,
         discountKeyOrProviderId: (discountKeyOrProviderId === null || discountKeyOrProviderId === void 0 ? void 0 : discountKeyOrProviderId.trim()) || null,
         returnUrl: returnUrl.trim(),
         successUrl: successUrl.trim(),
@@ -143,6 +147,7 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
         funnelVersionId,
         paymentsApiVersion,
         checkoutKey,
+        retryAttemptId,
         offerSetId,
         returnUrl,
         hasRuntimeConfig,
@@ -210,6 +215,7 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
         void prepareSolidgateCheckout(Object.assign(Object.assign({}, preparedRequest), { signal: controller.signal }))
             .then((checkout) => {
             if (!controller.signal.aborted) {
+                declinedAttemptRef.current = null;
                 setState({ state: 'ready', checkout, canResumeVerification: false });
                 if (layout !== 'wallet') {
                     void trackSolidgateCheckoutEvent('checkout_started', checkout.attemptId, checkoutAnalyticsRef.current);
@@ -219,9 +225,11 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
             .catch((error) => {
             var _a;
             if (!controller.signal.aborted && !isAbortError(error)) {
-                setState({ state: 'recoverable_error', checkout: null, canResumeVerification: false });
-                trackFailure(copyRef.current.error, 'checkout_session_creation');
-                (_a = onErrorRef.current) === null || _a === void 0 ? void 0 : _a.call(onErrorRef, copyRef.current.error);
+                const failureMessage = error instanceof SolidgateExistingSubscriptionError
+                    ? error.message : copyRef.current.error;
+                setState({ state: 'recoverable_error', checkout: null, canResumeVerification: false, failureMessage });
+                trackFailure(failureMessage, 'checkout_session_creation');
+                (_a = onErrorRef.current) === null || _a === void 0 ? void 0 : _a.call(onErrorRef, failureMessage, error instanceof SolidgateExistingSubscriptionError ? error.code : undefined);
             }
         });
         return () => controller.abort();
@@ -304,9 +312,11 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
                 trackFailure(copyRef.current.expired, 'payment_expired', checkout.attemptId);
             }
             else if (result.status === 'failed') {
-                setState({ state: 'recoverable_error', checkout, canResumeVerification: false });
-                trackFailure(copyRef.current.error, 'payment_failed', checkout.attemptId);
-                (_c = onErrorRef.current) === null || _c === void 0 ? void 0 : _c.call(onErrorRef, copyRef.current.error);
+                declinedAttemptRef.current = checkout.attemptId;
+                const failureMessage = solidgateDeclineMessage(result.failureCode);
+                setState({ state: 'recoverable_error', checkout, canResumeVerification: false, failureMessage });
+                trackFailure(failureMessage, 'payment_failed', checkout.attemptId);
+                (_c = onErrorRef.current) === null || _c === void 0 ? void 0 : _c.call(onErrorRef, failureMessage);
             }
             else if (result.status === 'requires_payment') {
                 setState({ state: 'ready', checkout, canResumeVerification: false });
@@ -380,20 +390,29 @@ export function SolidgateCheckoutDialog({ open, layout = 'dialog', request, cust
                     : view.state === 'expired'
                         ? copy.expired
                         : view.state === 'recoverable_error'
-                            ? copy.error
+                            ? view.failureMessage || copy.error
                             : null;
     const presentationStyle = presentation
         ? {
             '--solidgate-checkout-theme-color': presentation.themeColor,
         }
         : undefined;
-    const recoveryActions = (_jsxs(_Fragment, { children: [view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: () => void verifyCanonicalStatus(), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.resumeVerification })) : null, (view.state === 'recoverable_error' || view.state === 'expired') && !view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: onRetry || (() => {
+    const recoveryActions = (_jsxs(_Fragment, { children: [view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: () => void verifyCanonicalStatus(), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.resumeVerification })) : null, (view.state === 'recoverable_error' || view.state === 'expired') && !view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: () => {
+                    var _a;
+                    const source = checkoutType === 'subscription'
+                        ? declinedAttemptRef.current || (retryAttemptId ? ((_a = view.checkout) === null || _a === void 0 ? void 0 : _a.attemptId) || retryAttemptId : null)
+                        : null;
+                    if (!source && onRetry) {
+                        onRetry();
+                        return;
+                    }
                     preparedRequestRef.current = null;
                     setRetryRequest({
                         originalKey: idempotencyKey,
                         key: crypto.randomUUID(),
+                        attemptId: source,
                     });
-                }), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.retry })) : null] }));
+                }, className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.retry })) : null] }));
     const paymentForm = view.checkout ? (_jsx(SolidgatePaymentForm, { walletOnly: layout === 'wallet', secureLabel: presentation === null || presentation === void 0 ? void 0 : presentation.secureLabel, cardLabel: presentation === null || presentation === void 0 ? void 0 : presentation.cardLabel, paymentMethodLabel: presentation === null || presentation === void 0 ? void 0 : presentation.paymentMethodLabel, buttonColor: (presentation === null || presentation === void 0 ? void 0 : presentation.buttonColor) || '#3f51b5', cardSubmitLabel: (presentation === null || presentation === void 0 ? void 0 : presentation.cardSubmitLabel) || 'Pay securely', checkout: view.checkout, hidden: !showForm, loadingLabel: copy.loading, onMounted: () => {
             var _a;
             setMountedPaymentAttemptId(((_a = view.checkout) === null || _a === void 0 ? void 0 : _a.attemptId) || null);

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.types.d.ts

@@ -56,7 +56,7 @@ export type SolidgateCheckoutDialogProps = {
     onCustomerEmailCommit?: (email: string) => Promise<string>;
     onSuccess?: (checkout: SolidgateCheckoutPreparation) => void | Promise<void>;
     onRetry?: () => void;
-    onError?: (message: string) => void;
+    onError?: (message: string, code?: 'already_subscribed_to_product') => void;
     onPreparationStart?: () => void;
     /** True while a submitted payment still needs verification (including resumable errors). */
     onPaymentPendingChange?: (pending: boolean) => void;

package/dist/providers/solidgate/components/SolidgatePaymentForm.js

@@ -33,7 +33,7 @@ export function SolidgatePaymentForm({ buttonColor, walletOnly = false, cardSubm
             ].filter((method) => Boolean(method));
             setWallets((previous) => previous.join() === available.join() ? previous : available);
             if (!mountedReportedRef.current
-                && boundary.querySelector('iframe#solid-payment-form-iframe, iframe[name="solid-payment-form-iframe"]')) {
+                && boundary.querySelector('iframe#payment-form-iframe, iframe[name="payment-form-iframe"], iframe#solid-payment-form-iframe, iframe[name="solid-payment-form-iframe"]')) {
                 mountedReportedRef.current = true;
                 onMountedRef.current();
             }
@@ -44,7 +44,7 @@ export function SolidgatePaymentForm({ buttonColor, walletOnly = false, cardSubm
         return () => observer.disconnect();
     }, [checkout.attemptId]);
     const walletButtonType = checkout.display.billingInterval ? 'subscribe' : 'buy';
-    return (_jsxs("div", { ref: paymentBoundaryRef, className: `solidgate-checkout-payment${secureLabel && !walletOnly ? ' is-branded' : ''}`, "data-solidgate-attempt-id": checkout.attemptId, hidden: hidden, "aria-hidden": hidden || undefined, children: [showTabs ? (_jsxs("div", { className: 'solidgate-checkout-methods', role: 'tablist', "aria-label": paymentMethodLabel, children: [_jsx("button", { type: 'button', role: 'tab', id: `${panelId}-wallet-tab`, "aria-label": wallets.join(' / '), "aria-selected": selectedMethod === 'wallet', "aria-controls": `${panelId}-wallet`, className: 'solidgate-checkout-method', onClick: () => setSelectedMethod('wallet'), children: wallets.map((label) => _jsx(PaymentBrandMark, { label: label, className: 'solidgate-checkout-tab-wallet' }, label)) }), _jsxs("button", { type: 'button', role: 'tab', id: `${panelId}-card-tab`, "aria-selected": selectedMethod === 'card', "aria-controls": `${panelId}-card`, className: 'solidgate-checkout-method', onClick: () => setSelectedMethod('card'), children: [_jsx("strong", { children: cardLabel }), _jsx("span", { className: 'solidgate-checkout-tab-brands', "aria-hidden": 'true', children: ['Visa', 'Mastercard', 'Maestro', 'Discover'].map((label) => (_jsx(PaymentBrandMark, { label: label, className: 'solidgate-checkout-tab-brand' }, label))) })] })] })) : null, !walletOnly && secureLabel && wallets.length > 0 && showWallet ? (_jsxs("p", { className: 'solidgate-checkout-secure', children: [_jsx(SecurityLockIcon, {}), secureLabel] })) : null, _jsxs("div", { className: 'solidgate-checkout-wallets', id: `${panelId}-wallet`, role: showTabs ? 'tabpanel' : undefined, "aria-labelledby": showTabs ? `${panelId}-wallet-tab` : undefined, hidden: !showWallet, children: [_jsx("div", { ref: applePayContainerRef, "data-solidgate-wallet": 'apple-pay' }), _jsx("div", { ref: googlePayContainerRef, "data-solidgate-wallet": 'google-pay' })] }), _jsx("div", { className: 'solidgate-checkout-card', id: `${panelId}-card`, role: showTabs ? 'tabpanel' : undefined, "aria-labelledby": showTabs ? `${panelId}-card-tab` : undefined, hidden: !showCard, children: _jsx(SolidgateSdkPayment, { onInitializationError: onError, merchantData: checkout.initialization.merchantData, width: '100%', formParams: Object.assign({ autoFocus: false, enabled: !walletOnly, isSolidLogoVisible: true, submitButtonText: cardSubmitLabel }, (secureLabel ? { cardNumberLabel: 'Card number', cardExpiryDateLabel: 'Expiration date', cardCvvLabel: 'Security code' } : {})), styles: {
+    return (_jsxs("div", { ref: paymentBoundaryRef, className: `solidgate-checkout-payment${secureLabel && !walletOnly ? ' is-branded' : ''}`, "data-solidgate-attempt-id": checkout.attemptId, hidden: hidden, "aria-hidden": hidden || undefined, children: [showTabs ? (_jsxs("div", { className: 'solidgate-checkout-methods', role: 'tablist', "aria-label": paymentMethodLabel, children: [_jsx("button", { type: 'button', role: 'tab', id: `${panelId}-wallet-tab`, "aria-label": wallets.join(' / '), "aria-selected": selectedMethod === 'wallet', "aria-controls": `${panelId}-wallet`, className: 'solidgate-checkout-method', onClick: () => setSelectedMethod('wallet'), children: wallets.map((label) => _jsx(PaymentBrandMark, { label: label, className: 'solidgate-checkout-tab-wallet' }, label)) }), _jsxs("button", { type: 'button', role: 'tab', id: `${panelId}-card-tab`, "aria-selected": selectedMethod === 'card', "aria-controls": `${panelId}-card`, className: 'solidgate-checkout-method', onClick: () => setSelectedMethod('card'), children: [_jsx("strong", { children: cardLabel }), _jsx("span", { className: 'solidgate-checkout-tab-brands', "aria-hidden": 'true', children: ['Visa', 'Mastercard', 'Maestro', 'Discover'].map((label) => (_jsx(PaymentBrandMark, { label: label, className: 'solidgate-checkout-tab-brand' }, label))) })] })] })) : null, !walletOnly && secureLabel && wallets.length > 0 && showWallet ? (_jsxs("p", { className: 'solidgate-checkout-secure', children: [_jsx(SecurityLockIcon, {}), secureLabel] })) : null, _jsxs("div", { className: 'solidgate-checkout-wallets', id: `${panelId}-wallet`, role: showTabs ? 'tabpanel' : undefined, "aria-labelledby": showTabs ? `${panelId}-wallet-tab` : undefined, hidden: !showWallet, children: [_jsx("div", { ref: applePayContainerRef, "data-solidgate-wallet": 'apple-pay' }), _jsx("div", { ref: googlePayContainerRef, "data-solidgate-wallet": 'google-pay' })] }), _jsx("div", { className: 'solidgate-checkout-card', id: `${panelId}-card`, role: showTabs ? 'tabpanel' : undefined, "aria-labelledby": showTabs ? `${panelId}-card-tab` : undefined, hidden: !showCard, children: _jsx(SolidgateSdkPayment, { onInitializationError: onError, merchantData: checkout.initialization.merchantData, width: '100%', formParams: Object.assign({ autoFocus: false, enabled: !walletOnly, isSolidLogoVisible: false, submitButtonText: cardSubmitLabel }, (secureLabel ? { cardNumberLabel: 'Card number', cardExpiryDateLabel: 'Expiration date', cardCvvLabel: 'Security code' } : {})), styles: {
                         form_body: {
                             'font-family': 'Inter, Arial, sans-serif',
                         },

package/dist/providers/solidgate/components/SolidgateSdkPayment.js

@@ -23,7 +23,7 @@ export function SolidgateSdkPayment(props) {
             google.id = `${id}-google`;
         void import('@solidgate/react-sdk').then(async (sdk) => {
             var _a, _b;
-            const loaded = await sdk.SdkLoader.load();
+            const loaded = await sdk.SdkLoader.load('https://cdn.charge-auth.com/js/form.js');
             if (!active || !loaded)
                 return;
             client = loaded;

package/dist/providers/solidgate/services/solidgate.service.d.ts

@@ -1,5 +1,9 @@
 import { type FunnelSdkRuntimeConfigOverrides } from '@funnelsgrove/runtime';
 export type SolidgateCheckoutStatus = 'preparing' | 'requires_payment' | 'verifying' | 'succeeded' | 'failed' | 'expired';
+export declare class SolidgateExistingSubscriptionError extends Error {
+    readonly code: "already_subscribed_to_product";
+    constructor();
+}
 export type SolidgateCheckoutPreparation = {
     attemptId: string;
     display: {
@@ -31,6 +35,7 @@ export type PrepareSolidgateCheckoutInput = {
     checkoutType?: 'subscription' | 'one_time' | null;
     environment?: 'test' | 'live' | null;
     idempotencyKey: string;
+    retryAttemptId?: string | null;
     discountKeyOrProviderId?: string | null;
     returnUrl: string;
     successUrl: string;
@@ -49,6 +54,7 @@ export type SolidgateCheckoutStatusResponse = {
     attemptId: string;
     status: SolidgateCheckoutStatus;
     retryAfterMs: number | null;
+    failureCode?: string;
 };
 export type PollSolidgateCheckoutStatusResult = SolidgateCheckoutStatusResponse & {
     timedOut: boolean;

package/dist/providers/solidgate/services/solidgate.service.js

@@ -1,4 +1,11 @@
 import { paywallCheckoutReturnUrl, retainPaywallCheckout, FUNNEL_ID, FUNNEL_SDK_PUBLISHABLE_KEY, buildMainApiUrl, resolvePreviewPaymentPublishableKey, } from '@funnelsgrove/runtime';
+export class SolidgateExistingSubscriptionError extends Error {
+    constructor() {
+        super('You already have an active subscription to this product.');
+        this.code = 'already_subscribed_to_product';
+        this.name = 'SolidgateExistingSubscriptionError';
+    }
+}
 const trimTrailingSlash = (value) => value.replace(/\/+$/, '');
 const requiredString = (value, name) => {
     const normalized = typeof value === 'string' ? value.trim() : '';
@@ -28,6 +35,13 @@ const postJson = async (path, body, runtimeConfig, signal) => {
         signal,
     });
     if (!response.ok) {
+        if (response.status === 409) {
+            const payload = await response.json().catch(() => null);
+            if (payload && typeof payload === 'object' && 'code' in payload
+                && payload.code === 'already_subscribed_to_product') {
+                throw new SolidgateExistingSubscriptionError();
+            }
+        }
         throw new Error('Solidgate checkout is temporarily unavailable');
     }
     return response.json();
@@ -103,11 +117,8 @@ const parseStatus = (value) => {
         && (typeof retryAfterMs !== 'number' || !Number.isFinite(retryAfterMs) || retryAfterMs < 0)) {
         throw new Error('Solidgate checkout status returned an invalid retry delay');
     }
-    return {
-        attemptId: requiredString(value.attemptId, 'attemptId'),
-        status: value.status,
-        retryAfterMs,
-    };
+    return Object.assign({ attemptId: requiredString(value.attemptId, 'attemptId'), status: value.status, retryAfterMs }, (value.status === 'failed' && typeof value.failureCode === 'string'
+        && /^\d\.\d{2}$/.test(value.failureCode) ? { failureCode: value.failureCode } : {}));
 };
 export const prepareSolidgateCheckout = async (input) => {
     var _a, _b, _c;
@@ -118,23 +129,8 @@ export const prepareSolidgateCheckout = async (input) => {
     if (!paymentProfileId || !providerPlanId || !checkoutType || !environment) {
         throw new Error('Solidgate V2 checkout selection is incomplete');
     }
-    const result = parsePreparation(await postJson('/sdk/public/v2/payments/checkout-sessions', {
-        checkoutType,
-        uiMode: 'custom',
-        environment,
-        paymentProfileId,
-        provider: 'solidgate',
-        providerPlanId,
-        planKey: requiredString(input.funnelPlanKey, 'funnelPlanKey'),
-        funnelId: resolveFunnelId(input.funnelId, input.runtimeConfig),
-        funnelEndUserId: requiredString(input.funnelEndUserId, 'funnelEndUserId'),
-        offerSetId: requiredString(input.offerSetId, 'offerSetId'),
-        idempotencyKey: requiredString(input.idempotencyKey, 'idempotencyKey'),
-        couponId: ((_c = input.discountKeyOrProviderId) === null || _c === void 0 ? void 0 : _c.trim()) || null,
-        returnUrl: paywallCheckoutReturnUrl(requiredString(input.returnUrl, 'returnUrl'), 'solidgate'),
-        successUrl: paywallCheckoutReturnUrl(requiredString(input.successUrl, 'successUrl'), 'solidgate'),
-        failUrl: paywallCheckoutReturnUrl(requiredString(input.failUrl, 'failUrl'), 'solidgate', true),
-    }, input.runtimeConfig, input.signal));
+    const result = parsePreparation(await postJson('/sdk/public/v2/payments/checkout-sessions', Object.assign(Object.assign({ checkoutType, uiMode: 'custom', environment,
+        paymentProfileId, provider: 'solidgate', providerPlanId, planKey: requiredString(input.funnelPlanKey, 'funnelPlanKey'), funnelId: resolveFunnelId(input.funnelId, input.runtimeConfig), funnelEndUserId: requiredString(input.funnelEndUserId, 'funnelEndUserId'), offerSetId: requiredString(input.offerSetId, 'offerSetId'), idempotencyKey: requiredString(input.idempotencyKey, 'idempotencyKey') }, (input.retryAttemptId ? { retryAttemptId: input.retryAttemptId } : {})), { couponId: ((_c = input.discountKeyOrProviderId) === null || _c === void 0 ? void 0 : _c.trim()) || null, returnUrl: paywallCheckoutReturnUrl(requiredString(input.returnUrl, 'returnUrl'), 'solidgate'), successUrl: paywallCheckoutReturnUrl(requiredString(input.successUrl, 'successUrl'), 'solidgate'), failUrl: paywallCheckoutReturnUrl(requiredString(input.failUrl, 'failUrl'), 'solidgate', true) }), input.runtimeConfig, input.signal));
     retainPaywallCheckout('solidgate', result.attemptId);
     return result;
 };

package/dist/providers/solidgate/services/solidgateDeclineMessage.d.ts

@@ -0,0 +1 @@
+export declare const solidgateDeclineMessage: (code?: string) => string;

package/dist/providers/solidgate/services/solidgateDeclineMessage.js

@@ -0,0 +1,24 @@
+// Customer-safe descriptions; never render raw processor messages or risk decisions.
+// https://docs.solidgate.com/payments/payments-insights/error-codes/
+const messages = {
+    '0.02': 'The payment session expired. Start a new checkout to continue.',
+    '2.04': 'This card type is not supported. Use another payment method.',
+    '2.06': 'The security code is incorrect. Check the code on your card and try again.',
+    '2.08': 'The card number is invalid. Check the number and try again.',
+    '2.09': 'The card expiration date is invalid. Check the date or use another card.',
+    '2.14': 'We could not start this subscription. Check whether you already have access, or contact support.',
+    '2.15': 'Your bank requires additional verification. Try again and complete the bank verification step.',
+    '3.01': 'Your bank has blocked this card. Contact your bank or use another payment method.',
+    '3.02': 'Your card has insufficient funds. Add funds or use another payment method.',
+    '3.03': 'This payment exceeds your card limit. Check your limit with your bank or use another card.',
+    '3.04': 'Your bank declined this payment. Contact your bank or use another payment method.',
+    '3.05': 'Contact your bank to authorize this payment, or use another payment method.',
+    '3.06': 'Debit cards cannot be used for this payment. Use a credit card or another payment method.',
+    '3.07': 'This card type is not supported. Use another payment method.',
+    '3.09': 'Your bank requires additional verification. Try again and complete the bank verification step.',
+    '3.11': 'Recurring payments are not authorized for this card. Use another payment method.',
+    '3.13': 'The payment was cancelled. Try again and keep the payment window open until it finishes.',
+    '4.08': 'The billing address does not match your card. Check the address with your bank and try again.',
+};
+export const solidgateDeclineMessage = (code) => ((code && Object.hasOwn(messages, code) ? messages[code] : undefined)
+    || 'Your payment was declined. Use another payment method or contact your bank.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -46,11 +46,11 @@
     "jsdom": "20.0.3",
     "typescript": "^5",
     "vitest": "^3.2.4",
-    "@funnelsgrove/runtime": "0.25.0",
-    "@funnelsgrove/analytics": "0.7.0"
+    "@funnelsgrove/runtime": "0.26.0",
+    "@funnelsgrove/analytics": "0.8.0"
   },
   "peerDependencies": {
-    "@funnelsgrove/runtime": "^0.25.0",
-    "@funnelsgrove/analytics": "^0.7.0"
+    "@funnelsgrove/runtime": "^0.26.0",
+    "@funnelsgrove/analytics": "^0.8.0"
   }
 }