@vtex/faststore 0.0.6 → 0.0.8

package/dist/matter/card-entry/card-capture.js

@@ -11,12 +11,13 @@ function useCardCapture() {
 	return ctx;
 }
 /** Registers on mount and on any argument change, so the provider always holds the latest closure. */
-function useRegisterCardCapture(capture, preflight) {
+function useRegisterCardCapture(capture, preflight, explainMissingMethod) {
 	const { registerCapture } = useCardCapture();
-	useEffect(() => registerCapture(capture, preflight), [
+	useEffect(() => registerCapture(capture, preflight, explainMissingMethod), [
 		registerCapture,
 		capture,
-		preflight
+		preflight,
+		explainMissingMethod
 	]);
 }
 //#endregion

package/dist/matter/card-entry/card-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"card-capture.js","names":[],"sources":["../../../src/matter/card-entry/card-capture.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useEffect } from 'react';\nimport type { PaymentSubmissionPath } from '../../sdk/payment/submission-registry.js';\n\n/**\n * The `card-capture` context (specs/sfs-3457-card-entry-card-capture-context.md): everything\n * `CardEntry` needs from whichever surface composes it. The fields own the card values; the provider\n * owns the accepted networks, when a capture runs, and where the card goes. This is the PCI context:\n * `CardEntry` is its only consumer.\n */\n\nexport type CardCaptureValidator = Readonly<{\n  numberMask: string | null;\n  numberRegex: string | null;\n  cvvMask: string | null;\n  cvvRegex: string | null;\n  cvvRequired: boolean;\n  expirationRequired: boolean;\n  holderNameRequired: boolean;\n}>;\n\n/** One accepted network and its validation rules. `PaymentSectionMethod` is assignable to it. */\nexport type CardCaptureNetwork = Readonly<{\n  id: string;\n  name: string;\n  validator: CardCaptureValidator;\n}>;\n\n/** The card as the fields hold it. Exists only as the argument of one `send` call. */\nexport type CapturedCard = Readonly<{\n  number: string;\n  securityCode: string;\n  expirationDate: string;\n  holderName: string;\n}>;\n\nexport type CardCaptureError = Readonly<{ code: string; message: string }>;\n\nexport type CardCaptureTarget = (card: CapturedCard) => Promise<readonly CardCaptureError[]>;\n\n/** Registered by `CardEntry`; the provider calls it with the target for this one submission. */\nexport type CardCapture = (send: CardCaptureTarget) => Promise<readonly CardCaptureError[]>;\n\n/** Synchronous, I/O-free verdict on the draft, with the same contract as `PaymentPreflightCheck`. */\nexport type CardCapturePreflight = () => readonly CardCaptureError[];\n\n/** The checkout facts `CardEntry` reacts to. Absent outside the checkout. */\nexport type CardCaptureSelection = Readonly<{\n  selectMethod: (input: { methodId: string; bin: string }) => void;\n  selectNewCard: () => void;\n  setDraftBin: (bin: string | null) => void;\n  path: PaymentSubmissionPath | null;\n  bin: string | null;\n  collapsed: boolean;\n  cardModeActive: boolean;\n  selectedMethodId: string | null;\n  selectionOutOfScope: boolean;\n  selectionNonCard: boolean;\n}>;\n\nexport type CardCaptureContextValue = Readonly<{\n  networks: readonly CardCaptureNetwork[];\n  busy: boolean;\n  /** When `CardEntry` clears its fields after the target settles. A pre-flight refusal never clears. */\n  clearOn: 'success' | 'any-outcome';\n  /** Registers the capture and its pre-flight check. Returns the unregister function. */\n  registerCapture: (capture: CardCapture, preflight: CardCapturePreflight) => () => void;\n  /** Called with the resolved network's id, or `null`, whenever that resolution changes. */\n  onNetworkChange?: (networkId: string | null) => void;\n  selection?: CardCaptureSelection;\n}>;\n\nconst CARD_CAPTURE_CONTEXT_UNSET = Symbol('CardCaptureContextUnset');\n\nconst CardCaptureContextInternal = createContext<CardCaptureContextValue | typeof CARD_CAPTURE_CONTEXT_UNSET>(\n  CARD_CAPTURE_CONTEXT_UNSET,\n);\n\nexport const CardCaptureContext = CardCaptureContextInternal as React.Context<CardCaptureContextValue>;\n\n/** Throws outside a provider, mirroring `usePayment()`: a misplaced `CardEntry` is a composition bug. */\nexport function useCardCapture(): CardCaptureContextValue {\n  const ctx = useContext(CardCaptureContextInternal);\n  if (ctx === CARD_CAPTURE_CONTEXT_UNSET) {\n    throw new Error(\n      'useCardCapture() must be used inside a card-capture provider (PaymentSectionRoot, PaymentSectionController).',\n    );\n  }\n  return ctx;\n}\n\n/** Registers on mount and on any argument change, so the provider always holds the latest closure. */\nexport function useRegisterCardCapture(capture: CardCapture, preflight: CardCapturePreflight): void {\n  const { registerCapture } = useCardCapture();\n\n  useEffect(() => registerCapture(capture, preflight), [registerCapture, capture, preflight]);\n}\n"],"mappings":";;;AAyEA,MAAM,6BAA6B,OAAO,yBAAyB;AAEnE,MAAM,6BAA6B,cACjC,0BACF;AAEA,MAAa,qBAAqB;;AAGlC,SAAgB,iBAA0C;CACxD,MAAM,MAAM,WAAW,0BAA0B;CACjD,IAAI,QAAQ,4BACV,MAAM,IAAI,MACR,8GACF;CAEF,OAAO;AACT;;AAGA,SAAgB,uBAAuB,SAAsB,WAAuC;CAClG,MAAM,EAAE,oBAAoB,eAAe;CAE3C,gBAAgB,gBAAgB,SAAS,SAAS,GAAG;EAAC;EAAiB;EAAS;CAAS,CAAC;AAC5F"}
+{"version":3,"file":"card-capture.js","names":[],"sources":["../../../src/matter/card-entry/card-capture.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useEffect } from 'react';\nimport type { PaymentSubmissionPath } from '../../sdk/payment/submission-registry.js';\n\n/**\n * The `card-capture` context (specs/sfs-3457-card-entry-card-capture-context.md): everything\n * `CardEntry` needs from whichever surface composes it. The fields own the card values; the provider\n * owns the accepted networks, when a capture runs, and where the card goes. This is the PCI context:\n * `CardEntry` is its only consumer.\n */\n\nexport type CardCaptureValidator = Readonly<{\n  numberMask: string | null;\n  numberRegex: string | null;\n  cvvMask: string | null;\n  cvvRegex: string | null;\n  cvvRequired: boolean;\n  expirationRequired: boolean;\n  holderNameRequired: boolean;\n}>;\n\n/** One accepted network and its validation rules. `PaymentSectionMethod` is assignable to it. */\nexport type CardCaptureNetwork = Readonly<{\n  id: string;\n  name: string;\n  validator: CardCaptureValidator;\n}>;\n\n/** The card as the fields hold it. Exists only as the argument of one `send` call. */\nexport type CapturedCard = Readonly<{\n  number: string;\n  securityCode: string;\n  expirationDate: string;\n  holderName: string;\n}>;\n\nexport type CardCaptureError = Readonly<{ code: string; message: string }>;\n\n/**\n * What a capture and its target resolve (T112). `reachedGateway` is `false` only when no request was\n * issued — `CardEntry`'s own refusals set it, and a target passes through whatever its transport reports.\n * Kept local rather than imported from the SDK: `CardEntry` is surface-agnostic, and the account will\n * tokenize through the same context.\n */\nexport type CardCaptureResult = Readonly<{ reachedGateway: boolean; userErrors: readonly CardCaptureError[] }>;\n\nexport type CardCaptureTarget = (card: CapturedCard) => Promise<CardCaptureResult>;\n\n/** Registered by `CardEntry`; the provider calls it with the target for this one submission. */\nexport type CardCapture = (send: CardCaptureTarget) => Promise<CardCaptureResult>;\n\n/** Synchronous, I/O-free verdict on the draft, with the same contract as `PaymentPreflightCheck`. */\nexport type CardCapturePreflight = () => readonly CardCaptureError[];\n\n/**\n * Synchronous, side-effect-free explanation of why no payment method is selected (T47), with the same\n * contract as `PaymentMissingMethodExplainer`: returns the refusal that names the card as the reason, or\n * `null`. Fixed copy and a fixed code only; it never echoes anything the shopper typed.\n */\nexport type CardCaptureMissingMethodExplainer = () => CardCaptureError | null;\n\n/** The checkout facts `CardEntry` reacts to. Absent outside the checkout. */\nexport type CardCaptureSelection = Readonly<{\n  selectMethod: (input: { methodId: string; bin: string }) => void;\n  selectNewCard: () => void;\n  setDraftBin: (bin: string | null) => void;\n  path: PaymentSubmissionPath | null;\n  bin: string | null;\n  collapsed: boolean;\n  cardModeActive: boolean;\n  selectedMethodId: string | null;\n  selectionOutOfScope: boolean;\n  selectionNonCard: boolean;\n}>;\n\nexport type CardCaptureContextValue = Readonly<{\n  networks: readonly CardCaptureNetwork[];\n  busy: boolean;\n  /** When `CardEntry` clears its fields after the target settles. A pre-flight refusal never clears. */\n  clearOn: 'success' | 'any-outcome';\n  /** Registers the capture, its pre-flight check and, optionally, its missing-method explainer. Returns the unregister function. */\n  registerCapture: (\n    capture: CardCapture,\n    preflight: CardCapturePreflight,\n    explainMissingMethod?: CardCaptureMissingMethodExplainer,\n  ) => () => void;\n  /** Called with the resolved network's id, or `null`, whenever that resolution changes. */\n  onNetworkChange?: (networkId: string | null) => void;\n  selection?: CardCaptureSelection;\n}>;\n\nconst CARD_CAPTURE_CONTEXT_UNSET = Symbol('CardCaptureContextUnset');\n\nconst CardCaptureContextInternal = createContext<CardCaptureContextValue | typeof CARD_CAPTURE_CONTEXT_UNSET>(\n  CARD_CAPTURE_CONTEXT_UNSET,\n);\n\nexport const CardCaptureContext = CardCaptureContextInternal as React.Context<CardCaptureContextValue>;\n\n/** Throws outside a provider, mirroring `usePayment()`: a misplaced `CardEntry` is a composition bug. */\nexport function useCardCapture(): CardCaptureContextValue {\n  const ctx = useContext(CardCaptureContextInternal);\n  if (ctx === CARD_CAPTURE_CONTEXT_UNSET) {\n    throw new Error(\n      'useCardCapture() must be used inside a card-capture provider (PaymentSectionRoot, PaymentSectionController).',\n    );\n  }\n  return ctx;\n}\n\n/** Registers on mount and on any argument change, so the provider always holds the latest closure. */\nexport function useRegisterCardCapture(\n  capture: CardCapture,\n  preflight: CardCapturePreflight,\n  explainMissingMethod?: CardCaptureMissingMethodExplainer,\n): void {\n  const { registerCapture } = useCardCapture();\n\n  useEffect(\n    () => registerCapture(capture, preflight, explainMissingMethod),\n    [registerCapture, capture, preflight, explainMissingMethod],\n  );\n}\n"],"mappings":";;;AA4FA,MAAM,6BAA6B,OAAO,yBAAyB;AAEnE,MAAM,6BAA6B,cACjC,0BACF;AAEA,MAAa,qBAAqB;;AAGlC,SAAgB,iBAA0C;CACxD,MAAM,MAAM,WAAW,0BAA0B;CACjD,IAAI,QAAQ,4BACV,MAAM,IAAI,MACR,8GACF;CAEF,OAAO;AACT;;AAGA,SAAgB,uBACd,SACA,WACA,sBACM;CACN,MAAM,EAAE,oBAAoB,eAAe;CAE3C,gBACQ,gBAAgB,SAAS,WAAW,oBAAoB,GAC9D;EAAC;EAAiB;EAAS;EAAW;CAAoB,CAC5D;AACF"}

package/dist/matter/card-entry/card-entry.d.ts

@@ -44,9 +44,11 @@ export type CardEntryProps = {
   cvvDescription?: string;
   /** Shown on the number field when it is left blank. */
   numberRequiredMessage?: string;
-  /** Shown on the number field for a Luhn-invalid PAN, or a Luhn-valid one that matches no
-   *  configured method (FR-3 — the same string covers both sites). */
+  /** Shown on the number field for a Luhn-invalid PAN, or a Luhn-valid one that a configured
+   *  network claims only as a prefix (the wrong length, or two networks at once). */
   numberInvalidMessage?: string;
+  /** Shown on the number field for a Luhn-valid PAN that no configured network claims at all. */
+  networkNotAcceptedMessage?: string;
   /** Shown on the holder-name field when it is left blank and the detected method requires it. */
   holderNameRequiredMessage?: string;
   /** Shown on the expiration field when it is left blank and the detected method requires it. */
@@ -115,6 +117,6 @@ export declare const CARD_ENTRY_INVALID_DATA_CODE = "INVALID_CARD_DATA";
  */
 export declare const CARD_ENTRY_COLLAPSED_CODE = "CARD_ENTRY_COLLAPSED";
 export declare const CardEntryDefinition: ComponentDefinition<CardEntryProps>;
-export declare function CardEntry({ legend, numberLabel, numberPlaceholder, holderNameLabel, holderNamePlaceholder, expirationLabel, expirationPlaceholder, cvvLabel, cvvPlaceholder, cvvDescription, numberRequiredMessage, numberInvalidMessage, holderNameRequiredMessage, expirationRequiredMessage, expirationInvalidMessage, expirationExpiredMessage, cvvRequiredMessage, cvvInvalidMessage, disabled, className }: CardEntryProps): import("react/jsx-runtime").JSX.Element;
+export declare function CardEntry({ legend, numberLabel, numberPlaceholder, holderNameLabel, holderNamePlaceholder, expirationLabel, expirationPlaceholder, cvvLabel, cvvPlaceholder, cvvDescription, numberRequiredMessage, numberInvalidMessage, networkNotAcceptedMessage, holderNameRequiredMessage, expirationRequiredMessage, expirationInvalidMessage, expirationExpiredMessage, cvvRequiredMessage, cvvInvalidMessage, disabled, className }: Readonly<CardEntryProps>): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //# sourceMappingURL=card-entry.d.ts.map

package/dist/matter/card-entry/card-entry.js

@@ -8,6 +8,7 @@ import { useCardCapture, useRegisterCardCapture } from "./card-capture.js";
 import { applyMask } from "../../particles/shared/input-mask.js";
 import "../../particles/document-field/document-field.js";
 import { SECURITY_CODE_MASK_STYLE, isSecurityCodeComplete } from "../../sdk/payment/security-code-mask.js";
+import { ownValue } from "../../utils/own-value.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/matter/card-entry/card-entry.tsx
@@ -211,11 +212,11 @@ const NETWORK_ICON_BY_KEY = {
 	americanexpress: "amex",
 	diners: "diners",
 	dinersclub: "diners",
-	elo: "elo-card"
+	elo: "elo-card",
+	discover: "discover"
 };
 function networkIconName(name) {
-	const key = name.toLowerCase().replace(/[^a-z]/g, "");
-	return NETWORK_ICON_BY_KEY[key] ?? null;
+	return ownValue(NETWORK_ICON_BY_KEY, name.toLowerCase().replaceAll(/[^a-z]/g, "")) ?? null;
 }
 /**
 * Standard Luhn checksum. Rejects non-digit strings and anything shorter than 12 digits — no real
@@ -301,24 +302,45 @@ function isValidCvv(value, validator) {
 function isCardShapedMethod(method) {
 	return Boolean(method.validator.numberRegex);
 }
-function validateDraft(draft, validator, methods, messages) {
-	const errors = {};
+/**
+* Whether a typed number is a well-formed card that no configured network accepts (T47, Decision 1): it is
+* Luhn-valid, detection could have run (at least one method carries a `numberRegex`, the N2 rule), no
+* network's exact pattern matches the digits, and no network claims them even as a BIN-level prefix. A prefix
+* a network claims at the wrong length, or one two networks claim, is a malformed number rather than an
+* unaccepted one and stays `false`. Pure: reads nothing but its arguments, and returns a boolean.
+*/
+function matchesNoConfiguredNetwork(methods, digits) {
+	return isValidLuhn(digits) && methods.some(isCardShapedMethod) && exactMatch(methods, digits) === null && relaxedCandidates(methods, digits).length === 0;
+}
+function validateNumber(draft, validator, methods, messages) {
 	const digits = toDigits(draft.number);
 	const networkDetectionPossible = methods.some(isCardShapedMethod);
-	if (!digits) errors.number = messages.numberRequired;
-	else if (!isValidLuhn(digits)) errors.number = messages.numberInvalid;
-	else if (networkDetectionPossible && !(validator.numberRegex && safeTest(validator.numberRegex, digits))) errors.number = messages.numberInvalid;
-	if (validator.holderNameRequired && !draft.holderName.trim()) errors.holderName = messages.holderNameRequired;
-	if (validator.expirationRequired) {
-		if (!draft.expiration.trim()) errors.expiration = messages.expirationRequired;
-		else if (!isExpirationFormatValid(draft.expiration)) errors.expiration = messages.expirationInvalid;
-		else if (!isExpirationInFuture(draft.expiration)) errors.expiration = messages.expirationExpired;
-	}
-	if (validator.cvvRequired) {
-		if (!draft.cvv.trim()) errors.cvv = messages.cvvRequired;
-		else if (!isValidCvv(draft.cvv, validator)) errors.cvv = messages.cvvInvalid;
-	}
-	return errors;
+	if (!digits) return { number: messages.numberRequired };
+	if (!isValidLuhn(digits)) return { number: messages.numberInvalid };
+	if (networkDetectionPossible && !(validator.numberRegex && safeTest(validator.numberRegex, digits))) return { number: matchesNoConfiguredNetwork(methods, digits) ? messages.networkNotAccepted : messages.numberInvalid };
+	return {};
+}
+function validateExpiration(draft, validator, messages) {
+	if (!validator.expirationRequired) return {};
+	if (!draft.expiration.trim()) return { expiration: messages.expirationRequired };
+	if (!isExpirationFormatValid(draft.expiration)) return { expiration: messages.expirationInvalid };
+	if (!isExpirationInFuture(draft.expiration)) return { expiration: messages.expirationExpired };
+	return {};
+}
+function validateCvv(draft, validator, messages) {
+	if (!validator.cvvRequired) return {};
+	if (!draft.cvv.trim()) return { cvv: messages.cvvRequired };
+	if (!isValidCvv(draft.cvv, validator)) return { cvv: messages.cvvInvalid };
+	return {};
+}
+function validateDraft(draft, validator, methods, messages) {
+	const holderNameError = validator.holderNameRequired && !draft.holderName.trim() ? { holderName: messages.holderNameRequired } : {};
+	return {
+		...validateNumber(draft, validator, methods, messages),
+		...holderNameError,
+		...validateExpiration(draft, validator, messages),
+		...validateCvv(draft, validator, messages)
+	};
 }
 const CARD_ENTRY_INVALID_DATA_CODE = "INVALID_CARD_DATA";
 const INVALID_CARD_DATA_ERROR = {
@@ -338,11 +360,24 @@ const CARD_ENTRY_COLLAPSED_ERROR = {
 	code: CARD_ENTRY_COLLAPSED_CODE,
 	message: "This card is not available for the currently selected payment method."
 };
+/**
+* The refusal for a well-formed card number no configured network accepts (T47, Decision 2). Minted here,
+* not in `use-place-order.ts`, because `CARD_FIELD_PATTERN` forbids the word "card" anywhere in that file:
+* the hook only passes along whatever refusal a registered explainer names. Fixed copy and a fixed code —
+* nothing derived from the typed number (digits, BIN, last four, length, a guessed network) may ever be
+* added to the message or to a log line.
+*/
+const CARD_ENTRY_UNSUPPORTED_NETWORK_CODE = "UNSUPPORTED_CARD_NETWORK";
+const UNSUPPORTED_NETWORK_ERROR = {
+	code: CARD_ENTRY_UNSUPPORTED_NETWORK_CODE,
+	message: "This card is not from a network the store accepts. Use another card or choose another payment method."
+};
 const CardEntryDefinition = defineComponent({
 	name: "CardEntry",
 	importPath: "@vtex/faststore/components",
 	component: CardEntry,
 	requiresContext: "card-capture",
+	hardened: true,
 	editor: {
 		label: "Card Entry",
 		category: "commerce"
@@ -405,6 +440,11 @@ const CardEntryDefinition = defineComponent({
 			default: "Enter a valid card number",
 			label: "Number invalid message"
 		},
+		networkNotAcceptedMessage: {
+			type: "string",
+			default: "This card is not from a network the store accepts",
+			label: "Network not accepted message"
+		},
 		holderNameRequiredMessage: {
 			type: "string",
 			default: "Cardholder name is required",
@@ -443,7 +483,7 @@ const CardEntryDefinition = defineComponent({
 	},
 	guideline: "New-card entry: masked number with live network detection, holder name, expiration, and CVV, each shown and required per the detected network's validator config from the 'card-capture' context. Must be placed inside a card-capture provider: PaymentSectionRoot or PaymentSectionController at checkout. Owns the card values itself — it builds the card and hands it only to the submission target its provider supplies; no other component ever needs the card number or CVV. Card number and CVV are never schema props, fragment fields, or action payloads — do not add one. See card-entry.md."
 });
-function CardEntry({ legend = "Card details", numberLabel = "Card number", numberPlaceholder, holderNameLabel = "Cardholder name", holderNamePlaceholder, expirationLabel = "Expiration date", expirationPlaceholder = "MM/YY", cvvLabel = "Security code", cvvPlaceholder, cvvDescription = "The 3-4 digit number on your card", numberRequiredMessage = "Card number is required", numberInvalidMessage = "Enter a valid card number", holderNameRequiredMessage = "Cardholder name is required", expirationRequiredMessage = "Expiration date is required", expirationInvalidMessage = "Enter a valid expiration date", expirationExpiredMessage = "This card has expired", cvvRequiredMessage = "Security code is required", cvvInvalidMessage = "Enter a valid security code", disabled = false, className }) {
+function CardEntry({ legend = "Card details", numberLabel = "Card number", numberPlaceholder, holderNameLabel = "Cardholder name", holderNamePlaceholder, expirationLabel = "Expiration date", expirationPlaceholder = "MM/YY", cvvLabel = "Security code", cvvPlaceholder, cvvDescription = "The 3-4 digit number on your card", numberRequiredMessage = "Card number is required", numberInvalidMessage = "Enter a valid card number", networkNotAcceptedMessage = "This card is not from a network the store accepts", holderNameRequiredMessage = "Cardholder name is required", expirationRequiredMessage = "Expiration date is required", expirationInvalidMessage = "Enter a valid expiration date", expirationExpiredMessage = "This card has expired", cvvRequiredMessage = "Security code is required", cvvInvalidMessage = "Enter a valid security code", disabled = false, className }) {
 	const { networks: methods, busy: placing, clearOn, onNetworkChange, selection } = useCardCapture();
 	const draftPath = selection?.path ?? null;
 	const draftBin = selection?.bin ?? null;
@@ -456,6 +496,7 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 	const validationMessages = useMemo(() => ({
 		numberRequired: numberRequiredMessage,
 		numberInvalid: numberInvalidMessage,
+		networkNotAccepted: networkNotAcceptedMessage,
 		holderNameRequired: holderNameRequiredMessage,
 		expirationRequired: expirationRequiredMessage,
 		expirationInvalid: expirationInvalidMessage,
@@ -465,6 +506,7 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 	}), [
 		numberRequiredMessage,
 		numberInvalidMessage,
+		networkNotAcceptedMessage,
 		holderNameRequiredMessage,
 		expirationRequiredMessage,
 		expirationInvalidMessage,
@@ -640,7 +682,7 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 		setFieldErrors(errors);
 		const firstInvalid = VALIDATION_ORDER.find((key) => errors[key]);
 		if (firstInvalid) focusField(firstInvalid);
-		return [INVALID_CARD_DATA_ERROR];
+		return [matchesNoConfiguredNetwork(methods, digits) ? UNSUPPORTED_NETWORK_ERROR : INVALID_CARD_DATA_ERROR];
 	}, [
 		collapsed,
 		number,
@@ -649,6 +691,7 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 		cvv,
 		validator,
 		methods,
+		digits,
 		focusField,
 		validationMessages,
 		selectionOutOfScope,
@@ -657,7 +700,10 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 	]);
 	const capture = useCallback(async (send) => {
 		const refusals = checkDraft();
-		if (refusals.length > 0) return refusals;
+		if (refusals.length > 0) return {
+			reachedGateway: false,
+			userErrors: refusals
+		};
 		const card = {
 			number,
 			securityCode: cvv,
@@ -666,9 +712,9 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 		};
 		let succeeded = false;
 		try {
-			const userErrors = await send(card);
-			succeeded = userErrors.length === 0;
-			return userErrors;
+			const result = await send(card);
+			succeeded = result.userErrors.length === 0;
+			return result;
 		} finally {
 			if (succeeded || clearOn === "any-outcome") {
 				setNumber("");
@@ -685,7 +731,12 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 		cvv,
 		clearOn
 	]);
-	useRegisterCardCapture(capture, checkDraft);
+	const explainMissingMethod = useCallback(() => !collapsed && matchesNoConfiguredNetwork(methods, digits) ? UNSUPPORTED_NETWORK_ERROR : null, [
+		collapsed,
+		methods,
+		digits
+	]);
+	useRegisterCardCapture(capture, checkDraft, explainMissingMethod);
 	return /* @__PURE__ */ jsx("div", {
 		hidden: collapsed,
 		"data-fs-card-entry-collapse-boundary": "",
@@ -827,6 +878,6 @@ function CardEntry({ legend = "Card details", numberLabel = "Card number", numbe
 	});
 }
 //#endregion
-export { CARD_ENTRY_COLLAPSED_CODE, CARD_ENTRY_INVALID_DATA_CODE, CardEntry, CardEntryDefinition, NETWORK_ICON_BY_KEY, detectNetworkMethod, isExpirationFormatValid, isExpirationInFuture, isValidLuhn, resolveCompleteBin, resolveNetworkMethod, shouldRedispatchOnReturnToNewCard };
+export { CARD_ENTRY_COLLAPSED_CODE, CARD_ENTRY_INVALID_DATA_CODE, CARD_ENTRY_UNSUPPORTED_NETWORK_CODE, CardEntry, CardEntryDefinition, NETWORK_ICON_BY_KEY, detectNetworkMethod, isExpirationFormatValid, isExpirationInFuture, isValidLuhn, matchesNoConfiguredNetwork, resolveCompleteBin, resolveNetworkMethod, shouldRedispatchOnReturnToNewCard };
 
 //# sourceMappingURL=card-entry.js.map