@amos.com/react-amos-js 0.11.1 → 0.11.3

package/README.md

@@ -16,7 +16,7 @@ npm install @amos.com/react-amos-js @amos.com/node
 
 - React components for the iframe payment method forms: `AmosCreditCardPaymentMethodForm`, `AmosBankAccountPaymentMethodForm`, `AmosGooglePayButton`, `AmosApplePayButton`.
 - React-flavoured iframe message helpers that accept a React `ref`: `validateForm({ iframeRef })`, `confirmPayment({ iframeRef, token })`, `confirmSetup({ iframeRef, token })`, `resetForm({ iframeRef })`.
-- Re-exports of the `@amos.com/amos-js` helpers and types that come up in client code: `createMessage`, `decodeJwt`, `getEmbedOrigin`, `formatGooglePayPaymentData`, `resetForm`, `ConfirmResult`, `ConfirmationResult`, `ConfirmationIncompleteReason`, `FormattedGooglePayPaymentData`, `Appearance`, `Message`, etc.
+- Re-exports of the `@amos.com/amos-js` helpers and types that come up in client code: `createMessage`, `decodeJwt`, `getEmbedOrigin`, `formatGooglePayPaymentData`, `resetForm`, `ConfirmResult`, `FormattedGooglePayPaymentData`, `Appearance`, `Message`, etc.
 
 > **Note:** `@amos.com/react-amos-js` is the client-side half of the Amos integration. For end-to-end payment processing you also need `@amos.com/node` on your server (creating payment intents, handling webhooks, etc.). The same `@amos.com/node` package is listed as a peer dependency so you can import its OpenAPI types in client-side TypeScript code.
 
@@ -43,8 +43,8 @@ The following flow is for credit card and bank account payment method types only
 3. **User clicks "Pay now" button**: call `validateForm({ iframeRef })`, which returns `Promise<true>` if the embedded form is valid and `Promise<false>` otherwise.
 4. **Create payment intent on your server**: use your server-side Amos client to call `POST /payment_intents`. You may also associate this payment intent with a new or existing customer via `POST /customers`. This must be server-side because it uses your private API key.
 5. **Return the payment intent token to the browser**: your backend responds with the embed token (`components["schemas"]["EmbedToken"]`) needed for confirmation.
-6. **Confirm the payment intent from the client**: `await confirmPayment({ iframeRef, token })`. Deprecated alias: `confirmPaymentIntent`.
-7. **Handle UX**: show the user a "processing" state while awaiting `confirmPayment`. Do not treat `{ status: "succeeded" }` as settlement proof — verify payment success on your backend via webhooks. Recoverable field errors stay in the iframe; `confirmPayment` still resolves `{ status: "failed" }`. Legacy hosts can keep optional `onResult`.
+6. **Confirm the payment intent from the client**: `await confirmPayment({ iframeRef, token })`.
+7. **Handle UX**: show the user a "processing" state while awaiting `confirmPayment`. Do not treat `{ status: "succeeded" }` as settlement proof — verify payment success on your backend via webhooks. Recoverable field errors stay in the iframe; `confirmPayment` still resolves `{ status: "failed" }`.
 
 ### Google Pay & Apple Pay
 
@@ -61,10 +61,10 @@ The key differences between the express and non-express payment flows are:
 Setup intents are used to save payment methods for future use (e.g. recurring payments, subscriptions) without charging the customer immediately. The flow is identical to a payment intent, except:
 
 - On the server, call `POST /setup_intents` instead of `POST /payment_intents`.
-- On the client, `await confirmSetup({ iframeRef, token })` instead of `confirmPayment({ iframeRef, token })`. Deprecated alias: `confirmSetupIntent`.
+- On the client, `await confirmSetup({ iframeRef, token })` instead of `confirmPayment({ iframeRef, token })`.
 - Both resolve `{ status: "succeeded" | "failed" }`.
 
-The same `AmosCreditCardPaymentMethodForm` / `AmosBankAccountPaymentMethodForm` components support both payment intents and setup intents — they are differentiated by which confirmation function you call. For bank setup, pass `intent="setup"` so Connect / Plaid is always shown (no merchant ACH threshold lookup).
+The same `AmosCreditCardPaymentMethodForm` / `AmosBankAccountPaymentMethodForm` components support both payment intents and setup intents — they are differentiated by which confirmation function you call. For bank setup, pass `intent="setup"` so Plaid is always shown (unless the render token disables verification).
 
 ## Understanding PCI DSS compliance requirements
 
@@ -82,7 +82,7 @@ In short, your app orchestrates the payment flow, while sensitive payment data s
 
 ## Appearance
 
