@amos.com/amos-js 0.3.24 → 0.4.0

package/README.md

@@ -232,6 +232,7 @@ Mount the secure credit-card payment method form into a container element (an `H
 
 - `appearance` (`{ themeVariables?: Partial<Record<ThemeVariable, string>>; labels?: "above" | "floating" | "placeholder" }`)
 - `additionalFields` (`{ cardholderName: boolean }`, defaults to `{ cardholderName: false }`)
+- `billingAddressRequirement` (`"postalCode" | "postalCodeAndCountry" | "full"`, defaults to `"postalCode"`) — how much billing address the iframe collects. `postalCode` sends only postal code (no country). `full` shows a full street address form with Smarty autocomplete.
 - `onPaymentIntentConfirmationSucceeded` (`(paymentIntent: components["schemas"]["PaymentIntent"]) => void`)
 - `onSetupIntentConfirmationSucceeded` (`(setupIntent: components["schemas"]["SetupIntent"]) => void`)
 - `onHeightChange`, `onAppearanceReady` (advanced — override the default iframe styling logic)
@@ -244,7 +245,7 @@ Mount the secure credit-card payment method form into a container element (an `H
 
 ### `mountAmosBankAccountPaymentMethodForm(container, options)`
 
-Same shape as `mountAmosCreditCardPaymentMethodForm`, minus `additionalFields`.
+Same shape as `mountAmosCreditCardPaymentMethodForm`, minus `additionalFields`. Supports the same `billingAddressRequirement` option.
 
 ### `mountAmosGooglePayButton(container, options)`
 
@@ -283,7 +284,7 @@ This is what `@amos.com/react-amos-js` uses to integrate with React's rendering
 
 The Google Pay equivalent of `attachPaymentMethodFormListeners`.
 
-### `getCreditCardFormSrc(renderToken, additionalFields?)` / `getBankAccountFormSrc(renderToken)` / `getGooglePayButtonSrc(renderToken)`
+### `getCreditCardFormSrc(renderToken, additionalFields?, billingAddressRequirement?)` / `getBankAccountFormSrc(renderToken, billingAddressRequirement?)` / `getGooglePayButtonSrc(renderToken)`
 
 Build the iframe `src` URL for each form type.
 

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { decodeJwt, getEmbedOrigin } from './jwt';
 export { confirmPaymentIntent, confirmSetupIntent, sendConfirmationFailed, sendParentReadyMessage, updateAmount, updateAppearance, updateMerchantName, validateForm, } from './messaging';
 export type { AmosBankAccountPaymentMethodFormOptions, AmosCreditCardPaymentMethodFormOptions, AmosGooglePayButtonMountController, AmosGooglePayButtonOptions, AmosPaymentMethodFormMountController, } from './mount';
 export { mountAmosBankAccountPaymentMethodForm, mountAmosCreditCardPaymentMethodForm, mountAmosGooglePayButton, } from './mount';
-export type { CreditCardAdditionalFields, PaymentMethodFormController, PaymentMethodFormListenerOptions, } from './payment-method-form';
+export type { BillingAddressRequirement, CreditCardAdditionalFields, PaymentMethodFormController, PaymentMethodFormListenerOptions, } from './payment-method-form';
 export { attachPaymentMethodFormListeners, getBankAccountFormInitialHeight, getBankAccountFormSrc, getCreditCardFormInitialHeight, getCreditCardFormSrc, } from './payment-method-form';
 export type { Appearance, AppearanceLabels, Message, ThemeVariable, } from './types';
 export { createMessage } from './types';

package/dist/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){let[t=``,n=``,r=``]=e?.split(`.`)??[],i=typeof atob==`function`?atob:e=>Buffer.from(e,`base64`).toString(`utf8`);return{header:JSON.parse(i(t)),payload:JSON.parse(i(n)),signature:r}}function t(t){let{env:n=`sandbox`}=e(t).payload;switch(n){case`production`:return`https://embed.amos.com`;case`sandbox`:return`https://embed-sandbox.amos.com`;default:return`https://embed-sandbox.amos.com`}}function n(e){return e}function r(e){e?.contentWindow?.postMessage(n({type:`PARENT_ACKNOWLEDGED_IFRAME_READY`}),`*`)}function i({iframe:e,appearance:t={}}){e?.contentWindow?.postMessage(n({type:`UPDATE_APPEARANCE`,appearance:t}),`*`)}function a({iframe:e,amount:t}){e?.contentWindow?.postMessage(n({type:`UPDATE_AMOUNT`,amount:t}),`*`)}function o({iframe:e,merchantName:t}){e?.contentWindow?.postMessage(n({type:`UPDATE_MERCHANT_NAME`,merchantName:t}),`*`)}function s({iframe:e}){let t=crypto.randomUUID();return new Promise(r=>{e?.contentWindow?.postMessage(n({type:`VALIDATE_FORM`,requestId:t}),`*`);let i=setTimeout(()=>{window.removeEventListener(`message`,a),r(!1)},5e3);function a(e){e.data.type===`VALIDATE_FORM`&&e.data.requestId===t&&(window.removeEventListener(`message`,a),clearTimeout(i),r(e.data.isValid??!1))}window.addEventListener(`message`,a)})}function c({iframe:t,token:r}){let{payment_intent_id:i}=e(r).payload;t?.contentWindow?.postMessage(n({type:`CONFIRM_PAYMENT_INTENT`,token:r,id:i??void 0}),`*`)}function l({iframe:t,token:r}){let{setup_intent_id:i}=e(r).payload;t?.contentWindow?.postMessage(n({type:`CONFIRM_SETUP_INTENT`,token:r,id:i??void 0}),`*`)}function u({iframe:e,errorMessage:t}){e?.contentWindow?.postMessage(n({type:`CONFIRMATION_FAILED`,errorMessage:t}),`*`)}function d(e){return`${t(e)}/iframe/google-pay?token=${e}`}function f(){return`40px`}function p(e,t){let n={...t};function s(){a({iframe:e,amount:n.amount})}function l(){o({iframe:e,merchantName:n.merchantName})}function d(t){switch(t.data.type){case`IFRAME_READY`:r(e),i({iframe:e,appearance:n.appearance}),s(),l();break;case`UPDATE_HEIGHT`:n.onHeightChange?.(t.data.height);break;case`UPDATE_APPEARANCE`:i({iframe:e,appearance:t.data.appearance});break;case`UPDATED_APPEARANCE`:n.onAppearanceReady?.();break;case`CREATE_PAYMENT_INTENT`:n.onInitiatePaymentIntentRequest({paymentIntentCreateAttributes:t.data.paymentIntentCreateAttributes,customerCreateAttributes:t.data.customerCreateAttributes}).then(t=>{c({iframe:e,token:t})}).catch(t=>{u({iframe:e,errorMessage:t instanceof Error?t.message:`Unknown error`})});break;case`PAYMENT_INTENT_CONFIRMATION_SUCCEEDED`:n.onPaymentIntentConfirmationSucceeded(t.data.paymentIntent);break;case`CONFIRMATION_FAILED`:n.onConfirmationFailed(t.data.errorMessage);break}}return window.addEventListener(`message`,d),{update(t){let r=`appearance`in t,a=`amount`in t,o=`merchantName`in t;n={...n,...t},r&&i({iframe:e,appearance:n.appearance}),a&&s(),o&&l()},destroy(){window.removeEventListener(`message`,d)}}}function m({paymentData:e}){return{paymentMethod:{type:`googlepay`,billing_address_attributes:{name:e.shippingAddress?.name,address_line1:e.shippingAddress?.address1,address_line2:e.shippingAddress?.address2,city:e.shippingAddress?.locality,state:e.shippingAddress?.administrativeArea,postal_code:e.shippingAddress?.postalCode,country:e.shippingAddress?.countryCode,email:e.email,phone:e.shippingAddress?.phoneNumber},card_profile_attributes:{wallet_provider:`googlepay`,wallet_payload:e.paymentMethodData.tokenizationData.token,wallet_last4:e.paymentMethodData.info?.cardDetails,wallet_brand:(()=>{switch(e.paymentMethodData.info?.cardNetwork){case`AMEX`:return`american_express`;case`VISA`:return`visa`;case`MASTERCARD`:return`master`;case`DISCOVER`:return`discover`;default:return}})()}}}}function h(e,n={cardholderName:!1}){let r=Object.entries(n).filter(([,e])=>e).map(([e])=>e).join(`,`);return`${t(e)}/iframe/card?token=${e}&additionalFields=${r}`}function g(e){return`${t(e)}/iframe/bank?token=${e}`}function _(e={cardholderName:!1}){return e.cardholderName?`292px`:`212px`}function v(){return`400px`}function y(e,t){let n={...t};function a(t){switch(t.data.type){case`IFRAME_READY`:r(e),i({iframe:e,appearance:n.appearance});break;case`UPDATE_HEIGHT`:n.onHeightChange?.(t.data.height);break;case`UPDATE_APPEARANCE`:i({iframe:e,appearance:t.data.appearance});break;case`UPDATED_APPEARANCE`:n.onAppearanceReady?.();break;case`PAYMENT_INTENT_CONFIRMATION_SUCCEEDED`:n.onPaymentIntentConfirmationSucceeded?.(t.data.paymentIntent);break;case`SETUP_INTENT_CONFIRMATION_SUCCEEDED`:n.onSetupIntentConfirmationSucceeded?.(t.data.setupIntent);break;case`CONFIRMATION_FAILED`:n.onConfirmationFailed(t.data.errorMessage);break}}return window.addEventListener(`message`,a),{update(t){let r=`appearance`in t;n={...n,...t},r&&i({iframe:e,appearance:n.appearance})},destroy(){window.removeEventListener(`message`,a)}}}function b(e){if(typeof e==`string`){let t=document.querySelector(e);if(!(t instanceof HTMLElement))throw Error(`[amos-js] Container "${e}" did not match any HTMLElement.`);return t}return e}var x={width:`calc(100% + 8px)`,transition:`opacity 150ms ease-in, height 200ms ease-in-out`,margin:`0 -4px`,opacity:`0`,border:`0`};function S({src:e,title:t,name:n,height:r,allow:i}){let a=document.createElement(`iframe`);return a.src=e,a.title=t,a.name=n,a.setAttribute(`role`,`presentation`),a.scrolling=`no`,i&&(a.allow=i),Object.assign(a.style,x,{height:r}),a}function C(e,t){let n=b(e),{renderToken:r,additionalFields:i={cardholderName:!1},...a}=t,o=S({src:h(r,i),title:`Secure credit card payment method form powered by Amos`,name:`amos-credit-card-payment-method-form`,height:_(i)});n.appendChild(o);let s=y(o,{...a,onHeightChange:e=>{o.style.height=e,a.onHeightChange?.(e)},onAppearanceReady:()=>{o.style.opacity=`1`,a.onAppearanceReady?.()}});return{iframe:o,update:s.update,destroy(){s.destroy(),o.remove()}}}function w(e,t){let n=b(e),{renderToken:r,...i}=t,a=S({src:g(r),title:`Secure bank account payment method form powered by Amos`,name:`amos-bank-account-payment-method-form`,height:v()});n.appendChild(a);let o=y(a,{...i,onHeightChange:e=>{a.style.height=e,i.onHeightChange?.(e)},onAppearanceReady:()=>{a.style.opacity=`1`,i.onAppearanceReady?.()}});return{iframe:a,update:o.update,destroy(){o.destroy(),a.remove()}}}function T(e,t){let n=b(e),{renderToken:r,...i}=t,a=S({src:d(r),title:`Secure Google Pay button powered by Amos`,name:`amos-google-pay-button`,height:f(),allow:`payment`});n.appendChild(a);let o=p(a,{...i,onHeightChange:e=>{a.style.height=e,i.onHeightChange?.(e)},onAppearanceReady:()=>{a.style.opacity=`1`,i.onAppearanceReady?.()}});return{iframe:a,update:o.update,destroy(){o.destroy(),a.remove()}}}exports.attachGooglePayButtonListeners=p,exports.attachPaymentMethodFormListeners=y,exports.confirmPaymentIntent=c,exports.confirmSetupIntent=l,exports.createMessage=n,exports.decodeJwt=e,exports.formatGooglePayPaymentData=m,exports.getBankAccountFormInitialHeight=v,exports.getBankAccountFormSrc=g,exports.getCreditCardFormInitialHeight=_,exports.getCreditCardFormSrc=h,exports.getEmbedOrigin=t,exports.getGooglePayButtonInitialHeight=f,exports.getGooglePayButtonSrc=d,exports.mountAmosBankAccountPaymentMethodForm=w,exports.mountAmosCreditCardPaymentMethodForm=C,exports.mountAmosGooglePayButton=T,exports.sendConfirmationFailed=u,exports.sendParentReadyMessage=r,exports.updateAmount=a,exports.updateAppearance=i,exports.updateMerchantName=o,exports.validateForm=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){let[t=``,n=``,r=``]=e?.split(`.`)??[],i=typeof atob==`function`?atob:e=>Buffer.from(e,`base64`).toString(`utf8`);return{header:JSON.parse(i(t)),payload:JSON.parse(i(n)),signature:r}}function t(t){let{env:n=`sandbox`}=e(t).payload;switch(n){case`production`:return`https://embed.amos.com`;case`sandbox`:return`https://embed-sandbox.amos.com`;default:return`https://embed-sandbox.amos.com`}}function n(e){return e}function r(e){e?.contentWindow?.postMessage(n({type:`PARENT_ACKNOWLEDGED_IFRAME_READY`}),`*`)}function i({iframe:e,appearance:t={}}){e?.contentWindow?.postMessage(n({type:`UPDATE_APPEARANCE`,appearance:t}),`*`)}function a({iframe:e,amount:t}){e?.contentWindow?.postMessage(n({type:`UPDATE_AMOUNT`,amount:t}),`*`)}function o({iframe:e,merchantName:t}){e?.contentWindow?.postMessage(n({type:`UPDATE_MERCHANT_NAME`,merchantName:t}),`*`)}function s({iframe:e}){let t=crypto.randomUUID();return new Promise(r=>{e?.contentWindow?.postMessage(n({type:`VALIDATE_FORM`,requestId:t}),`*`);let i=setTimeout(()=>{window.removeEventListener(`message`,a),r(!1)},5e3);function a(e){e.data.type===`VALIDATE_FORM`&&e.data.requestId===t&&(window.removeEventListener(`message`,a),clearTimeout(i),r(e.data.isValid??!1))}window.addEventListener(`message`,a)})}function c({iframe:t,token:r}){let{payment_intent_id:i}=e(r).payload;t?.contentWindow?.postMessage(n({type:`CONFIRM_PAYMENT_INTENT`,token:r,id:i??void 0}),`*`)}function l({iframe:t,token:r}){let{setup_intent_id:i}=e(r).payload;t?.contentWindow?.postMessage(n({type:`CONFIRM_SETUP_INTENT`,token:r,id:i??void 0}),`*`)}function u({iframe:e,errorMessage:t}){e?.contentWindow?.postMessage(n({type:`CONFIRMATION_FAILED`,errorMessage:t}),`*`)}function d(e){return`${t(e)}/iframe/google-pay?token=${e}`}function f(){return`40px`}function p(e,t){let n={...t};function s(){a({iframe:e,amount:n.amount})}function l(){o({iframe:e,merchantName:n.merchantName})}function d(t){switch(t.data.type){case`IFRAME_READY`:r(e),i({iframe:e,appearance:n.appearance}),s(),l();break;case`UPDATE_HEIGHT`:n.onHeightChange?.(t.data.height);break;case`UPDATE_APPEARANCE`:i({iframe:e,appearance:t.data.appearance});break;case`UPDATED_APPEARANCE`:n.onAppearanceReady?.();break;case`CREATE_PAYMENT_INTENT`:n.onInitiatePaymentIntentRequest({paymentIntentCreateAttributes:t.data.paymentIntentCreateAttributes,customerCreateAttributes:t.data.customerCreateAttributes}).then(t=>{c({iframe:e,token:t})}).catch(t=>{u({iframe:e,errorMessage:t instanceof Error?t.message:`Unknown error`})});break;case`PAYMENT_INTENT_CONFIRMATION_SUCCEEDED`:n.onPaymentIntentConfirmationSucceeded(t.data.paymentIntent);break;case`CONFIRMATION_FAILED`:n.onConfirmationFailed(t.data.errorMessage);break}}return window.addEventListener(`message`,d),{update(t){let r=`appearance`in t,a=`amount`in t,o=`merchantName`in t;n={...n,...t},r&&i({iframe:e,appearance:n.appearance}),a&&s(),o&&l()},destroy(){window.removeEventListener(`message`,d)}}}function m({paymentData:e}){return{paymentMethod:{type:`googlepay`,billing_address_attributes:{name:e.shippingAddress?.name,address_line1:e.shippingAddress?.address1,address_line2:e.shippingAddress?.address2,city:e.shippingAddress?.locality,state:e.shippingAddress?.administrativeArea,postal_code:e.shippingAddress?.postalCode,country:e.shippingAddress?.countryCode,email:e.email,phone:e.shippingAddress?.phoneNumber},card_profile_attributes:{wallet_provider:`googlepay`,wallet_payload:e.paymentMethodData.tokenizationData.token,wallet_last4:e.paymentMethodData.info?.cardDetails,wallet_brand:(()=>{switch(e.paymentMethodData.info?.cardNetwork){case`AMEX`:return`american_express`;case`VISA`:return`visa`;case`MASTERCARD`:return`master`;case`DISCOVER`:return`discover`;default:return}})()}}}}var h={postalCode:212,postalCodeAndCountry:212,full:452},g=80,_={postalCode:400,postalCodeAndCountry:400,full:640};function v(e,n={cardholderName:!1},r=`postalCode`){let i=Object.entries(n).filter(([,e])=>e).map(([e])=>e).join(`,`),a=new URLSearchParams({token:e,additionalFields:i,billingAddressRequirement:r});return`${t(e)}/iframe/card?${a}`}function y(e,n=`postalCode`){let r=new URLSearchParams({token:e,billingAddressRequirement:n});return`${t(e)}/iframe/bank?${r}`}function b(e={cardholderName:!1},t=`postalCode`){return`${(h[t]??h.postalCode)+(e.cardholderName?g:0)}px`}function x(e=`postalCode`){return`${_[e]??_.postalCode}px`}function S(e,t){let n={...t};function a(t){switch(t.data.type){case`IFRAME_READY`:r(e),i({iframe:e,appearance:n.appearance});break;case`UPDATE_HEIGHT`:n.onHeightChange?.(t.data.height);break;case`UPDATE_APPEARANCE`:i({iframe:e,appearance:t.data.appearance});break;case`UPDATED_APPEARANCE`:n.onAppearanceReady?.();break;case`PAYMENT_INTENT_CONFIRMATION_SUCCEEDED`:n.onPaymentIntentConfirmationSucceeded?.(t.data.paymentIntent);break;case`SETUP_INTENT_CONFIRMATION_SUCCEEDED`:n.onSetupIntentConfirmationSucceeded?.(t.data.setupIntent);break;case`CONFIRMATION_FAILED`:n.onConfirmationFailed(t.data.errorMessage);break}}return window.addEventListener(`message`,a),{update(t){let r=`appearance`in t;n={...n,...t},r&&i({iframe:e,appearance:n.appearance})},destroy(){window.removeEventListener(`message`,a)}}}function C(e){if(typeof e==`string`){let t=document.querySelector(e);if(!(t instanceof HTMLElement))throw Error(`[amos-js] Container "${e}" did not match any HTMLElement.`);return t}return e}var w={width:`calc(100% + 8px)`,transition:`opacity 150ms ease-in, height 200ms ease-in-out`,margin:`0 -4px`,opacity:`0`,border:`0`};function T({src:e,title:t,name:n,height:r,allow:i}){let a=document.createElement(`iframe`);return a.src=e,a.title=t,a.name=n,a.setAttribute(`role`,`presentation`),a.scrolling=`no`,i&&(a.allow=i),Object.assign(a.style,w,{height:r}),a}function E(e,t){let n=C(e),{renderToken:r,additionalFields:i={cardholderName:!1},billingAddressRequirement:a=`postalCode`,...o}=t,s=T({src:v(r,i,a),title:`Secure credit card payment method form powered by Amos`,name:`amos-credit-card-payment-method-form`,height:b(i,a)});n.appendChild(s);let c=S(s,{...o,onHeightChange:e=>{s.style.height=e,o.onHeightChange?.(e)},onAppearanceReady:()=>{s.style.opacity=`1`,o.onAppearanceReady?.()}});return{iframe:s,update:c.update,destroy(){c.destroy(),s.remove()}}}function D(e,t){let n=C(e),{renderToken:r,billingAddressRequirement:i=`postalCode`,...a}=t,o=T({src:y(r,i),title:`Secure bank account payment method form powered by Amos`,name:`amos-bank-account-payment-method-form`,height:x(i)});n.appendChild(o);let s=S(o,{...a,onHeightChange:e=>{o.style.height=e,a.onHeightChange?.(e)},onAppearanceReady:()=>{o.style.opacity=`1`,a.onAppearanceReady?.()}});return{iframe:o,update:s.update,destroy(){s.destroy(),o.remove()}}}function O(e,t){let n=C(e),{renderToken:r,...i}=t,a=T({src:d(r),title:`Secure Google Pay button powered by Amos`,name:`amos-google-pay-button`,height:f(),allow:`payment`});n.appendChild(a);let o=p(a,{...i,onHeightChange:e=>{a.style.height=e,i.onHeightChange?.(e)},onAppearanceReady:()=>{a.style.opacity=`1`,i.onAppearanceReady?.()}});return{iframe:a,update:o.update,destroy(){o.destroy(),a.remove()}}}exports.attachGooglePayButtonListeners=p,exports.attachPaymentMethodFormListeners=S,exports.confirmPaymentIntent=c,exports.confirmSetupIntent=l,exports.createMessage=n,exports.decodeJwt=e,exports.formatGooglePayPaymentData=m,exports.getBankAccountFormInitialHeight=x,exports.getBankAccountFormSrc=y,exports.getCreditCardFormInitialHeight=b,exports.getCreditCardFormSrc=v,exports.getEmbedOrigin=t,exports.getGooglePayButtonInitialHeight=f,exports.getGooglePayButtonSrc=d,exports.mountAmosBankAccountPaymentMethodForm=D,exports.mountAmosCreditCardPaymentMethodForm=E,exports.mountAmosGooglePayButton=O,exports.sendConfirmationFailed=u,exports.sendParentReadyMessage=r,exports.updateAmount=a,exports.updateAppearance=i,exports.updateMerchantName=o,exports.validateForm=s;

