@guestyorg/tokenization-js 1.1.0 → 1.2.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Guesty Inc.
+Copyright (c) 2026 Guesty Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -8,7 +8,7 @@ Add a script tag to your application `head` or `body`.
 This loads `guestyTokenization` object to the global `window` scope of the browser
 
 ```html
-<script src="https://pay.guesty.com/tokenization/v1/init.js"></script>
+<script src="https://pay.guesty.com/tokenization/v3/init.js"></script>
 ```
 
 ### Use it as an ES module
@@ -41,17 +41,17 @@ Import the `loadScript` function for asynchronously loading the Guesty Tokenizat
 #### options
 
 - `sandbox` - load the SDK in a sandbox mode
-- `version` - SDK version to load (default: `v1`)
+- `version` - SDK version to load (default: `v1`). Supported values: `v1`, `v2`, `v3`
 
 ```js
-loadScript({ sandbox: true });
+loadScript({ sandbox: true, version: 'v3' });
 ```
 
 This is equivalent to the following script:
 
 ```html
 <script
-  src="https://pay.guesty.com/tokenization/v1/init.js"
+  src="https://pay.guesty.com/tokenization/v3/init.js"
   data-env="sandbox"
 ></script>
 ```
@@ -62,7 +62,7 @@ This is equivalent to the following script:
 import { loadScript } from '@guestyorg/tokenization-js';
 
 try {
-  const guestyTokenization = await loadScript();
+  const guestyTokenization = await loadScript({ version: 'v3' });
   // Guesty Tokenization JS SDK is loaded and ready to use
 } catch (error) {
   console.error('Failed to load the Guesty Tokenization JS SDK script', error);
@@ -74,7 +74,7 @@ try {
 ```js
 import { loadScript } from '@guestyorg/tokenization-js';
 
-loadScript()
+loadScript({ version: 'v3' })
   .then((guestyTokenization) => {
     // Guesty Tokenization JS SDK is loaded and ready to use
   })

package/lib/cjs/guesty-tokenization-js.js

@@ -1,7 +1,19 @@
 'use strict';
 
-var findScriptElement = function (url) {
-    return document.querySelector("script[src=\"".concat(url, "\"]"));
+var findScriptElement = function (url, sandbox) {
+    if (sandbox === void 0) { sandbox = false; }
+    var scripts = document.querySelectorAll("script[src=\"".concat(url, "\"]"));
+    for (var index = 0; index < scripts.length; index += 1) {
+        var script = scripts.item(index);
+        if (!script) {
+            continue;
+        }
+        var isSandboxScript = script.getAttribute('data-env') === 'sandbox';
+        if (isSandboxScript === sandbox) {
+            return script;
+        }
+    }
+    return null;
 };
 var injectScriptElement = function (_a) {
     var url = _a.url, sandbox = _a.sandbox, onSuccess = _a.onSuccess, onError = _a.onError;
@@ -18,35 +30,60 @@ var injectScriptElement = function (_a) {
 
 var NAMESPACE = 'guestyTokenization';
 
+var hasHandle3DSChallenge = function (namespace) {
+    return 'handle3DSChallenge' in namespace;
+};
+var namespaceMatchesVersion = function (namespace, version) {
+    if (!namespace || typeof namespace !== 'object') {
+        return false;
+    }
+    if (version === 'v3') {
+        return hasHandle3DSChallenge(namespace);
+    }
+    return !hasHandle3DSChallenge(namespace);
+};
+var clearMismatchedNamespace = function (version) {
+    var existingNamespace = window[NAMESPACE];
+    if (existingNamespace &&
+        !namespaceMatchesVersion(existingNamespace, version)) {
+        delete window[NAMESPACE];
+    }
+};
+
 var loadScript = function (options) {
-    var _a;
+    var _a, _b;
     if (options === void 0) { options = {}; }
     if (typeof window === 'undefined') {
         return Promise.resolve(null);
     }
     var version = (_a = options.version) !== null && _a !== void 0 ? _a : 'v1';
+    var sandbox = (_b = options.sandbox) !== null && _b !== void 0 ? _b : false;
     var scriptUrl = "https://pay.guesty.com/tokenization/".concat(version, "/init.js");
-    var existingScript = findScriptElement(scriptUrl);
+    var existingScript = findScriptElement(scriptUrl, sandbox);
     var existingNamespace = window[NAMESPACE];
+    if (existingScript &&
+        existingNamespace &&
+        namespaceMatchesVersion(existingNamespace, version)) {
+        return Promise.resolve(existingNamespace);
+    }
     if (existingScript) {
-        if (existingNamespace) {
-            return Promise.resolve(existingNamespace);
-        }
         existingScript.remove();
     }
+    clearMismatchedNamespace(version);
     return new Promise(function (resolve, reject) {
-        var _a;
         injectScriptElement({
             url: scriptUrl,
-            sandbox: (_a = options.sandbox) !== null && _a !== void 0 ? _a : false,
+            sandbox: sandbox,
             onSuccess: function () {
                 var newNamespace = window[NAMESPACE];
-                if (newNamespace) {
+                if (newNamespace && namespaceMatchesVersion(newNamespace, version)) {
                     resolve(newNamespace);
+                    return;
                 }
-                else {
-                    reject(new Error('Guesty Tokenization is not available'));
+                if (newNamespace) {
+                    delete window[NAMESPACE];
                 }
+                reject(new Error('Guesty Tokenization is not available'));
             },
             onError: function () {
                 reject(new Error("The script ".concat(scriptUrl, " failed to load")));

package/lib/cjs/guesty-tokenization-js.min.js

@@ -1 +1 @@
-"use strict";var o="guestyTokenization";exports.loadScript=function(n){var e;if(void 0===n&&(n={}),"undefined"==typeof window)return Promise.resolve(null);var r,t=null!==(e=n.version)&&void 0!==e?e:"v1",i="https://pay.guesty.com/tokenization/".concat(t,"/init.js"),s=(r=i,document.querySelector('script[src="'.concat(r,'"]'))),a=window[o];if(s){if(a)return Promise.resolve(a);s.remove()}return new Promise((function(e,r){var t;!function(o){var n=o.url,e=o.sandbox,r=o.onSuccess,t=o.onError,i=document.createElement("script");i.src=n,i.async=!0,i.onerror=t,i.onload=r,e&&i.setAttribute("data-env","sandbox"),document.head.insertBefore(i,document.head.firstElementChild)}({url:i,sandbox:null!==(t=n.sandbox)&&void 0!==t&&t,onSuccess:function(){var n=window[o];n?e(n):r(new Error("Guesty Tokenization is not available"))},onError:function(){r(new Error("The script ".concat(i," failed to load")))}})}))};
+"use strict";var n="guestyTokenization",e=function(n){return"handle3DSChallenge"in n},o=function(n,o){return!(!n||"object"!=typeof n)&&("v3"===o?e(n):!e(n))};exports.loadScript=function(e){var t,r;if(void 0===e&&(e={}),"undefined"==typeof window)return Promise.resolve(null);var i=null!==(t=e.version)&&void 0!==t?t:"v1",a=null!==(r=e.sandbox)&&void 0!==r&&r,c="https://pay.guesty.com/tokenization/".concat(i,"/init.js"),u=function(n,e){void 0===e&&(e=!1);for(var o=document.querySelectorAll('script[src="'.concat(n,'"]')),t=0;t<o.length;t+=1){var r=o.item(t);if(r&&"sandbox"===r.getAttribute("data-env")===e)return r}return null}(c,a),d=window[n];return u&&d&&o(d,i)?Promise.resolve(d):(u&&u.remove(),function(e){var t=window[n];t&&!o(t,e)&&delete window[n]}(i),new Promise((function(e,t){!function(n){var e=n.url,o=n.sandbox,t=n.onSuccess,r=n.onError,i=document.createElement("script");i.src=e,i.async=!0,i.onerror=r,i.onload=t,o&&i.setAttribute("data-env","sandbox"),document.head.insertBefore(i,document.head.firstElementChild)}({url:c,sandbox:a,onSuccess:function(){var r=window[n];r&&o(r,i)?e(r):(r&&delete window[n],t(new Error("Guesty Tokenization is not available")))},onError:function(){t(new Error("The script ".concat(c," failed to load")))}})})))};

package/lib/cjs/src/loadScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadScript.d.ts","sourceRoot":"","sources":["../../src/loadScript.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,UAAU,aAAa,iBAAiB,qBAmCpD,CAAC"}
+{"version":3,"file":"loadScript.d.ts","sourceRoot":"","sources":["../../src/loadScript.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,UAAU,aAAa,iBAAiB,qBAiDpD,CAAC"}

package/lib/cjs/src/namespaceVersion.d.ts

@@ -0,0 +1,5 @@
+type TokenizationVersion = 'v1' | 'v2' | 'v3';
+export declare const namespaceMatchesVersion: (namespace: unknown, version: TokenizationVersion) => boolean;
+export declare const clearMismatchedNamespace: (version: TokenizationVersion) => void;
+export {};
+//# sourceMappingURL=namespaceVersion.d.ts.map

package/lib/cjs/src/namespaceVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaceVersion.d.ts","sourceRoot":"","sources":["../../src/namespaceVersion.ts"],"names":[],"mappings":"AAEA,KAAK,mBAAmB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAK9C,eAAO,MAAM,uBAAuB,cACvB,OAAO,WACT,mBAAmB,KAC3B,OAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,mBAAmB,SASpE,CAAC"}

package/lib/cjs/src/utils.d.ts

@@ -1,4 +1,4 @@
-export declare const findScriptElement: (url: string) => Element | null;
+export declare const findScriptElement: (url: string, sandbox?: boolean) => Element | null;
 export interface InjectScriptElementOptions {
     url: string;
     sandbox: boolean;

package/lib/cjs/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAAS,MAAM,mBAE5C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,0CAK7B,0BAA0B,SAY5B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAAS,MAAM,sCAkB5C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,0CAK7B,0BAA0B,SAY5B,CAAC"}

package/lib/esm/guesty-tokenization-js.js

@@ -1,5 +1,17 @@
-var findScriptElement = function (url) {
-    return document.querySelector("script[src=\"".concat(url, "\"]"));
+var findScriptElement = function (url, sandbox) {
+    if (sandbox === void 0) { sandbox = false; }
+    var scripts = document.querySelectorAll("script[src=\"".concat(url, "\"]"));
+    for (var index = 0; index < scripts.length; index += 1) {
+        var script = scripts.item(index);
+        if (!script) {
+            continue;
+        }
+        var isSandboxScript = script.getAttribute('data-env') === 'sandbox';
+        if (isSandboxScript === sandbox) {
+            return script;
+        }
+    }
+    return null;
 };
 var injectScriptElement = function (_a) {
     var url = _a.url, sandbox = _a.sandbox, onSuccess = _a.onSuccess, onError = _a.onError;
@@ -16,35 +28,60 @@ var injectScriptElement = function (_a) {
 
 var NAMESPACE = 'guestyTokenization';
 
+var hasHandle3DSChallenge = function (namespace) {
+    return 'handle3DSChallenge' in namespace;
+};
+var namespaceMatchesVersion = function (namespace, version) {
+    if (!namespace || typeof namespace !== 'object') {
+        return false;
+    }
+    if (version === 'v3') {
+        return hasHandle3DSChallenge(namespace);
+    }
+    return !hasHandle3DSChallenge(namespace);
+};
+var clearMismatchedNamespace = function (version) {
+    var existingNamespace = window[NAMESPACE];
+    if (existingNamespace &&
+        !namespaceMatchesVersion(existingNamespace, version)) {
+        delete window[NAMESPACE];
+    }
+};
+
 var loadScript = function (options) {
-    var _a;
+    var _a, _b;
     if (options === void 0) { options = {}; }
     if (typeof window === 'undefined') {
         return Promise.resolve(null);
     }
     var version = (_a = options.version) !== null && _a !== void 0 ? _a : 'v1';
+    var sandbox = (_b = options.sandbox) !== null && _b !== void 0 ? _b : false;
     var scriptUrl = "https://pay.guesty.com/tokenization/".concat(version, "/init.js");
-    var existingScript = findScriptElement(scriptUrl);
+    var existingScript = findScriptElement(scriptUrl, sandbox);
     var existingNamespace = window[NAMESPACE];
+    if (existingScript &&
+        existingNamespace &&
+        namespaceMatchesVersion(existingNamespace, version)) {
+        return Promise.resolve(existingNamespace);
+    }
     if (existingScript) {
-        if (existingNamespace) {
-            return Promise.resolve(existingNamespace);
-        }
         existingScript.remove();
     }
+    clearMismatchedNamespace(version);
     return new Promise(function (resolve, reject) {
-        var _a;
         injectScriptElement({
             url: scriptUrl,
-            sandbox: (_a = options.sandbox) !== null && _a !== void 0 ? _a : false,
+            sandbox: sandbox,
             onSuccess: function () {
                 var newNamespace = window[NAMESPACE];
-                if (newNamespace) {
+                if (newNamespace && namespaceMatchesVersion(newNamespace, version)) {
                     resolve(newNamespace);
+                    return;
                 }
-                else {
-                    reject(new Error('Guesty Tokenization is not available'));
+                if (newNamespace) {
+                    delete window[NAMESPACE];
                 }
+                reject(new Error('Guesty Tokenization is not available'));
             },
             onError: function () {
                 reject(new Error("The script ".concat(scriptUrl, " failed to load")));

package/lib/esm/guesty-tokenization-js.min.js

@@ -1 +1 @@
-var n="guestyTokenization",o=function(o){var e;if(void 0===o&&(o={}),"undefined"==typeof window)return Promise.resolve(null);var r,t=null!==(e=o.version)&&void 0!==e?e:"v1",i="https://pay.guesty.com/tokenization/".concat(t,"/init.js"),a=(r=i,document.querySelector('script[src="'.concat(r,'"]'))),s=window[n];if(a){if(s)return Promise.resolve(s);a.remove()}return new Promise((function(e,r){var t;!function(n){var o=n.url,e=n.sandbox,r=n.onSuccess,t=n.onError,i=document.createElement("script");i.src=o,i.async=!0,i.onerror=t,i.onload=r,e&&i.setAttribute("data-env","sandbox"),document.head.insertBefore(i,document.head.firstElementChild)}({url:i,sandbox:null!==(t=o.sandbox)&&void 0!==t&&t,onSuccess:function(){var o=window[n];o?e(o):r(new Error("Guesty Tokenization is not available"))},onError:function(){r(new Error("The script ".concat(i," failed to load")))}})}))};export{o as loadScript};
+var n="guestyTokenization",e=function(n){return"handle3DSChallenge"in n},o=function(n,o){return!(!n||"object"!=typeof n)&&("v3"===o?e(n):!e(n))},t=function(e){var t,r;if(void 0===e&&(e={}),"undefined"==typeof window)return Promise.resolve(null);var i=null!==(t=e.version)&&void 0!==t?t:"v1",a=null!==(r=e.sandbox)&&void 0!==r&&r,u="https://pay.guesty.com/tokenization/".concat(i,"/init.js"),c=function(n,e){void 0===e&&(e=!1);for(var o=document.querySelectorAll('script[src="'.concat(n,'"]')),t=0;t<o.length;t+=1){var r=o.item(t);if(r&&"sandbox"===r.getAttribute("data-env")===e)return r}return null}(u,a),d=window[n];return c&&d&&o(d,i)?Promise.resolve(d):(c&&c.remove(),function(e){var t=window[n];t&&!o(t,e)&&delete window[n]}(i),new Promise((function(e,t){!function(n){var e=n.url,o=n.sandbox,t=n.onSuccess,r=n.onError,i=document.createElement("script");i.src=e,i.async=!0,i.onerror=r,i.onload=t,o&&i.setAttribute("data-env","sandbox"),document.head.insertBefore(i,document.head.firstElementChild)}({url:u,sandbox:a,onSuccess:function(){var r=window[n];r&&o(r,i)?e(r):(r&&delete window[n],t(new Error("Guesty Tokenization is not available")))},onError:function(){t(new Error("The script ".concat(u," failed to load")))}})})))};export{t as loadScript};

package/lib/esm/src/loadScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadScript.d.ts","sourceRoot":"","sources":["../../src/loadScript.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,UAAU,aAAa,iBAAiB,qBAmCpD,CAAC"}
+{"version":3,"file":"loadScript.d.ts","sourceRoot":"","sources":["../../src/loadScript.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,UAAU,aAAa,iBAAiB,qBAiDpD,CAAC"}

package/lib/esm/src/namespaceVersion.d.ts

@@ -0,0 +1,5 @@
+type TokenizationVersion = 'v1' | 'v2' | 'v3';
+export declare const namespaceMatchesVersion: (namespace: unknown, version: TokenizationVersion) => boolean;
+export declare const clearMismatchedNamespace: (version: TokenizationVersion) => void;
+export {};
+//# sourceMappingURL=namespaceVersion.d.ts.map

package/lib/esm/src/namespaceVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaceVersion.d.ts","sourceRoot":"","sources":["../../src/namespaceVersion.ts"],"names":[],"mappings":"AAEA,KAAK,mBAAmB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAK9C,eAAO,MAAM,uBAAuB,cACvB,OAAO,WACT,mBAAmB,KAC3B,OAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,mBAAmB,SASpE,CAAC"}

package/lib/esm/src/utils.d.ts

@@ -1,4 +1,4 @@
-export declare const findScriptElement: (url: string) => Element | null;
+export declare const findScriptElement: (url: string, sandbox?: boolean) => Element | null;
 export interface InjectScriptElementOptions {
     url: string;
     sandbox: boolean;

package/lib/esm/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAAS,MAAM,mBAE5C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,0CAK7B,0BAA0B,SAY5B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAAS,MAAM,sCAkB5C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,0CAK7B,0BAA0B,SAY5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guestyorg/tokenization-js",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Guesty Tokenization SDK loading utility and types",
   "main": "index.js",
   "module": "lib/esm/guesty-tokenization-js.js",

package/types/index.d.ts

@@ -20,15 +20,52 @@ export interface GuestyTokenizationStyles {
   borderRadius?: number;
 }
 
+export interface GuestyTokenizationV3Styles {
+  fontFamily?: string;
+  fontSizeBase?: number;
+  fontSizeMd?: number;
+  fontSizeLg?: number;
+  fontWeightRegular?: string | number;
+  fontWeightBold?: string | number;
+  borderRadius?: number;
+  inputHeight?: number;
+  inputPadding?: number;
+  colorText?: string;
+  colorTextError?: string;
+  colorPlaceholder?: string;
+  colorBorder?: string;
+  colorBorderFocus?: string;
+  colorFormBackground?: string;
+  colorInputBackground?: string;
+  // Explicitly unsupported in v3.
+  mobileBreakpoint?: never;
+  colorBorderError?: never;
+  colorBorderHover?: never;
+  colorBackground?: never;
+  colorBackgroundError?: never;
+  colorBackgroundDisabled?: never;
+}
+
 type Section = 'cardholderName' | 'paymentDetails' | 'billingAddress';
 type TCardholderNameInput = 'firstName' | 'lastName' | 'cardHolderId';
 type TBillingAddressInput = 'street' | 'city' | 'state' | 'zipCode' | 'country';
-type TPaymentDetailsInput = 'cardNumber' | 'expirationDate' | 'csc';
+type TPaymentDetailsInput =
+  | 'nameOnCard'
+  | 'cardNumber'
+  | 'expirationDate'
+  | 'csc';
+type TBankDetailsInput =
+  | 'accountHolderName'
+  | 'routingNumber'
+  | 'accountNumber'
+  | 'accountType'
+  | 'entityType';
 
 type TInput =
   | TCardholderNameInput
   | TBillingAddressInput
-  | TPaymentDetailsInput;
+  | TPaymentDetailsInput
+  | TBankDetailsInput;
 
 export interface GuestyTokenizationV1RenderOptions {
   containerId: string;
@@ -76,30 +113,168 @@ export interface GuestyTokenizationV2RenderOptions {
   showPciCompliantLink?: boolean;
 }
 
+interface GuestyTokenizationV3BaseRenderOptions {
+  containerId: string;
+  providerId: string;
+  onStatusChange?: (status: boolean) => void;
+  styles?: GuestyTokenizationV3Styles;
+  lang?: string;
+  initialValues?: never;
+  inputsConfig?: {
+    [key in TInput]?: {
+      label?: string;
+      placeholder?: string;
+    };
+  };
+  showReuseCheckbox?: boolean;
+  showAddressToggle?: boolean;
+  showNameToggle?: boolean;
+  addressToggleLabel?: string;
+  nameToggleLabel?: string;
+  showSupportedCards?: boolean;
+  showPciCompliantLink?: boolean;
+  paymentMethod?: never;
+}
+
+interface GuestyTokenizationV3CountryOption {
+  value: string;
+  label: string;
+}
+
+interface GuestyTokenizationV3SharedInitialValues {
+  street?: string;
+  city?: string;
+  state?: string;
+  zipCode?: string;
+  country?: GuestyTokenizationV3CountryOption;
+}
+
+export interface GuestyTokenizationV3CardInitialValues
+  extends GuestyTokenizationV3SharedInitialValues {
+  nameOnCard?: string;
+  cardHolderId?: string;
+  cardNumber?: string;
+  expirationDate?: string;
+  csc?: string;
+  accountHolderName?: never;
+  routingNumber?: never;
+  accountNumber?: never;
+  accountType?: never;
+  entityType?: never;
+}
+
+export interface GuestyTokenizationV3AchInitialValues
+  extends GuestyTokenizationV3SharedInitialValues {
+  accountHolderName?: string;
+  routingNumber?: string;
+  accountNumber?: string;
+  accountType?: '1' | '2';
+  entityType?: '0' | '1';
+  nameOnCard?: never;
+  cardHolderId?: never;
+  cardNumber?: never;
+  expirationDate?: never;
+  csc?: never;
+}
+
+export interface GuestyTokenizationV3CardRenderOptions
+  extends GuestyTokenizationV3BaseRenderOptions {
+  paymentMethod?: 'card';
+  initialValues?: GuestyTokenizationV3CardInitialValues;
+}
+
+export interface GuestyTokenizationV3AchRenderOptions
+  extends GuestyTokenizationV3BaseRenderOptions {
+  paymentMethod: 'ach';
+  initialValues?: GuestyTokenizationV3AchInitialValues;
+}
+
+export type GuestyTokenizationV3RenderOptions =
+  | GuestyTokenizationV3CardRenderOptions
+  | GuestyTokenizationV3AchRenderOptions;
+
 export interface GuestyTokenizationV2ApiV2SubmitPayload {
   amount: number;
   currency: string;
   apiVersion: 'v2';
 }
 
-export interface GuestyTokenizationV2ApiV3SubmitPayload {
+type ReservationOrQuote =
+  | {
+      reservationId: string;
+      quoteId?: never;
+      guest?: never;
+    }
+  | {
+      quoteId: string;
+      guest: {
+        firstName: string;
+        lastName: string;
+        email?: string;
+        phone?: string;
+      };
+      reservationId?: never;
+    };
+
+export type GuestyTokenizationV2ApiV3SubmitPayload = {
   listingId: string;
-  quoteId: string;
   amount: number;
   currency: string;
-  guest: {
-    firstName: string;
-    lastName: string;
-    email?: string;
-    phone?: string;
-  };
   apiVersion?: 'v3';
-}
+} & ReservationOrQuote;
 
 export type GuestyTokenizationV2SubmitPayload =
   | GuestyTokenizationV2ApiV2SubmitPayload
   | GuestyTokenizationV2ApiV3SubmitPayload;
 
+export interface GuestyTokenizationV3SubmitGuest {
+  firstName: string;
+  lastName: string;
+  email?: string;
+  phone?: string;
+}
+
+interface GuestyTokenizationV3SubmitPayloadBase {
+  amount: number;
+  currency: string;
+  method?: 'verify' | 'verify_no_3ds';
+}
+
+export interface GuestyTokenizationV3LegacySubmitPayload
+  extends GuestyTokenizationV3SubmitPayloadBase {
+  apiVersion: 'v2';
+  listingId?: never;
+  reservationId?: never;
+  quoteId?: never;
+  guest?: never;
+}
+
+export interface GuestyTokenizationV3InstantChargeSubmitPayload
+  extends GuestyTokenizationV3SubmitPayloadBase {
+  listingId: string;
+  reservationId: string;
+  quoteId?: never;
+  guest?: never;
+  apiVersion?: 'v3';
+}
+
+export interface GuestyTokenizationV3QuoteSubmitPayload
+  extends GuestyTokenizationV3SubmitPayloadBase {
+  listingId: string;
+  quoteId: string;
+  guest: GuestyTokenizationV3SubmitGuest;
+  reservationId?: never;
+  apiVersion?: 'v3';
+}
+
+export type GuestyTokenizationV3CardSubmitPayload =
+  | GuestyTokenizationV3LegacySubmitPayload
+  | GuestyTokenizationV3InstantChargeSubmitPayload
+  | GuestyTokenizationV3QuoteSubmitPayload;
+
+export type GuestyTokenizationV3SubmitPayload =
+  GuestyTokenizationV3CardSubmitPayload;
+
 export interface PaymentMethod {
   _id: string;
 }
@@ -120,27 +295,54 @@ export interface GuestyTokenizationV2Namespace {
   validate: () => void;
 }
 
+export interface GuestyTokenizationHandle3DSChallengeOptions {
+  /** Opaque challenge payload returned by the Guesty backend. */
+  threeDSChallenge: Record<string, unknown>;
+}
+
+export interface GuestyTokenizationV3Namespace {
+  render: (options: GuestyTokenizationV3RenderOptions) => Promise<void>;
+  destroy: () => Promise<void>;
+  submit: () => Promise<PaymentMethod>;
+  submit: (
+    payload: GuestyTokenizationV3SubmitPayload
+  ) => Promise<PaymentMethod>;
+  validate: () => void;
+  handle3DSChallenge: (
+    options: GuestyTokenizationHandle3DSChallengeOptions
+  ) => Promise<Record<string, unknown>>;
+}
+
+export interface LoadScriptOptions {
+  sandbox?: boolean;
+  version?: 'v1' | 'v2' | 'v3';
+}
+
 type NamespaceBasedOnVersion<T extends LoadScriptOptions['version']> =
   T extends 'v1'
     ? GuestyTokenizationV1Namespace
     : T extends 'v2'
     ? GuestyTokenizationV2Namespace
-    : GuestyTokenizationV1Namespace;
-
-export interface LoadScriptOptions {
-  sandbox?: boolean;
-  version?: 'v1' | 'v2';
-}
+    : T extends 'v3'
+    ? GuestyTokenizationV3Namespace
+    : never;
 
 export function loadScript(
   options?: LoadScriptOptions
-): Promise<NamespaceBasedOnVersion<LoadScriptOptions['version']> | null>;
+): Promise<GuestyTokenizationV1Namespace | null>;
+export function loadScript<T extends 'v1' | 'v2' | 'v3'>(
+  options: LoadScriptOptions & { version: T }
+): Promise<NamespaceBasedOnVersion<T> | null>;
+export function loadScript<T extends LoadScriptOptions['version']>(
+  options?: LoadScriptOptions & { version?: T }
+): Promise<NamespaceBasedOnVersion<T> | GuestyTokenizationV1Namespace | null>;
 
 declare global {
   interface Window {
     guestyTokenization?:
       | GuestyTokenizationV1Namespace
       | GuestyTokenizationV2Namespace
+      | GuestyTokenizationV3Namespace
       | null;
   }
 }