-Card and bank components accept an optional `appearance` prop that controls the look of the iframe UI, and of the parent-page **Connect bank account** button when ACH verification is required. It contains a `themeVariables` object whose keys are CSS custom-property names and whose values are strings, and an optional `labels` setting for field label placement. You can update this prop after page load to update the iframe appearance. Wallet buttons do not take `appearance`.
+Card and bank components accept an optional `appearance` prop that controls the look of the iframe UI. It contains a `themeVariables` object whose keys are CSS custom-property names and whose values are strings, and an optional `labels` setting for field label placement. You can update this prop after page load to update the iframe appearance. Wallet buttons do not take `appearance`.
 
 ```tsx
 <AmosCreditCardPaymentMethodForm
@@ -151,7 +151,7 @@ Radio groups (e.g. account type) always use an above-style group label regardles
 | `--control-gap`                    | Horizontal gap between side-by-side controls             | `0.5rem`                        |
 | `--error-font-size`                | Font size of field-level error messages                  | `0.875rem`                      |
 | `--radio-size`                     | Size of radio buttons on the bank account form           | `1rem`                          |
-| `--ring`                           | Focus ring and outline color (inputs, Connect button)    | `oklch(0.708 0 0)`              |
+| `--ring`                           | Focus ring and outline color (inputs)                    | `oklch(0.708 0 0)`              |
 | `--ring-width`                     | Focus ring width                                         | `3px`                           |
 | `--radius`                         | Base border-radius (derived into sm/md/lg/xl)            | `0.625rem`                      |
 
@@ -433,7 +433,7 @@ Validates the embedded card/bank iframe form before payment confirmation.
 
 ### `confirmPayment({ iframeRef, token })`
 
-Confirms a payment intent in the embedded iframe flow. Resolves `{ status: "succeeded" }` or `{ status: "failed" }`. Deprecated alias: `confirmPaymentIntent`.
+Confirms a payment intent in the embedded iframe flow. Resolves `{ status: "succeeded" }` or `{ status: "failed" }`.
 
 **Parameters:**
 
@@ -444,7 +444,7 @@ Confirms a payment intent in the embedded iframe flow. Resolves `{ status: "succ
 
 ### `confirmSetup({ iframeRef, token })`
 
-Confirms a setup intent in the embedded iframe flow. Use this when saving a payment method for future use. Deprecated alias: `confirmSetupIntent`.
+Confirms a setup intent in the embedded iframe flow. Use this when saving a payment method for future use.
 
 **Parameters:**
 
@@ -455,7 +455,7 @@ Confirms a setup intent in the embedded iframe flow. Use this when saving a paym
 
 ### `resetForm({ iframeRef })`
 
-Clears all field values and API errors in the embedded card/bank iframe form. Call after a failed or incomplete confirm when the customer wants to try again (for example, after a successful payment when starting a new one).
+Clears all field values and API errors in the embedded card/bank iframe form. Call after a failed confirm when the customer wants to try again (for example, after a successful payment when starting a new one).
 
 **Parameters:**
 
@@ -477,7 +477,6 @@ Renders the secure credit card iframe form. A field-shaped skeleton is shown imm
 
 - `additionalFields` (`{ cardholderName: boolean }`) — set `additionalFields={{ cardholderName: true }}` to render the cardholder name field in the iframe (`false` by default)
 - `billingAddressRequirement` (`"country" | "full"`, defaults to `"country"`) — how much billing address the iframe collects. `country` collects country / region and, for CA / PR / GB / US, a postal code (labeled ZIP for the United States). `full` shows a full street address form with Smarty autocomplete.
-- `onResult` (`(result: ConfirmationResult) => void`) — **deprecated.** Prefer `await confirmPayment()` / `await confirmSetup()`. Still fired for existing hosts (`succeeded`, `failed`, or `incomplete` with `reason`). Not settlement proof; verify via webhooks.
 - `onValidityChange` (`(event: { isValid: boolean }) => void`) — called when form validity changes. `isValid` is true when all required fields are present and valid. Does not include PCI data. Use this to enable or disable your checkout button.
 - `onCardBrandChanged` (`(event: { brand: CardBrand | null }) => void`) — called when the detected card brand changes. `brand` is `"visa"`, `"mastercard"`, `"amex"`, `"discover"`, `"diners"`, or `"jcb"`, or `null` when the field is empty or the number does not match a known brand. Does not include PCI data.
 
@@ -487,25 +486,23 @@ Renders the secure credit card iframe form. A field-shaped skeleton is shown imm
 
 Renders the secure bank account iframe form. A field-shaped skeleton is shown immediately and replaced by the iframe once appearance is applied.
 
-When the charge meets the merchant’s ACH verification threshold, the SDK hides the routing/account iframe and renders a **Connect bank account** button in the parent page. The button follows the same outline/focus defaults as Amos UI (`--ring`, `--border`, `--radius`, `--input-height`, …): it inherits those CSS variables from the host page when present, and `appearance.themeVariables` overrides them the same way as the iframe. Clicking it asks the iframe to mint a Plaid Link token, then opens [Plaid Link](https://plaid.com/docs/link/web/). Hosts do not proxy Pay API (`GET /merchants`, `POST /plaid_link_tokens`); embed does that with `PAY_API_KEY`. Do not put Plaid secrets in the browser.
+When `requireAchVerification` is true (or `intent` is `"setup"`), and the render token allows verification, the SDK hides the routing/account iframe and mounts [Plaid Embedded Institution Search](https://plaid.com/docs/link/embedded-institution-search/) in the parent. Hosts do not proxy Pay API (`GET /merchants`, `POST /plaid_link_tokens`); embed does that with `PAY_API_KEY`. Do not put Plaid secrets in the browser.
 
-**Required props:** same as `AmosCreditCardPaymentMethodForm` — `renderToken` — plus:
+**Required props:** same as `AmosCreditCardPaymentMethodForm` — `renderToken`.
 
-- `amount` (`string`, major-currency decimal, e.g. `"50.00"`, defaults to `"0"`) — same format as Google Pay / Apple Pay. Compared to the threshold the iframe fetches (cents). Pass `"0"` (the default) on open-amount forms until the customer enters a charge — 0 is typically under the threshold, so Connect stays hidden. Pass a new `amount` when the customer changes the charge.
-- `intent` (`"payment" | "setup"`, defaults to `"payment"`) — `"setup"` always shows Connect / Plaid (no merchant ACH threshold lookup), unless the render token disables verification. Use this when saving a bank account for later charges.
+**Optional props:** same as `AmosCreditCardPaymentMethodForm` — `appearance`, `billingAddressRequirement`, `onValidityChange` (`isValid` is also true after Plaid returns credentials) — plus:
 
-**Optional props:** same as `AmosCreditCardPaymentMethodForm` — `appearance`, `billingAddressRequirement`, `onValidityChange` (`isValid` is also true after Plaid Link returns credentials).
-
-Compare locally once the iframe posts `ACH_THRESHOLD`: Plaid when `requireVerification` is true (setup intents), or when the amount (converted to cents, default `0`) is `>= achThreshold`. No threshold (or `null`) keeps the manual bank form. Render tokens with Plaid verification disabled never require Connect. If `amount` later drops under the threshold, Plaid credentials are dropped and the iframe form is shown again.
+- `requireAchVerification` (`boolean`, defaults to `false`) — when true, show Plaid Embedded Link instead of routing/account fields. Ignored for `intent="setup"` (always Plaid) and when the render token has bank `verification: false`. Hosts that still have an ACH threshold should compute this themselves and pass a new value when the charge changes.
+- `intent` (`"payment" | "setup"`, defaults to `"payment"`) — `"setup"` always shows Plaid unless the render token disables verification. Use this when saving a bank account for later charges.
 
 ```tsx
 <AmosBankAccountPaymentMethodForm
   renderToken={renderToken}
-  amount="50.00" // defaults to "0" (manual form until the charge meets the threshold)
+  requireAchVerification
 />
 ```
 
-Setup (always Connect, no merchant lookup):
+Setup (always Plaid, unless the render token disables verification):
 
 ```tsx
 <AmosBankAccountPaymentMethodForm
@@ -585,15 +582,15 @@ Re-exports of the same advanced helpers exposed by `@amos.com/amos-js`. Most int
 
 ### Exported types
 
-`@amos.com/react-amos-js` re-exports everything from `@amos.com/amos-js`, including `ConfirmResult`, `ConfirmationResult` (deprecated), `ConfirmationIncompleteReason`, `PaymentMethodFormValidityChangeEvent`, `CardBrand`, `PaymentMethodFormCardBrandChangeEvent`, `FormattedGooglePayPaymentData`, `Message`, `Appearance`, `ThemeVariable`, and the per-form `*Options` / `*Controller` types. For OpenAPI schema types (e.g. `PaymentIntent`, `CreatePaymentIntentInput`), import `components` from `@amos.com/node`.
+`@amos.com/react-amos-js` re-exports everything from `@amos.com/amos-js`, including `ConfirmResult`, `PaymentMethodFormValidityChangeEvent`, `CardBrand`, `PaymentMethodFormCardBrandChangeEvent`, `FormattedGooglePayPaymentData`, `Message`, `Appearance`, `ThemeVariable`, and the per-form `*Options` / `*Controller` types. For OpenAPI schema types (e.g. `PaymentIntent`, `CreatePaymentIntentInput`), import `components` from `@amos.com/node`.
 
 ## Notes and potential gotchas
 
 - **`ref` / `iframeRef`**: for card and bank forms, pass `ref={iframeRef}` to the form component. The same `iframeRef` must be used when calling `validateForm`, `confirmPayment`, `confirmSetup`, or `resetForm`. The component forwards the ref to the inner iframe.
-- **`confirmPayment` / `confirmSetup` are not settlement proof**: `{ status: "succeeded" }` means authorization succeeded (capture may still finish asynchronously). Verify payment or setup success on your backend via webhooks. Recoverable field errors stay in the iframe; the Promise still resolves `{ status: "failed" }`. Deprecated `onResult` still receives `incomplete` with `reason` (`"field_errors"` or `"validation_failed"`).
+- **`confirmPayment` / `confirmSetup` are not settlement proof**: `{ status: "succeeded" }` means authorization succeeded (capture may still finish asynchronously). Verify payment or setup success on your backend via webhooks. Recoverable field errors stay in the iframe; the Promise still resolves `{ status: "failed" }`.
 - **Same components for payment vs setup intents**: `AmosCreditCardPaymentMethodForm` and `AmosBankAccountPaymentMethodForm` support both payment intents and setup intents. The flow differs only by which server call you make and which confirmation function you use (`confirmPayment` vs `confirmSetup`).
-- **Amount format**: for `AmosGooglePayButton`, `AmosApplePayButton`, and `AmosBankAccountPaymentMethodForm`, `amount` is a major-currency decimal string (e.g. `"50.00"` for $50.00). For `components["schemas"]["CreatePaymentIntentInput"]` on the server (card/bank create, and the object the wallet iframe sends to `onConfirm`), `amount` is a number in cents (e.g. `5000`).
-- **Plaid Link (ACH verification)**: load `cdn.plaid.com` from the **parent** document (see CSP on `AmosBankAccountPaymentMethodForm`). Merchants do not proxy Pay API; the bank iframe fetches the ACH threshold for payment intents and mints link tokens. Setup intents skip the merchant lookup and always require Plaid unless the render token disables verification. Confirm still goes through the bank iframe so Amos can attach `plaid` to the payment method.
+- **Amount format**: for `AmosGooglePayButton` and `AmosApplePayButton`, `amount` is a major-currency decimal string (e.g. `"50.00"` for $50.00). For `components["schemas"]["CreatePaymentIntentInput"]` on the server (card/bank create, and the object the wallet iframe sends to `onConfirm`), `amount` is a number in cents (e.g. `5000`).
+- **Plaid Embedded Link (ACH verification)**: load `cdn.plaid.com` from the **parent** document (see CSP on `AmosBankAccountPaymentMethodForm`). Merchants do not proxy Pay API; the bank iframe mints link tokens. Pass `requireAchVerification` when the host wants Plaid, or `intent="setup"` to always show it, unless the render token disables verification. Confirm still goes through the bank iframe so Amos can attach `plaid` to the payment method.
 - **Apple Pay waiting overlay**: on browsers where Apple's QR handoff opens in a popup (non-Safari), `AmosApplePayButton` shows a fixed full-viewport overlay on the host page until payment completes, the popup closes, or the user clicks **Cancel payment**. Avoid stacking other fixed UI above it.
 - **Going framework-free**: if you need to use Amos outside of React (vanilla JS, another framework, etc.), use [`@amos.com/amos-js`](../amos-js) directly.
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="googlepay" />
-import { Appearance, ApplePayButtonElementProps, BillingAddressRequirement, ConfirmationResult, ConfirmResult, CreditCardAdditionalFields, GooglePayButtonElementProps } from '@amos.com/amos-js';
+import { Appearance, ApplePayButtonElementProps, BillingAddressRequirement, ConfirmResult, CreditCardAdditionalFields, GooglePayButtonElementProps } from '@amos.com/amos-js';
 import { components } from '@amos.com/node';
 import { ComponentProps, Ref, RefObject } from 'react';
 export * from '@amos.com/amos-js';
@@ -33,21 +33,9 @@ export declare function confirmPayment({ iframeRef, token, }: {
 export declare function confirmSetup({ iframeRef, token, }: {
     iframeRef: IframeRef;
 } & Pick<components["schemas"]["EmbedToken"], "token">): Promise<ConfirmResult>;
-/**
- * @deprecated Use {@link confirmPayment}.
- */
-export declare function confirmPaymentIntent({ iframeRef, token, }: {
-    iframeRef: IframeRef;
-} & Pick<components["schemas"]["EmbedToken"], "token">): Promise<ConfirmResult>;
-/**
- * @deprecated Use {@link confirmSetup}.
- */
-export declare function confirmSetupIntent({ iframeRef, token, }: {
-    iframeRef: IframeRef;
-} & Pick<components["schemas"]["EmbedToken"], "token">): Promise<ConfirmResult>;
 /**
  * Clear all field values and API errors in the embedded card/bank iframe
- * form. Call after `onResult` when the customer wants to try again.
+ * form. Call after a failed confirm when the customer wants to try again.
  */
 export declare function resetForm({ iframeRef }: {
     iframeRef: IframeRef;
@@ -57,10 +45,6 @@ type IframePassthroughProps = Omit<ComponentProps<"iframe">, "src" | "title" | "
 type AmosCreditCardPaymentMethodFormProps = IframePassthroughProps & {
     renderToken: string;
     appearance?: Appearance;
-    /**
-     * @deprecated Prefer `await confirmPayment()` / `await confirmSetup()`.
-     */
-    onResult?: (result: ConfirmationResult) => void;
     /**
      * Called when form validity changes. `isValid` is true when all
      * required fields are present and valid. Does not include PCI data.
@@ -79,47 +63,38 @@ type AmosCreditCardPaymentMethodFormProps = IframePassthroughProps & {
     additionalFields?: CreditCardAdditionalFields;
     billingAddressRequirement?: BillingAddressRequirement;
 };
-export declare function AmosCreditCardPaymentMethodForm({ ref, renderToken, appearance, onResult, onValidityChange, onCardBrandChanged, additionalFields, billingAddressRequirement, style, ...rest }: AmosCreditCardPaymentMethodFormProps): import("react").JSX.Element;
+export declare function AmosCreditCardPaymentMethodForm({ ref, renderToken, appearance, onValidityChange, onCardBrandChanged, additionalFields, billingAddressRequirement, style, ...rest }: AmosCreditCardPaymentMethodFormProps): import("react").JSX.Element;
 type AmosBankAccountPaymentMethodFormProps = IframePassthroughProps & {
     renderToken: string;
     appearance?: Appearance;
-    /**
-     * @deprecated Prefer `await confirmPayment()` / `await confirmSetup()`.
-     */
-    onResult?: (result: ConfirmationResult) => void;
     /**
      * Called when form validity changes. `isValid` is true when all
-     * required fields are present and valid, or when Plaid Link has
-     * returned credentials. Does not include PCI data.
+     * required fields are present and valid, or when Plaid Embedded Link
+     * has returned credentials. Does not include PCI data.
      */
     onValidityChange?: (event: {
         isValid: boolean;
     }) => void;
     billingAddressRequirement?: BillingAddressRequirement;
     /**
-     * Charge amount as a major-currency decimal string (e.g. `"50.00"`
-     * for $50.00), the same format as Google Pay / Apple Pay. Compared
-     * to the merchant ACH threshold fetched by the iframe. Defaults to
-     * `"0"`, which is typically under the threshold so Connect / Plaid
-     * stays hidden until the host passes a real charge.
-     *
-     * Ignored when {@link AmosBankAccountPaymentMethodFormProps.intent} is
-     * `"setup"`.
+     * When true, hide the routing/account iframe and mount Plaid Embedded
+     * Institution Search in the parent. Ignored when `intent` is `"setup"`
+     * (setup always shows Plaid) or when the render token disables
+     * verification.
      *
-     * @default "0"
+     * @default false
      */
-    amount?: string;
+    requireAchVerification?: boolean;
     /**
      * `"setup"` saves a bank account for later charges and always shows
-     * Connect / Plaid (no merchant threshold lookup). `"payment"`
-     * compares {@link AmosBankAccountPaymentMethodFormProps.amount} to the
-     * merchant ACH threshold.
+     * Plaid (unless the render token disables verification). `"payment"`
+     * uses {@link AmosBankAccountPaymentMethodFormProps.requireAchVerification}.
      *
      * @default "payment"
      */
     intent?: "payment" | "setup";
 };
-export declare function AmosBankAccountPaymentMethodForm({ ref, renderToken, appearance, onResult, onValidityChange, billingAddressRequirement, amount, intent, style, ...rest }: AmosBankAccountPaymentMethodFormProps): import("react").JSX.Element;
+export declare function AmosBankAccountPaymentMethodForm({ ref, renderToken, appearance, onValidityChange, billingAddressRequirement, requireAchVerification, intent, style, ...rest }: AmosBankAccountPaymentMethodFormProps): import("react").JSX.Element;
 type AmosGooglePayButtonProps = {
     ref?: ForwardedIframeRef;
     renderToken: string;

package/dist/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@amos.com/amos-js"),t=require("react"),n=require("react/jsx-runtime");function r(e){return e?e.current??null:null}function i({iframeRef:t}){return(0,e.validateForm)({iframe:r(t)})}function a({iframeRef:t,token:n}){return(0,e.confirmPayment)({iframe:r(t),token:n})}function o({iframeRef:t,token:n}){return(0,e.confirmSetup)({iframe:r(t),token:n})}function s({iframeRef:t,token:n}){return(0,e.confirmPaymentIntent)({iframe:r(t),token:n})}function c({iframeRef:t,token:n}){return(0,e.confirmSetupIntent)({iframe:r(t),token:n})}function l({iframeRef:t}){(0,e.resetForm)({iframe:r(t)})}function u(e,t){typeof e==`function`?e(t):e&&(e.current=t)}function d(e,{style:t,className:n,id:r,...i}){n!=null&&(e.className=n),r!=null&&(e.id=r),Object.assign(e.style,t);for(let[t,n]of Object.entries(i))n!=null&&(t in e?Reflect.set(e,t,n):e.setAttribute(t,String(n)))}function f({containerRef:e,iframeRef:n,mount:r,options:i,remountDeps:a,iframePassthrough:o,updateDeps:s}){let c=(0,t.useRef)(null);(0,t.useLayoutEffect)(()=>{let t=e.current;if(!t)return;let a=r(t,i);return c.current=a,u(n,a.iframe),d(a.iframe,o),()=>{a.destroy(),c.current=null,u(n,null)}},[...a]),(0,t.useEffect)(()=>{c.current?.update(i)},[...s]),(0,t.useEffect)(()=>{let e=c.current?.iframe;e&&d(e,o)})}var p=`oklch(0.97 0 0)`;function m({height:r,borderRadius:i,containerRef:a}){return(0,t.useLayoutEffect)(()=>{(0,e.ensureSkeletonStyles)()},[]),(0,n.jsxs)(`div`,{style:{boxSizing:`border-box`,position:`relative`,width:`100%`,height:r,minHeight:r,overflow:`hidden`},children:[(0,n.jsx)(`div`,{className:`amos-js-form-skeleton-input amos-js-wallet-skeleton`,style:{position:`absolute`,inset:0,height:r,borderRadius:i,background:p,pointerEvents:`none`,zIndex:0},"aria-hidden":!0}),(0,n.jsx)(`div`,{ref:a,style:{position:`absolute`,inset:0,zIndex:1,width:`100%`,height:`100%`}})]})}function h({ref:r,renderToken:i,appearance:a,onResult:o,onValidityChange:s,onCardBrandChanged:c,additionalFields:l={cardholderName:!1},billingAddressRequirement:u=`country`,style:d,...p}){let m=(0,t.useRef)(null);return f({containerRef:m,iframeRef:r,mount:e.mountAmosCreditCardPaymentMethodForm,options:{renderToken:i,appearance:a,additionalFields:l,billingAddressRequirement:u,onResult:o,onValidityChange:s,onCardBrandChanged:c},remountDeps:[i,l.cardholderName,u],iframePassthrough:{style:d,...p},updateDeps:[a,l,u,o,s,c]}),(0,n.jsx)(`div`,{ref:m})}function g({ref:r,renderToken:i,appearance:a,onResult:o,onValidityChange:s,billingAddressRequirement:c=`country`,amount:l=`0`,intent:u=`payment`,style:d,...p}){let m=(0,t.useRef)(null);return f({containerRef:m,iframeRef:r,mount:e.mountAmosBankAccountPaymentMethodForm,options:{renderToken:i,appearance:a,billingAddressRequirement:c,amount:l,intent:u,onResult:o,onValidityChange:s},remountDeps:[i,c,u],iframePassthrough:{style:d,...p},updateDeps:[a,c,l,u,o,s]}),(0,n.jsx)(`div`,{ref:m})}function _({ref:r,renderToken:i,amount:a,merchantName:o,height:s=`48px`,buttonProps:c,iframeProps:l,onConfirm:u}){let d=(0,t.useRef)(null),p=(0,e.resolveWalletButtonSkeletonBorderRadius)({iframeStyle:l?.style,buttonProps:c});return f({containerRef:d,iframeRef:r,mount:e.mountAmosGooglePayButton,options:{renderToken:i,amount:a,merchantName:o,height:s,buttonProps:c,onConfirm:u},remountDeps:[i],iframePassthrough:l??{},updateDeps:[a,o,s,c,u]}),(0,n.jsx)(m,{height:s,borderRadius:p,containerRef:d})}function v({ref:r,renderToken:i,amount:a,merchantName:o,height:s=`48px`,buttonProps:c,iframeProps:l,onConfirm:u}){let d=(0,t.useRef)(null),p=(0,e.resolveWalletButtonSkeletonBorderRadius)({iframeStyle:l?.style,buttonProps:c});return f({containerRef:d,iframeRef:r,mount:e.mountAmosApplePayButton,options:{renderToken:i,amount:a,merchantName:o,height:s,buttonProps:c,onConfirm:u},remountDeps:[i],iframePassthrough:l??{},updateDeps:[a,o,s,c,u]}),(0,n.jsx)(m,{height:s,borderRadius:p,containerRef:d})}exports.AmosApplePayButton=v,exports.AmosBankAccountPaymentMethodForm=g,exports.AmosCreditCardPaymentMethodForm=h,exports.AmosGooglePayButton=_,exports.confirmPayment=a,exports.confirmPaymentIntent=s,exports.confirmSetup=o,exports.confirmSetupIntent=c,exports.resetForm=l,exports.validateForm=i,Object.keys(e).forEach(function(t){t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@amos.com/amos-js"),t=require("react"),n=require("react/jsx-runtime");function r(e){return e?e.current??null:null}function i({iframeRef:t}){return(0,e.validateForm)({iframe:r(t)})}function a({iframeRef:t,token:n}){return(0,e.confirmPayment)({iframe:r(t),token:n})}function o({iframeRef:t,token:n}){return(0,e.confirmSetup)({iframe:r(t),token:n})}function s({iframeRef:t}){(0,e.resetForm)({iframe:r(t)})}function c(e,t){typeof e==`function`?e(t):e&&(e.current=t)}function l(e,{style:t,className:n,id:r,...i}){n!=null&&(e.className=n),r!=null&&(e.id=r),Object.assign(e.style,t);for(let[t,n]of Object.entries(i))n!=null&&(t in e?Reflect.set(e,t,n):e.setAttribute(t,String(n)))}function u({containerRef:e,iframeRef:n,mount:r,options:i,remountDeps:a,iframePassthrough:o,updateDeps:s}){let u=(0,t.useRef)(null);(0,t.useLayoutEffect)(()=>{let t=e.current;if(!t)return;let a=r(t,i);return u.current=a,c(n,a.iframe),l(a.iframe,o),()=>{a.destroy(),u.current=null,c(n,null)}},[...a]),(0,t.useEffect)(()=>{u.current?.update(i)},[...s]),(0,t.useEffect)(()=>{let e=u.current?.iframe;e&&l(e,o)})}var d=`oklch(0.97 0 0)`;function f({height:r,borderRadius:i,containerRef:a}){return(0,t.useLayoutEffect)(()=>{(0,e.ensureSkeletonStyles)()},[]),(0,n.jsxs)(`div`,{style:{boxSizing:`border-box`,position:`relative`,width:`100%`,height:r,minHeight:r,overflow:`hidden`},children:[(0,n.jsx)(`div`,{className:`amos-js-form-skeleton-input amos-js-wallet-skeleton`,style:{position:`absolute`,inset:0,height:r,borderRadius:i,background:d,pointerEvents:`none`,zIndex:0},"aria-hidden":!0}),(0,n.jsx)(`div`,{ref:a,style:{position:`absolute`,inset:0,zIndex:1,width:`100%`,height:`100%`}})]})}function p({ref:r,renderToken:i,appearance:a,onValidityChange:o,onCardBrandChanged:s,additionalFields:c={cardholderName:!1},billingAddressRequirement:l=`country`,style:d,...f}){let p=(0,t.useRef)(null);return u({containerRef:p,iframeRef:r,mount:e.mountAmosCreditCardPaymentMethodForm,options:{renderToken:i,appearance:a,additionalFields:c,billingAddressRequirement:l,onValidityChange:o,onCardBrandChanged:s},remountDeps:[i,c.cardholderName,l],iframePassthrough:{style:d,...f},updateDeps:[a,c,l,o,s]}),(0,n.jsx)(`div`,{ref:p})}function m({ref:r,renderToken:i,appearance:a,onValidityChange:o,billingAddressRequirement:s=`country`,requireAchVerification:c=!1,intent:l=`payment`,style:d,...f}){let p=(0,t.useRef)(null);return u({containerRef:p,iframeRef:r,mount:e.mountAmosBankAccountPaymentMethodForm,options:{renderToken:i,appearance:a,billingAddressRequirement:s,requireAchVerification:c,intent:l,onValidityChange:o},remountDeps:[i,s,l],iframePassthrough:{style:d,...f},updateDeps:[a,s,c,l,o]}),(0,n.jsx)(`div`,{ref:p})}function h({ref:r,renderToken:i,amount:a,merchantName:o,height:s=`48px`,buttonProps:c,iframeProps:l,onConfirm:d}){let p=(0,t.useRef)(null),m=(0,e.resolveWalletButtonSkeletonBorderRadius)({iframeStyle:l?.style,buttonProps:c});return u({containerRef:p,iframeRef:r,mount:e.mountAmosGooglePayButton,options:{renderToken:i,amount:a,merchantName:o,height:s,buttonProps:c,onConfirm:d},remountDeps:[i],iframePassthrough:l??{},updateDeps:[a,o,s,c,d]}),(0,n.jsx)(f,{height:s,borderRadius:m,containerRef:p})}function g({ref:r,renderToken:i,amount:a,merchantName:o,height:s=`48px`,buttonProps:c,iframeProps:l,onConfirm:d}){let p=(0,t.useRef)(null),m=(0,e.resolveWalletButtonSkeletonBorderRadius)({iframeStyle:l?.style,buttonProps:c});return u({containerRef:p,iframeRef:r,mount:e.mountAmosApplePayButton,options:{renderToken:i,amount:a,merchantName:o,height:s,buttonProps:c,onConfirm:d},remountDeps:[i],iframePassthrough:l??{},updateDeps:[a,o,s,c,d]}),(0,n.jsx)(f,{height:s,borderRadius:m,containerRef:p})}exports.AmosApplePayButton=g,exports.AmosBankAccountPaymentMethodForm=m,exports.AmosCreditCardPaymentMethodForm=p,exports.AmosGooglePayButton=h,exports.confirmPayment=a,exports.confirmSetup=o,exports.resetForm=s,exports.validateForm=i,Object.keys(e).forEach(function(t){t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/index.mjs

@@ -1,69 +1,57 @@
-import { confirmPayment as e, confirmPaymentIntent as t, confirmSetup as n, confirmSetupIntent as r, ensureSkeletonStyles as i, mountAmosApplePayButton as a, mountAmosBankAccountPaymentMethodForm as o, mountAmosCreditCardPaymentMethodForm as s, mountAmosGooglePayButton as c, resetForm as l, resolveWalletButtonSkeletonBorderRadius as u, validateForm as d } from "@amos.com/amos-js";
-import { useEffect as f, useLayoutEffect as p, useRef as m } from "react";
-import { jsx as h, jsxs as g } from "react/jsx-runtime";
+import { confirmPayment as e, confirmSetup as t, ensureSkeletonStyles as n, mountAmosApplePayButton as r, mountAmosBankAccountPaymentMethodForm as i, mountAmosCreditCardPaymentMethodForm as a, mountAmosGooglePayButton as o, resetForm as s, resolveWalletButtonSkeletonBorderRadius as c, validateForm as l } from "@amos.com/amos-js";
+import { useEffect as u, useLayoutEffect as d, useRef as f } from "react";
+import { jsx as p, jsxs as m } from "react/jsx-runtime";
 export * from "@amos.com/amos-js";
 //#region src/index.tsx
-function _(e) {
+function h(e) {
 	return e ? e.current ?? null : null;
 }
-function v({ iframeRef: e }) {
-	return d({ iframe: _(e) });
+function g({ iframeRef: e }) {
+	return l({ iframe: h(e) });
 }
-function y({ iframeRef: t, token: n }) {
+function _({ iframeRef: t, token: n }) {
 	return e({
-		iframe: _(t),
+		iframe: h(t),
 		token: n
 	});
 }
-function b({ iframeRef: e, token: t }) {
-	return n({
-		iframe: _(e),
-		token: t
-	});
-}
-function x({ iframeRef: e, token: n }) {
+function v({ iframeRef: e, token: n }) {
 	return t({
-		iframe: _(e),
+		iframe: h(e),
 		token: n
 	});
 }
-function S({ iframeRef: e, token: t }) {
-	return r({
-		iframe: _(e),
-		token: t
-	});
-}
-function C({ iframeRef: e }) {
-	l({ iframe: _(e) });
+function y({ iframeRef: e }) {
+	s({ iframe: h(e) });
 }
-function w(e, t) {
+function b(e, t) {
 	typeof e == "function" ? e(t) : e && (e.current = t);
 }
-function T(e, { style: t, className: n, id: r, ...i }) {
+function x(e, { style: t, className: n, id: r, ...i }) {
 	n != null && (e.className = n), r != null && (e.id = r), Object.assign(e.style, t);
 	for (let [t, n] of Object.entries(i)) n != null && (t in e ? Reflect.set(e, t, n) : e.setAttribute(t, String(n)));
 }
-function E({ containerRef: e, iframeRef: t, mount: n, options: r, remountDeps: i, iframePassthrough: a, updateDeps: o }) {
-	let s = m(null);
-	p(() => {
+function S({ containerRef: e, iframeRef: t, mount: n, options: r, remountDeps: i, iframePassthrough: a, updateDeps: o }) {
+	let s = f(null);
+	d(() => {
 		let i = e.current;
 		if (!i) return;
 		let o = n(i, r);
-		return s.current = o, w(t, o.iframe), T(o.iframe, a), () => {
-			o.destroy(), s.current = null, w(t, null);
+		return s.current = o, b(t, o.iframe), x(o.iframe, a), () => {
+			o.destroy(), s.current = null, b(t, null);
 		};
-	}, [...i]), f(() => {
+	}, [...i]), u(() => {
 		s.current?.update(r);
-	}, [...o]), f(() => {
+	}, [...o]), u(() => {
 		let e = s.current?.iframe;
-		e && T(e, a);
+		e && x(e, a);
 	});
 }
-var D = "oklch(0.97 0 0)";
-function O({ height: e, borderRadius: t, containerRef: n }) {
-	return p(() => {
-		i();
-	}, []), /* @__PURE__ */ g("div", {
+var C = "oklch(0.97 0 0)";
+function w({ height: e, borderRadius: t, containerRef: r }) {
+	return d(() => {
+		n();
+	}, []), /* @__PURE__ */ m("div", {
 		style: {
 			boxSizing: "border-box",
 			position: "relative",
@@ -72,20 +60,20 @@ function O({ height: e, borderRadius: t, containerRef: n }) {
 			minHeight: e,
 			overflow: "hidden"
 		},
-		children: [/* @__PURE__ */ h("div", {
+		children: [/* @__PURE__ */ p("div", {
 			className: "amos-js-form-skeleton-input amos-js-wallet-skeleton",
 			style: {
 				position: "absolute",
 				inset: 0,
 				height: e,
 				borderRadius: t,
-				background: D,
+				background: C,
 				pointerEvents: "none",
 				zIndex: 0
 			},
 			"aria-hidden": !0
-		}), /* @__PURE__ */ h("div", {
-			ref: n,
+		}), /* @__PURE__ */ p("div", {
+			ref: r,
 			style: {
 				position: "absolute",
 				inset: 0,
@@ -96,137 +84,133 @@ function O({ height: e, borderRadius: t, containerRef: n }) {
 		})]
 	});
 }
-function k({ ref: e, renderToken: t, appearance: n, onResult: r, onValidityChange: i, onCardBrandChanged: a, additionalFields: o = { cardholderName: !1 }, billingAddressRequirement: c = "country", style: l, ...u }) {
-	let d = m(null);
-	return E({
-		containerRef: d,
+function T({ ref: e, renderToken: t, appearance: n, onValidityChange: r, onCardBrandChanged: i, additionalFields: o = { cardholderName: !1 }, billingAddressRequirement: s = "country", style: c, ...l }) {
+	let u = f(null);
+	return S({
+		containerRef: u,
 		iframeRef: e,
-		mount: s,
+		mount: a,
 		options: {
 			renderToken: t,
 			appearance: n,
 			additionalFields: o,
-			billingAddressRequirement: c,
-			onResult: r,
-			onValidityChange: i,
-			onCardBrandChanged: a
+			billingAddressRequirement: s,
+			onValidityChange: r,
+			onCardBrandChanged: i
 		},
 		remountDeps: [
 			t,
 			o.cardholderName,
-			c
+			s
 		],
 		iframePassthrough: {
-			style: l,
-			...u
+			style: c,
+			...l
 		},
 		updateDeps: [
 			n,
 			o,
-			c,
+			s,
 			r,
-			i,
-			a
+			i
 		]
-	}), /* @__PURE__ */ h("div", { ref: d });
+	}), /* @__PURE__ */ p("div", { ref: u });
 }
-function A({ ref: e, renderToken: t, appearance: n, onResult: r, onValidityChange: i, billingAddressRequirement: a = "country", amount: s = "0", intent: c = "payment", style: l, ...u }) {
-	let d = m(null);
-	return E({
-		containerRef: d,
+function E({ ref: e, renderToken: t, appearance: n, onValidityChange: r, billingAddressRequirement: a = "country", requireAchVerification: o = !1, intent: s = "payment", style: c, ...l }) {
+	let u = f(null);
+	return S({
+		containerRef: u,
 		iframeRef: e,
-		mount: o,
+		mount: i,
 		options: {
 			renderToken: t,
 			appearance: n,
 			billingAddressRequirement: a,
-			amount: s,
-			intent: c,
-			onResult: r,
-			onValidityChange: i
+			requireAchVerification: o,
+			intent: s,
+			onValidityChange: r
 		},
 		remountDeps: [
 			t,
 			a,
-			c
+			s
 		],
 		iframePassthrough: {
-			style: l,
-			...u
+			style: c,
+			...l
 		},
 		updateDeps: [
 			n,
 			a,
+			o,
 			s,
-			c,
-			r,
-			i
+			r
 		]
-	}), /* @__PURE__ */ h("div", { ref: d });
+	}), /* @__PURE__ */ p("div", { ref: u });
 }
-function j({ ref: e, renderToken: t, amount: n, merchantName: r, height: i = "48px", buttonProps: a, iframeProps: o, onConfirm: s }) {
-	let l = m(null), d = u({
-		iframeStyle: o?.style,
+function D({ ref: e, renderToken: t, amount: n, merchantName: r, height: i = "48px", buttonProps: a, iframeProps: s, onConfirm: l }) {
+	let u = f(null), d = c({
+		iframeStyle: s?.style,
 		buttonProps: a
 	});
-	return E({
-		containerRef: l,
+	return S({
+		containerRef: u,
 		iframeRef: e,
-		mount: c,
+		mount: o,
 		options: {
 			renderToken: t,
 			amount: n,
 			merchantName: r,
 			height: i,
 			buttonProps: a,
-			onConfirm: s
+			onConfirm: l
 		},
 		remountDeps: [t],
-		iframePassthrough: o ?? {},
+		iframePassthrough: s ?? {},
 		updateDeps: [
 			n,
 			r,
 			i,
 			a,
-			s
+			l
 		]
-	}), /* @__PURE__ */ h(O, {
+	}), /* @__PURE__ */ p(w, {
 		height: i,
 		borderRadius: d,
-		containerRef: l
+		containerRef: u
 	});
 }
-function M({ ref: e, renderToken: t, amount: n, merchantName: r, height: i = "48px", buttonProps: o, iframeProps: s, onConfirm: c }) {
-	let l = m(null), d = u({
+function O({ ref: e, renderToken: t, amount: n, merchantName: i, height: a = "48px", buttonProps: o, iframeProps: s, onConfirm: l }) {
+	let u = f(null), d = c({
 		iframeStyle: s?.style,
 		buttonProps: o
 	});
-	return E({
-		containerRef: l,
+	return S({
+		containerRef: u,
 		iframeRef: e,
-		mount: a,
+		mount: r,
 		options: {
 			renderToken: t,
 			amount: n,
-			merchantName: r,
-			height: i,
+			merchantName: i,
+			height: a,
 			buttonProps: o,
-			onConfirm: c
+			onConfirm: l
 		},
 		remountDeps: [t],
 		iframePassthrough: s ?? {},
 		updateDeps: [
 			n,
-			r,
 			i,
+			a,
 			o,
-			c
+			l
 		]
-	}), /* @__PURE__ */ h(O, {
-		height: i,
+	}), /* @__PURE__ */ p(w, {
+		height: a,
 		borderRadius: d,
-		containerRef: l
+		containerRef: u
 	});
 }
 //#endregion
-export { M as AmosApplePayButton, A as AmosBankAccountPaymentMethodForm, k as AmosCreditCardPaymentMethodForm, j as AmosGooglePayButton, y as confirmPayment, x as confirmPaymentIntent, b as confirmSetup, S as confirmSetupIntent, C as resetForm, v as validateForm };
+export { O as AmosApplePayButton, E as AmosBankAccountPaymentMethodForm, T as AmosCreditCardPaymentMethodForm, D as AmosGooglePayButton, _ as confirmPayment, v as confirmSetup, y as resetForm, g as validateForm };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amos.com/react-amos-js",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "main": "dist/index.js",
   "repository": {
     "type": "git",
@@ -48,7 +48,7 @@
     "vite-plugin-dts": "5.0.3"
   },
   "dependencies": {
-    "@amos.com/amos-js": "0.11.2",
+    "@amos.com/amos-js": "0.11.4",
     "@types/googlepay": "0.7.12"
   },
   "peerDependencies": {

package/src/index.tsx

@@ -4,13 +4,10 @@ import {
   type Appearance,
   type ApplePayButtonElementProps,
   confirmPayment as amosConfirmPayment,
-  confirmPaymentIntent as amosConfirmPaymentIntent,
   confirmSetup as amosConfirmSetup,
-  confirmSetupIntent as amosConfirmSetupIntent,
   resetForm as amosResetForm,
   validateForm as amosValidateForm,
   type BillingAddressRequirement,
-  type ConfirmationResult,
   type ConfirmResult,
   type CreditCardAdditionalFields,
   ensureSkeletonStyles,
@@ -94,39 +91,9 @@ export function confirmSetup({
   return amosConfirmSetup({ iframe: resolveIframe(iframeRef), token });
 }
 
-/**
- * @deprecated Use {@link confirmPayment}.
- */
-export function confirmPaymentIntent({
-  iframeRef,
-  token,
-}: {
-  iframeRef: IframeRef;
-} & Pick<
-  components["schemas"]["EmbedToken"],
-  "token"
->): Promise<ConfirmResult> {
-  return amosConfirmPaymentIntent({ iframe: resolveIframe(iframeRef), token });
-}
-
-/**
- * @deprecated Use {@link confirmSetup}.
- */
-export function confirmSetupIntent({
-  iframeRef,
-  token,
-}: {
-  iframeRef: IframeRef;
-} & Pick<
-  components["schemas"]["EmbedToken"],
-  "token"
->): Promise<ConfirmResult> {
-  return amosConfirmSetupIntent({ iframe: resolveIframe(iframeRef), token });
-}
-
 /**
  * Clear all field values and API errors in the embedded card/bank iframe
- * form. Call after `onResult` when the customer wants to try again.
+ * form. Call after a failed confirm when the customer wants to try again.
  */
 export function resetForm({ iframeRef }: { iframeRef: IframeRef }): void {
   amosResetForm({ iframe: resolveIframe(iframeRef) });
@@ -286,10 +253,6 @@ function WalletButtonSlot({
 type AmosCreditCardPaymentMethodFormProps = IframePassthroughProps & {
   renderToken: string;
   appearance?: Appearance;
-  /**
-   * @deprecated Prefer `await confirmPayment()` / `await confirmSetup()`.
-   */
-  onResult?: (result: ConfirmationResult) => void;
   /**
    * Called when form validity changes. `isValid` is true when all
    * required fields are present and valid. Does not include PCI data.
@@ -318,7 +281,6 @@ export function AmosCreditCardPaymentMethodForm({
   ref,
   renderToken,
   appearance,
-  onResult,
   onValidityChange,
   onCardBrandChanged,
   additionalFields = { cardholderName: false },
@@ -337,7 +299,6 @@ export function AmosCreditCardPaymentMethodForm({
       appearance,
       additionalFields,
       billingAddressRequirement,
-      onResult,
       onValidityChange,
       onCardBrandChanged,
     },
@@ -351,7 +312,6 @@ export function AmosCreditCardPaymentMethodForm({
       appearance,
       additionalFields,
       billingAddressRequirement,
-      onResult,
       onValidityChange,
       onCardBrandChanged,
     ],
@@ -363,35 +323,26 @@ export function AmosCreditCardPaymentMethodForm({
 type AmosBankAccountPaymentMethodFormProps = IframePassthroughProps & {
   renderToken: string;
   appearance?: Appearance;
-  /**
-   * @deprecated Prefer `await confirmPayment()` / `await confirmSetup()`.
-   */
-  onResult?: (result: ConfirmationResult) => void;
   /**
    * Called when form validity changes. `isValid` is true when all
-   * required fields are present and valid, or when Plaid Link has
-   * returned credentials. Does not include PCI data.
+   * required fields are present and valid, or when Plaid Embedded Link
+   * has returned credentials. Does not include PCI data.
    */
   onValidityChange?: (event: { isValid: boolean }) => void;
   billingAddressRequirement?: BillingAddressRequirement;
   /**
-   * Charge amount as a major-currency decimal string (e.g. `"50.00"`
-   * for $50.00), the same format as Google Pay / Apple Pay. Compared
-   * to the merchant ACH threshold fetched by the iframe. Defaults to
-   * `"0"`, which is typically under the threshold so Connect / Plaid
-   * stays hidden until the host passes a real charge.
+   * When true, hide the routing/account iframe and mount Plaid Embedded
+   * Institution Search in the parent. Ignored when `intent` is `"setup"`
+   * (setup always shows Plaid) or when the render token disables
+   * verification.
    *
-   * Ignored when {@link AmosBankAccountPaymentMethodFormProps.intent} is
-   * `"setup"`.
-   *
-   * @default "0"
+   * @default false
    */
-  amount?: string;
+  requireAchVerification?: boolean;
   /**
    * `"setup"` saves a bank account for later charges and always shows
-   * Connect / Plaid (no merchant threshold lookup). `"payment"`
-   * compares {@link AmosBankAccountPaymentMethodFormProps.amount} to the
-   * merchant ACH threshold.
+   * Plaid (unless the render token disables verification). `"payment"`
+   * uses {@link AmosBankAccountPaymentMethodFormProps.requireAchVerification}.
    *
    * @default "payment"
    */
@@ -402,10 +353,9 @@ export function AmosBankAccountPaymentMethodForm({
   ref,
   renderToken,
   appearance,
-  onResult,
   onValidityChange,
   billingAddressRequirement = "country",
-  amount = "0",
+  requireAchVerification = false,
   intent = "payment",
   style,
   ...rest
@@ -420,9 +370,8 @@ export function AmosBankAccountPaymentMethodForm({
       renderToken,
       appearance,
       billingAddressRequirement,
-      amount,
+      requireAchVerification,
       intent,
-      onResult,
       onValidityChange,
     },
     remountDeps: [renderToken, billingAddressRequirement, intent],
@@ -430,9 +379,8 @@ export function AmosBankAccountPaymentMethodForm({
     updateDeps: [
       appearance,
       billingAddressRequirement,
-      amount,
+      requireAchVerification,
       intent,
-      onResult,
       onValidityChange,
     ],
   });