package/dist/index.mjs

@@ -195,20 +195,37 @@ function m({ paymentData: e }) {
 }
 //#endregion
 //#region src/payment-method-form.ts
-function h(e, n = { cardholderName: !1 }) {
-	let r = Object.entries(n).filter(([, e]) => e).map(([e]) => e).join(",");
-	return `${t(e)}/iframe/card?token=${e}&additionalFields=${r}`;
+var h = {
+	postalCode: 212,
+	postalCodeAndCountry: 212,
+	full: 452
+}, g = 80, _ = {
+	postalCode: 400,
+	postalCodeAndCountry: 400,
+	full: 640
+};
+function v(e, n = { cardholderName: !1 }, r = "postalCode") {
+	let i = Object.entries(n).filter(([, e]) => e).map(([e]) => e).join(","), a = new URLSearchParams({
+		token: e,
+		additionalFields: i,
+		billingAddressRequirement: r
+	});
+	return `${t(e)}/iframe/card?${a}`;
 }
-function g(e) {
-	return `${t(e)}/iframe/bank?token=${e}`;
+function y(e, n = "postalCode") {
+	let r = new URLSearchParams({
+		token: e,
+		billingAddressRequirement: n
+	});
+	return `${t(e)}/iframe/bank?${r}`;
 }
-function _(e = { cardholderName: !1 }) {
-	return e.cardholderName ? "292px" : "212px";
+function b(e = { cardholderName: !1 }, t = "postalCode") {
+	return `${(h[t] ?? h.postalCode) + (e.cardholderName ? g : 0)}px`;
 }
-function v() {
-	return "400px";
+function x(e = "postalCode") {
+	return `${_[e] ?? _.postalCode}px`;
 }
-function y(e, t) {
+function S(e, t) {
 	let n = { ...t };
 	function a(t) {
 		switch (t.data.type) {
@@ -259,7 +276,7 @@ function y(e, t) {
 }
 //#endregion
 //#region src/mount.ts
-function b(e) {
+function C(e) {
 	if (typeof e == "string") {
 		let t = document.querySelector(e);
 		if (!(t instanceof HTMLElement)) throw Error(`[amos-js] Container "${e}" did not match any HTMLElement.`);
@@ -267,69 +284,69 @@ function b(e) {
 	}
 	return e;
 }
-var x = {
+var w = {
 	width: "calc(100% + 8px)",
 	transition: "opacity 150ms ease-in, height 200ms ease-in-out",
 	margin: "0 -4px",
 	opacity: "0",
 	border: "0"
 };
-function S({ src: e, title: t, name: n, height: r, allow: i }) {
+function T({ src: e, title: t, name: n, height: r, allow: i }) {
 	let a = document.createElement("iframe");
-	return a.src = e, a.title = t, a.name = n, a.setAttribute("role", "presentation"), a.scrolling = "no", i && (a.allow = i), Object.assign(a.style, x, { height: r }), a;
+	return a.src = e, a.title = t, a.name = n, a.setAttribute("role", "presentation"), a.scrolling = "no", i && (a.allow = i), Object.assign(a.style, w, { height: r }), a;
 }
-function C(e, t) {
-	let n = b(e), { renderToken: r, additionalFields: i = { cardholderName: !1 }, ...a } = t, o = S({
-		src: h(r, i),
+function E(e, t) {
+	let n = C(e), { renderToken: r, additionalFields: i = { cardholderName: !1 }, billingAddressRequirement: a = "postalCode", ...o } = t, s = T({
+		src: v(r, i, a),
 		title: "Secure credit card payment method form powered by Amos",
 		name: "amos-credit-card-payment-method-form",
-		height: _(i)
+		height: b(i, a)
 	});
-	n.appendChild(o);
-	let s = y(o, {
-		...a,
+	n.appendChild(s);
+	let c = S(s, {
+		...o,
 		onHeightChange: (e) => {
-			o.style.height = e, a.onHeightChange?.(e);
+			s.style.height = e, o.onHeightChange?.(e);
 		},
 		onAppearanceReady: () => {
-			o.style.opacity = "1", a.onAppearanceReady?.();
+			s.style.opacity = "1", o.onAppearanceReady?.();
 		}
 	});
 	return {
-		iframe: o,
-		update: s.update,
+		iframe: s,
+		update: c.update,
 		destroy() {
-			s.destroy(), o.remove();
+			c.destroy(), s.remove();
 		}
 	};
 }
-function w(e, t) {
-	let n = b(e), { renderToken: r, ...i } = t, a = S({
-		src: g(r),
+function D(e, t) {
+	let n = C(e), { renderToken: r, billingAddressRequirement: i = "postalCode", ...a } = t, o = T({
+		src: y(r, i),
 		title: "Secure bank account payment method form powered by Amos",
 		name: "amos-bank-account-payment-method-form",
-		height: v()
+		height: x(i)
 	});
-	n.appendChild(a);
-	let o = y(a, {
-		...i,
+	n.appendChild(o);
+	let s = S(o, {
+		...a,
 		onHeightChange: (e) => {
-			a.style.height = e, i.onHeightChange?.(e);
+			o.style.height = e, a.onHeightChange?.(e);
 		},
 		onAppearanceReady: () => {
-			a.style.opacity = "1", i.onAppearanceReady?.();
+			o.style.opacity = "1", a.onAppearanceReady?.();
 		}
 	});
 	return {
-		iframe: a,
-		update: o.update,
+		iframe: o,
+		update: s.update,
 		destroy() {
-			o.destroy(), a.remove();
+			s.destroy(), o.remove();
 		}
 	};
 }
-function T(e, t) {
-	let n = b(e), { renderToken: r, ...i } = t, a = S({
+function O(e, t) {
+	let n = C(e), { renderToken: r, ...i } = t, a = T({
 		src: d(r),
 		title: "Secure Google Pay button powered by Amos",
 		name: "amos-google-pay-button",
@@ -355,4 +372,4 @@ function T(e, t) {
 	};
 }
 //#endregion
-export { p as attachGooglePayButtonListeners, y as attachPaymentMethodFormListeners, c as confirmPaymentIntent, l as confirmSetupIntent, n as createMessage, e as decodeJwt, m as formatGooglePayPaymentData, v as getBankAccountFormInitialHeight, g as getBankAccountFormSrc, _ as getCreditCardFormInitialHeight, h as getCreditCardFormSrc, t as getEmbedOrigin, f as getGooglePayButtonInitialHeight, d as getGooglePayButtonSrc, w as mountAmosBankAccountPaymentMethodForm, C as mountAmosCreditCardPaymentMethodForm, T as mountAmosGooglePayButton, u as sendConfirmationFailed, r as sendParentReadyMessage, a as updateAmount, i as updateAppearance, o as updateMerchantName, s as validateForm };
+export { p as attachGooglePayButtonListeners, S as attachPaymentMethodFormListeners, c as confirmPaymentIntent, l as confirmSetupIntent, n as createMessage, e as decodeJwt, m as formatGooglePayPaymentData, x as getBankAccountFormInitialHeight, y as getBankAccountFormSrc, b as getCreditCardFormInitialHeight, v as getCreditCardFormSrc, t as getEmbedOrigin, f as getGooglePayButtonInitialHeight, d as getGooglePayButtonSrc, D as mountAmosBankAccountPaymentMethodForm, E as mountAmosCreditCardPaymentMethodForm, O as mountAmosGooglePayButton, u as sendConfirmationFailed, r as sendParentReadyMessage, a as updateAmount, i as updateAppearance, o as updateMerchantName, s as validateForm };

package/dist/mount.d.ts

@@ -1,5 +1,5 @@
 import { GooglePayButtonController, GooglePayButtonListenerOptions } from './google-pay';
-import { CreditCardAdditionalFields, PaymentMethodFormController, PaymentMethodFormListenerOptions } from './payment-method-form';
+import { BillingAddressRequirement, CreditCardAdditionalFields, PaymentMethodFormController, PaymentMethodFormListenerOptions } from './payment-method-form';
 type Container = HTMLElement | string;
 /**
  * Options accepted by {@link mountAmosCreditCardPaymentMethodForm}.
@@ -14,12 +14,18 @@ export type AmosCreditCardPaymentMethodFormOptions = PaymentMethodFormListenerOp
     renderToken: string;
     /**
      * The additional fields that are required to be filled out in the
-     * form in addition to the card number, expiration date, CVV,
-     * country, and postal code.
+     * form in addition to the card number, expiration date, CVV, and
+     * billing address fields.
      *
      * @default { cardholderName: false }
      */
     additionalFields?: CreditCardAdditionalFields;
+    /**
+     * How much billing address the form collects.
+     *
+     * @default "postalCode"
+     */
+    billingAddressRequirement?: BillingAddressRequirement;
 };
 /**
  * Controller returned by {@link mountAmosCreditCardPaymentMethodForm}
@@ -54,6 +60,12 @@ export type AmosBankAccountPaymentMethodFormOptions = PaymentMethodFormListenerO
      * https://dashboard.amos.com.
      */
     renderToken: string;
+    /**
+     * How much billing address the form collects.
+     *
+     * @default "postalCode"
+     */
+    billingAddressRequirement?: BillingAddressRequirement;
 };
 /**
  * Mount the secure bank-account payment method form into a container

package/dist/payment-method-form.d.ts

@@ -2,29 +2,41 @@ import { components } from '@amos.com/node';
 import { Appearance } from './types';
 /**
  * The additional fields beyond the standard card number, expiration
- * date, CVV, country, and postal code that are required to be filled
+ * date, CVV, and billing address fields that are required to be filled
  * out in the embedded credit-card form.
  */
 export type CreditCardAdditionalFields = {
     cardholderName: boolean;
 };
+/**
+ * How much billing address the embedded credit-card or bank-account form
+ * collects.
+ *
+ * - `postalCode` — ZIP / postal code only (default). No country is collected
+ *   or sent on confirm.
+ * - `postalCodeAndCountry` — country and postal code, both required.
+ * - `full` — full street address (Smarty autocomplete on line 1).
+ */
+export type BillingAddressRequirement = "postalCode" | "postalCodeAndCountry" | "full";
 /**
  * Build the iframe `src` URL for the embedded credit-card form.
  */
-export declare function getCreditCardFormSrc(renderToken: string, additionalFields?: CreditCardAdditionalFields): string;
+export declare function getCreditCardFormSrc(renderToken: string, additionalFields?: CreditCardAdditionalFields, billingAddressRequirement?: BillingAddressRequirement): string;
 /**
  * Build the iframe `src` URL for the embedded bank-account form.
  */
-export declare function getBankAccountFormSrc(renderToken: string): string;
+export declare function getBankAccountFormSrc(renderToken: string, billingAddressRequirement?: BillingAddressRequirement): string;
 /**
  * Default iframe pixel height for the credit-card form, taking the
- * configured `additionalFields` into account.
+ * configured `additionalFields` and `billingAddressRequirement` into
+ * account.
  */
-export declare function getCreditCardFormInitialHeight(additionalFields?: CreditCardAdditionalFields): string;
+export declare function getCreditCardFormInitialHeight(additionalFields?: CreditCardAdditionalFields, billingAddressRequirement?: BillingAddressRequirement): string;
 /**
- * Default iframe pixel height for the bank-account form.
+ * Default iframe pixel height for the bank-account form, taking
+ * `billingAddressRequirement` into account.
  */
-export declare function getBankAccountFormInitialHeight(): string;
+export declare function getBankAccountFormInitialHeight(billingAddressRequirement?: BillingAddressRequirement): string;
 /**
  * Options accepted by {@link attachPaymentMethodFormListeners}.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amos.com/amos-js",
-  "version": "0.3.24",
+  "version": "0.4.0",
   "main": "dist/index.js",
   "repository": {
     "type": "git",

package/src/index.ts

@@ -37,6 +37,7 @@ export {
   mountAmosGooglePayButton,
 } from "./mount";
 export type {
+  BillingAddressRequirement,
   CreditCardAdditionalFields,
   PaymentMethodFormController,
   PaymentMethodFormListenerOptions,

package/src/mount.ts

@@ -7,6 +7,7 @@ import {
 } from "./google-pay";
 import {
   attachPaymentMethodFormListeners,
+  type BillingAddressRequirement,
   type CreditCardAdditionalFields,
   getBankAccountFormInitialHeight,
   getBankAccountFormSrc,
@@ -79,12 +80,18 @@ export type AmosCreditCardPaymentMethodFormOptions =
     renderToken: string;
     /**
      * The additional fields that are required to be filled out in the
-     * form in addition to the card number, expiration date, CVV,
-     * country, and postal code.
+     * form in addition to the card number, expiration date, CVV, and
+     * billing address fields.
      *
      * @default { cardholderName: false }
      */
     additionalFields?: CreditCardAdditionalFields;
+    /**
+     * How much billing address the form collects.
+     *
+     * @default "postalCode"
+     */
+    billingAddressRequirement?: BillingAddressRequirement;
   };
 
 /**
@@ -118,14 +125,22 @@ export function mountAmosCreditCardPaymentMethodForm(
   const {
     renderToken,
     additionalFields = { cardholderName: false },
+    billingAddressRequirement = "postalCode",
     ...listenerOptions
   } = options;
 
   const iframe = createIframe({
-    src: getCreditCardFormSrc(renderToken, additionalFields),
+    src: getCreditCardFormSrc(
+      renderToken,
+      additionalFields,
+      billingAddressRequirement,
+    ),
     title: "Secure credit card payment method form powered by Amos",
     name: "amos-credit-card-payment-method-form",
-    height: getCreditCardFormInitialHeight(additionalFields),
+    height: getCreditCardFormInitialHeight(
+      additionalFields,
+      billingAddressRequirement,
+    ),
   });
   host.appendChild(iframe);
 
@@ -163,6 +178,12 @@ export type AmosBankAccountPaymentMethodFormOptions =
      * https://dashboard.amos.com.
      */
     renderToken: string;
+    /**
+     * How much billing address the form collects.
+     *
+     * @default "postalCode"
+     */
+    billingAddressRequirement?: BillingAddressRequirement;
   };
 
 /**
@@ -179,13 +200,17 @@ export function mountAmosBankAccountPaymentMethodForm(
   options: AmosBankAccountPaymentMethodFormOptions,
 ): AmosPaymentMethodFormMountController {
   const host = resolveContainer(container);
-  const { renderToken, ...listenerOptions } = options;
+  const {
+    renderToken,
+    billingAddressRequirement = "postalCode",
+    ...listenerOptions
+  } = options;
 
   const iframe = createIframe({
-    src: getBankAccountFormSrc(renderToken),
+    src: getBankAccountFormSrc(renderToken, billingAddressRequirement),
     title: "Secure bank account payment method form powered by Amos",
     name: "amos-bank-account-payment-method-form",
-    height: getBankAccountFormInitialHeight(),
+    height: getBankAccountFormInitialHeight(billingAddressRequirement),
   });
   host.appendChild(iframe);
 

package/src/payment-method-form.ts

@@ -8,50 +8,105 @@ import type { Appearance, Message } from "./types";
 
 /**
  * The additional fields beyond the standard card number, expiration
- * date, CVV, country, and postal code that are required to be filled
+ * date, CVV, and billing address fields that are required to be filled
  * out in the embedded credit-card form.
  */
 export type CreditCardAdditionalFields = {
   cardholderName: boolean;
 };
 
+/**
+ * How much billing address the embedded credit-card or bank-account form
+ * collects.
+ *
+ * - `postalCode` — ZIP / postal code only (default). No country is collected
+ *   or sent on confirm.
+ * - `postalCodeAndCountry` — country and postal code, both required.
+ * - `full` — full street address (Smarty autocomplete on line 1).
+ */
+export type BillingAddressRequirement =
+  | "postalCode"
+  | "postalCodeAndCountry"
+  | "full";
+
+const CREDIT_CARD_ADDRESS_HEIGHT_PX: Record<BillingAddressRequirement, number> =
+  {
+    postalCode: 212,
+    postalCodeAndCountry: 212,
+    full: 452,
+  };
+
+const CREDIT_CARD_CARDHOLDER_NAME_HEIGHT_PX = 80;
+
+const BANK_ACCOUNT_HEIGHT_PX: Record<BillingAddressRequirement, number> = {
+  postalCode: 400,
+  postalCodeAndCountry: 400,
+  full: 640,
+};
+
 /**
  * Build the iframe `src` URL for the embedded credit-card form.
  */
 export function getCreditCardFormSrc(
   renderToken: string,
   additionalFields: CreditCardAdditionalFields = { cardholderName: false },
+  billingAddressRequirement: BillingAddressRequirement = "postalCode",
 ): string {
   const enabled = Object.entries(additionalFields)
     .filter(([, value]) => value)
     .map(([key]) => key)
     .join(",");
 
-  return `${getEmbedOrigin(renderToken)}/iframe/card?token=${renderToken}&additionalFields=${enabled}`;
+  const params = new URLSearchParams({
+    token: renderToken,
+    additionalFields: enabled,
+    billingAddressRequirement,
+  });
+
+  return `${getEmbedOrigin(renderToken)}/iframe/card?${params}`;
 }
 
 /**
  * Build the iframe `src` URL for the embedded bank-account form.
  */
-export function getBankAccountFormSrc(renderToken: string): string {
-  return `${getEmbedOrigin(renderToken)}/iframe/bank?token=${renderToken}`;
+export function getBankAccountFormSrc(
+  renderToken: string,
+  billingAddressRequirement: BillingAddressRequirement = "postalCode",
+): string {
+  const params = new URLSearchParams({
+    token: renderToken,
+    billingAddressRequirement,
+  });
+
+  return `${getEmbedOrigin(renderToken)}/iframe/bank?${params}`;
 }
 
 /**
  * Default iframe pixel height for the credit-card form, taking the
- * configured `additionalFields` into account.
+ * configured `additionalFields` and `billingAddressRequirement` into
+ * account.
  */
 export function getCreditCardFormInitialHeight(
   additionalFields: CreditCardAdditionalFields = { cardholderName: false },
+  billingAddressRequirement: BillingAddressRequirement = "postalCode",
 ): string {
-  return additionalFields.cardholderName ? "292px" : "212px";
+  const addressHeight =
+    CREDIT_CARD_ADDRESS_HEIGHT_PX[billingAddressRequirement] ??
+    CREDIT_CARD_ADDRESS_HEIGHT_PX.postalCode;
+  const cardholderExtra = additionalFields.cardholderName
+    ? CREDIT_CARD_CARDHOLDER_NAME_HEIGHT_PX
+    : 0;
+  return `${addressHeight + cardholderExtra}px`;
 }
 
 /**
- * Default iframe pixel height for the bank-account form.
+ * Default iframe pixel height for the bank-account form, taking
+ * `billingAddressRequirement` into account.
  */
-export function getBankAccountFormInitialHeight(): string {
-  return "400px";
+export function getBankAccountFormInitialHeight(
+  billingAddressRequirement: BillingAddressRequirement = "postalCode",
+): string {
+  return `${BANK_ACCOUNT_HEIGHT_PX[billingAddressRequirement] ?? BANK_ACCOUNT_HEIGHT_PX.postalCode}px`;
 }
 
 /**