@amos.com/react-amos-js 0.11.29 → 0.11.30

package/README.md

@@ -293,7 +293,7 @@ function CheckoutForm() {
         renderToken="the-render-token-that-you-created-on-dashboard.amos.com"
         additionalFields={{ cardholderName: true }}
         defaultValues={{
-          name: "Jane Doe",
+          cardholderName: "Jane Doe",
           billingAddress: {
             line1: "354 Oyster Point Blvd",
             city: "South San Francisco",
@@ -574,7 +574,7 @@ Renders the secure credit card iframe form. A field-shaped skeleton with an opaq
 
 - `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.
-- `defaultValues` (`{ name?: string; billingAddress?: { line1?, line2?, city?, state?, postalCode?, country? } }`) — seed cardholder / account-holder name and billing address. Provided keys overwrite matching fields, including ones the customer already edited. Values are also sent on confirm even when those inputs are hidden (cardholder name off, or `country` billing mode). Never send PAN, CVC, account number, or routing number.
+- `defaultValues` (`{ accountHolderName?: string; cardholderName?: string; billingAddress?: { name?, email?, phone?, line1?, line2?, city?, state?, postalCode?, country? } }`) — seed account-holder name, cardholder name, and billing address. Provided keys overwrite matching fields, including ones the customer already edited. `cardholderName` is applied and confirmed only when that input is shown. Billing fields are sent on confirm even when those inputs are hidden (`country` billing mode). Never send PAN, CVC, account number, or routing number.
 - `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.
 - `onPostalCodeChange` (`(event: { postalCode: string | null; country: string }) => void`) — called when the customer commits a billing postal code, or clears one. `postalCode` is a finished code, or `null` when a finished code is deleted or the country changes. Incomplete keystrokes are not reported. US and PR commit at 5 digits (ZIP+4 is reported as the first 5). Canada commits as `A1A 1A1`. The UK commits at a full postcode. Not called for `defaultValues`, so a host can copy its own postal field into the iframe until the first callback and then stop. Debounce shipping-rate requests in the host. Card and bank forms only.

package/dist/index.d.ts

@@ -103,8 +103,11 @@ type AmosCreditCardPaymentMethodFormProps = IframePassthroughProps & {
     billingAddressRequirement?: BillingAddressRequirement;
     /**
      * Seed cardholder name and billing address. Provided keys overwrite
-     * matching fields, including ones the customer already edited. Values
-     * are sent on confirm even when those inputs are hidden.
+     * matching fields, including ones the customer already edited.
+     * `cardholderName` prefills the cardholder input and is confirmed only
+     * when `additionalFields.cardholderName` is true. Billing fields,
+     * including `billingAddress.name`, `email`, and `phone`, are sent on
+     * confirm even when those inputs are hidden.
      */
     defaultValues?: PaymentMethodFormDefaultValues;
 };
@@ -138,7 +141,9 @@ type AmosBankAccountPaymentMethodFormProps = IframePassthroughProps & {
     /**
      * Seed account holder name and billing address. Provided keys
      * overwrite matching fields, including ones the customer already
-     * edited.
+     * edited. `accountHolderName` prefills the account-holder input.
+     * Billing fields, including `billingAddress.name`, `email`, and
+     * `phone`, are sent on confirm even when those inputs are hidden.
      */
     defaultValues?: PaymentMethodFormDefaultValues;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amos.com/react-amos-js",
-  "version": "0.11.29",
+  "version": "0.11.30",
   "main": "dist/index.js",
   "repository": {
     "type": "git",
@@ -57,7 +57,7 @@
     "vite-plugin-dts": "5.1.1"
   },
   "dependencies": {
-    "@amos.com/amos-js": "0.11.31",
+    "@amos.com/amos-js": "0.11.33",
     "@types/googlepay": "0.7.13"
   },
   "peerDependencies": {

package/src/index.tsx

@@ -345,8 +345,11 @@ type AmosCreditCardPaymentMethodFormProps = IframePassthroughProps & {
   billingAddressRequirement?: BillingAddressRequirement;
   /**
    * Seed cardholder name and billing address. Provided keys overwrite
-   * matching fields, including ones the customer already edited. Values
-   * are sent on confirm even when those inputs are hidden.
+   * matching fields, including ones the customer already edited.
+   * `cardholderName` prefills the cardholder input and is confirmed only
+   * when `additionalFields.cardholderName` is true. Billing fields,
+   * including `billingAddress.name`, `email`, and `phone`, are sent on
+   * confirm even when those inputs are hidden.
    */
   defaultValues?: PaymentMethodFormDefaultValues;
 };
@@ -430,7 +433,9 @@ type AmosBankAccountPaymentMethodFormProps = IframePassthroughProps & {
   /**
    * Seed account holder name and billing address. Provided keys
    * overwrite matching fields, including ones the customer already
-   * edited.
+   * edited. `accountHolderName` prefills the account-holder input.
+   * Billing fields, including `billingAddress.name`, `email`, and
+   * `phone`, are sent on confirm even when those inputs are hidden.
    */
   defaultValues?: PaymentMethodFormDefaultValues;
   /**