@paydock/client-sdk 1.106.1 → 1.107.0-beta

package/README.md

@@ -16,76 +16,78 @@ Also you will need added gateway ([see API Reference by gateway](https://docs.pa
 
 ## Get started
 
-### With package manager
-
-To install with package manager, enter the following command:
-
-`npm install @paydock/client-sdk`
-
-
-You can use ES2015 or TypeScript modules
-
-`@paydock/client-sdk/widget`
-
+The Client SDK ships in JavaScript ES6 (EcmaScript 2015) in three different
+formats (CJS, ESM and UMD) along with respective TypeScript declarations. Below,
+we exemplify how to import each format.
 
-Also can use UMD module (global visibility, see above)
-
-`@paydock/client-sdk/bundles/widget.umd.js`
-
-`@paydock/client-sdk/bundles/widget.umd.min.js`
+### With package manager
 
+Our NPM package is compatible with all package managers (e.g., `npm`, `yarn`,
+`pnpm`, `bun`). Using `npm` the following command would add the Client SDK as a
+production dependency.
 
+```bash
+npm install @paydock/client-sdk
+```
 
-```javascript--es2015
-// ES2015 / TypeScript
+After installation is complete, if you are developing in NodeJS environments or
+using tools that expect your JavaScript code to be in CJS format (e.g., Jest,
+Karma, RequireJS, Webpack), you can import the Client SDK using CommonJS modules.
+For these environments the UMD format (`@paydock/client-sdk/bundles/widget.umd.js`)
+can also be used as a fallback. Alternatively, in case you are developing in
+projects that have access to modern bundlers such as Vite or others (e.g., SPA
+libs or SSR Metaframeworks), you can import the Client SDK features using ESM
+through named imports or namespaced imports.
 
-import { HtmlWidget } from '@paydock/client-sdk/widget';
 
-let widget = new HtmlWidget('#selector', 'publicKey', 'gatewayId');
+```cjs
+// module import - CommonJS/Node projects ✅
+const paydock = require('@paydock/client-sdk')
+const api = new paydock.Api('publicKey');
 ```
 
+```mjs
+// named import - ESM projects or TypeScript projects ✅
+import { HtmlWidget } from '@paydock/client-sdk'
+const widget = new HtmlWidget('#selector', 'publicKey', 'gatewayId');
+```
 
-```html
-<script src="@paydock/client-sdk/bundles/widget.umd.min.js"></script>
-<script>
-    var widget = new paydock.HtmlWidget('#tag', 'publicKey', 'gatewayId');
-</script>
+```mjs
+// namespaced import - ESM projects or TypeScript projects ✅
+import * as Paydock from '@paydock/client-sdk'
+const widget = new Paydock.HtmlWidget('#selector', 'publicKey', 'gatewayId');
 ```
 
+```js
+// default import - We do not provide default exports. They are handled differently by different tools!
+ ❌
+import paydock from '@paydock/client-sdk'
+>>> "Uncaught SyntaxError: The requested module does not provide an export named 'default'"
+```
 
 
 ### Download from CDN
 
-You should begin by including the library in your page.
-
-Add this script tag to your page to get started with with the url below:
-
-*Compressed version for production*
-`https://widget.paydock.com/sdk/latest/widget.umd.min.js` 
-
-*Full version for development and debug*
-`https://widget.paydock.com/sdk/latest/widget.umd.js`
+For browser environments, you can import the Client SDK directly from our CDN to
+your project's HTML. To accomplish this, include the Client SDK in your page
+using one and only of the two script tags below. After this step you will be
+able to access the Client SDK features via the global variable `paydock`.
 
+For production we recommend using the compressed version (`.min.js`) since
+it will result in faster loading times for your end users.
 
+- *Compressed version for production: `https://widget.paydock.com/sdk/latest/widget.umd.min.js`*
 
+- *Full version for development and debug: `https://widget.paydock.com/sdk/latest/widget.umd.js`*
 
-Also can download library the [production version][min] or the [development version][max]
+You may download the production version of the Client SDK scripts [here][min],
+and, the development version [here][max].
 
 [min]: https://widget.paydock.com/sdk/latest/widget.umd.min.js
 [max]: https://widget.paydock.com/sdk/latest/widget.umd.js
 
-
-The library will always be available via the global variable `paydock`.
-
-
-
-Also for more advanced use, the library has [UMD](https://github.com/umdjs/umd) format, thus can be used in requireJs, webpack, etc.
-
-
-
-
-
-
+For more advanced use-cases, the library has [UMD](https://github.com/umdjs/umd)
+format that can be used in RequireJS, Webpack, etc.
 
 
 ```html
@@ -95,6 +97,7 @@ Also for more advanced use, the library has [UMD](https://github.com/umdjs/umd)
 </script>
 ```
 
+
 ## Widget
 You can find description of all methods and parameters [here](https://www.npmjs.com/package/@paydock/client-sdk#widget-simple-example)
 
@@ -119,11 +122,11 @@ var widget = new paydock.HtmlWidget('#widget', 'publicKey');
 widget.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { HtmlWidget } from '@paydock/client-sdk/widget';
-    
+import { HtmlWidget } from '@paydock/client-sdk';
+
 var widget = new HtmlWidget('#widget', 'publicKey');
 widget.load();
 ```
@@ -131,7 +134,7 @@ widget.load();
 Then write only need 2 lines of code in js to initialize widget
 
 
-### Full example 
+### Full example
 
 ```html
 <!DOCTYPE html>
@@ -194,9 +197,9 @@ widget.setFormFields(['phone', 'email']); // add additional fields for form of w
 widget.setSupportedCardIcons(['mastercard', 'visa']); // add icons of supported card types
 ```
 
-This example shows how you can use a lot of other methods to settings your form 
+This example shows how you can use a lot of other methods to settings your form
 
-### Full example 
+### Full example
 
 ```html
 <!DOCTYPE html>
@@ -217,12 +220,12 @@ This example shows how you can use a lot of other methods to settings your form
 <script src="https://widget.paydock.com/sdk/latest/widget.umd.js" ></script>
 <script>
 	var widget = new paydock.HtmlWidget('#widget', 'publicKey', 'gatewayId');
-	
+
 	widget.setSupportedCardIcons(['mastercard', 'visa']);
 	widget.setFormFields(['phone', 'email']);
 	widget.setRefId('custom-ref-id');
     widget.onFinishInsert('input[name="payment_source_token"]', 'payment_source');z
-	
+
 	widget.load();
 </script>
 </script>
@@ -648,7 +651,7 @@ Class Widget include method for working on html and include extended by HtmlMult
     * [.setFormValues(fieldValues)](#user-content-w_MultiWidget+setFormValues)
     * [.setFormLabels(fieldLabels)](#user-content-w_MultiWidget+setFormLabels)
     * [.setFormPlaceholders(fieldPlaceholders)](#user-content-w_MultiWidget+setFormPlaceholders)
-    * [.setIcons()](#user-content-w_MultiWidget+setIcons)
+    * ~~[.setIcons()](#user-content-w_MultiWidget+setIcons)~~
     * [.setHiddenElements(elements)](#user-content-w_MultiWidget+setHiddenElements)
     * [.setRefId(refId)](#user-content-w_MultiWidget+setRefId)
     * [.useGatewayFieldValidation()](#user-content-w_MultiWidget+useGatewayFieldValidation)
@@ -1213,15 +1216,13 @@ widget.setFormPlaceholders({
 ```
 <a name="w_MultiWidget+setIcons" id="w_MultiWidget+setIcons" href="#user-content-w_MultiWidget+setIcons">&nbsp;</a>
 
-### htmlWidget.setIcons()
+### ~~htmlWidget.setIcons()~~
+***Deprecated***
+
 The method to change the widget icons
 
 **Kind**: instance method of [<code>HtmlWidget</code>](#user-content-w_HtmlWidget)  
 **Overrides**: [<code>setIcons</code>](#user-content-w_MultiWidget+setIcons)  
-**Todo**
-
-- [ ] DEPRECATED
-
 <a name="w_MultiWidget+setHiddenElements" id="w_MultiWidget+setHiddenElements" href="#user-content-w_MultiWidget+setHiddenElements">&nbsp;</a>
 
 ### htmlWidget.setHiddenElements(elements)
@@ -1375,7 +1376,7 @@ Class HtmlMultiWidget include method for working with html
     * [.setFormLabels(fieldLabels)](#user-content-w_MultiWidget+setFormLabels)
     * [.setFormPlaceholders(fieldPlaceholders)](#user-content-w_MultiWidget+setFormPlaceholders)
     * [.setFormElements(elements)](#user-content-w_MultiWidget+setFormElements)
-    * [.setIcons()](#user-content-w_MultiWidget+setIcons)
+    * ~~[.setIcons()](#user-content-w_MultiWidget+setIcons)~~
     * [.setHiddenElements(elements)](#user-content-w_MultiWidget+setHiddenElements)
     * [.setRefId(refId)](#user-content-w_MultiWidget+setRefId)
     * [.useGatewayFieldValidation()](#user-content-w_MultiWidget+useGatewayFieldValidation)
@@ -1841,15 +1842,13 @@ widget.setFormElements([
 ```
 <a name="w_MultiWidget+setIcons" id="w_MultiWidget+setIcons" href="#user-content-w_MultiWidget+setIcons">&nbsp;</a>
 
-### htmlMultiWidget.setIcons()
+### ~~htmlMultiWidget.setIcons()~~
+***Deprecated***
+
 The method to change the widget icons
 
 **Kind**: instance method of [<code>HtmlMultiWidget</code>](#user-content-w_HtmlMultiWidget)  
 **Overrides**: [<code>setIcons</code>](#user-content-w_MultiWidget+setIcons)  
-**Todo**
-
-- [ ] DEPRECATED
-
 <a name="w_MultiWidget+setHiddenElements" id="w_MultiWidget+setHiddenElements" href="#user-content-w_MultiWidget+setHiddenElements">&nbsp;</a>
 
 ### htmlMultiWidget.setHiddenElements(elements)
@@ -2162,7 +2161,7 @@ Class MultiWidget include method for for creating iframe url
     * [.setFormLabels(fieldLabels)](#user-content-w_MultiWidget+setFormLabels)
     * [.setFormPlaceholders(fieldPlaceholders)](#user-content-w_MultiWidget+setFormPlaceholders)
     * [.setFormElements(elements)](#user-content-w_MultiWidget+setFormElements)
-    * [.setIcons()](#user-content-w_MultiWidget+setIcons)
+    * ~~[.setIcons()](#user-content-w_MultiWidget+setIcons)~~
     * [.setHiddenElements(elements)](#user-content-w_MultiWidget+setHiddenElements)
     * [.setRefId(refId)](#user-content-w_MultiWidget+setRefId)
     * [.useGatewayFieldValidation()](#user-content-w_MultiWidget+useGatewayFieldValidation)
@@ -2388,14 +2387,12 @@ widget.setFormElements([
 ```
 <a name="w_MultiWidget+setIcons" id="w_MultiWidget+setIcons" href="#user-content-w_MultiWidget+setIcons">&nbsp;</a>
 
-### multiWidget.setIcons()
+### ~~multiWidget.setIcons()~~
+***Deprecated***
+
 The method to change the widget icons
 
 **Kind**: instance method of [<code>MultiWidget</code>](#user-content-w_MultiWidget)  
-**Todo**
-
-- [ ] DEPRECATED
-
 <a name="w_MultiWidget+setHiddenElements" id="w_MultiWidget+setHiddenElements" href="#user-content-w_MultiWidget+setHiddenElements">&nbsp;</a>
 
 ### multiWidget.setHiddenElements(elements)
@@ -2765,10 +2762,10 @@ var list = new paydock.HtmlPaymentSourceWidget('#list', 'publicKey', 'queryToken
 list.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { HtmlPaymentSourceWidget } from '@paydock/client-sdk/payment-source-widget';
+import { HtmlPaymentSourceWidget } from '@paydock/client-sdk';
 
 var list = new HtmlPaymentSourceWidget('#list', 'publicKey', 'queryToken');
 list.load();
@@ -3481,7 +3478,7 @@ You must create a button to turn it into checkout-button
 var button = new paydock.PaypalCheckoutButton('#button', 'publicKey', 'gatewayId');
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
 
@@ -4624,11 +4621,11 @@ This wrapper helps you to work with paydock api emdpoints
 var browserDetails = await new paydock.Api('publicKey').setEnv('env').getBrowserDetails();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { Api } from '@paydock/client-sdk/api';
-    
+import { Api } from '@paydock/client-sdk';
+
 var browserDetails = await new paydock.Api('publicKey').setEnv('env').getBrowserDetails();
 ```
 
@@ -4641,11 +4638,11 @@ var response = await new paydock.Api('publicKey').setEnv('env').charge().preAuth
     });
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { Api } from '@paydock/client-sdk/api';
-    
+import { Api } from '@paydock/client-sdk';
+
 var response = await new Api('publicKey').setEnv('env').charge().preAuth({
       amount: 100,
       currency: 'AUD',
@@ -4655,7 +4652,7 @@ var response = await new Api('publicKey').setEnv('env').charge().preAuth({
 
 Then write only need 2 lines of code in js to make request
 
-### Initialization full example 
+### Initialization full example
 
 ```html
 <!DOCTYPE html>
@@ -4702,10 +4699,10 @@ var canvas3ds = new paydock.Canvas3ds('#widget', 'token');
 canvas3ds.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { Canvas3ds } from '@paydock/client-sdk/canvas3ds';
+import { Canvas3ds } from '@paydock/client-sdk';
 
 var list = new Canvas3ds('#widget', 'token');
 list.load();
@@ -4926,7 +4923,7 @@ After you initialized the standalone 3ds charge via `v1/charges/standalone-3ds`
 ## Vault Display Widget
 You can find description of all methods and parameters [here](https://www.npmjs.com/package/@paydock/client-sdk#vault-display-widget)
 
-The vault display form allows viewing card number and CVV. The form can be customised according to your needs. 
+The vault display form allows viewing card number and CVV. The form can be customised according to your needs.
 You can set styles as well as subscribe to widget events that help monitor user’s actions in real time.
 
 ## Vault Display Widget simple example
@@ -4946,18 +4943,18 @@ var widget = new paydock.VaultDisplayWidget('#widget', 'token');
 widget.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 
-import { VaultDisplayWidget } from '@paydock/client-sdk/vault-display-widget';
-    
+import { VaultDisplayWidget } from '@paydock/client-sdk';
+
 var widget = new VaultDisplayWidget('#widget', 'token');
 widget.load();
 ```
 
 Then write only need 2 lines of code in js to initialize widget
 
-### Full example 
+### Full example
 
 ```html
 <!DOCTYPE html>
@@ -4968,9 +4965,9 @@ Then write only need 2 lines of code in js to initialize widget
     <style>iframe {border: 0;width: 100%;height: 300px;}</style>
 </head>
 <body>
-        
+
     <div id="widget"></div>
-   
+
     <script src="https://widget.paydock.com/sdk/latest/widget.umd.min.js" ></script>
     <script>
         var widget = new paydock.VaultDisplayWidget('#widget', 'token');
@@ -5008,9 +5005,9 @@ widget.setStyles({
 });
 ```
 
-This example shows how you can use a lot of other methods to settings your form 
+This example shows how you can use a lot of other methods to settings your form
 
-### Full example 
+### Full example
 
 ```html
 <!DOCTYPE html>
@@ -5021,27 +5018,27 @@ This example shows how you can use a lot of other methods to settings your form
     <style>iframe {border: 0;width: 40%;height: 450px;}</style>
 </head>
 <body>
-        
+
     <div id="widget"></div>
-   
+
     <script src="https://widget.paydock.com/sdk/latest/widget.umd.min.js" ></script>
     <script>
         var widget = new paydock.VaultDisplayWidget('#widget', 'token');
 
         widget.setEnv('sandbox');
-        
+
         widget.on('after_load', function (data) {
           console.log(data);
         });
-        
+
         widget.on('cvv_secure_code_requested', function (data) {
           console.log(data);
         });
-        
+
         widget.on('card_number_secure_code_requested', function (data) {
           console.log(data);
         });
-        
+
         widget.setStyles({
             background_color: 'rgb(0, 0, 0)',
             border_color: 'yellow',
@@ -5185,7 +5182,7 @@ let button = new paydock.WalletButtons(
 button.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 import { WalletButtons } from '@paydock/client-sdk';
 
@@ -5210,7 +5207,7 @@ let button = new paydock.WalletButtons(
 button.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 import { WalletButtons } from '@paydock/client-sdk';
 
@@ -5234,7 +5231,7 @@ let button = new paydock.WalletButtons(
 button.load();
 ```
 
-```javascript--es2015
+```javascript
 // ES2015 | TypeScript
 import { WalletButtons } from '@paydock/client-sdk';
 
@@ -6381,21 +6378,31 @@ List of available event's name in the wallet button lifecycle
 | ON_CLICK | <code>string</code> | <code>&quot;onClick&quot;</code> | 
 
 
-# Secure Remote Commerce
+# Click To Pay
+
 ## Overview
-Integrate with Mastercard SRC using Paydock's Mastercard SRC widget.
-For a full description of the methods and parameters, reference the [README file](https://www.npmjs.com/package/@paydock/client-sdk#SRC).
-## SRC simple example
+
+Integrate with Click To Pay using Paydock's Click To Pay widget.
+For a full description of the methods and parameters, reference the [README file](https://www.npmjs.com/package/@paydock/client-sdk#ClickToPay).
+
+## Click To Pay simple example
+
 The following section provides an example use case and integration for the widget.
+
 ### Create a Container
-To integrate the SRC checkout iFrame, create a container in your HTML code. This container serves as the placeholder for the iFrame.
+
+To integrate the Click To Pay checkout iFrame, create a container in your HTML code. This container serves as the placeholder for the iFrame.
+
 ```html
 <div id="checkoutIframe"></div>
 ```
+
 ### Initialize the Widget
+
 Use the following code to initialize your widget:
+
 ```javascript
-var src = new paydock.MastercardSRCClickToPay(
+var src = new paydock.ClickToPay(
     "#checkoutIframe",
     "service_id",
     "paydock_public_key_or_access_token",
@@ -6403,10 +6410,11 @@ var src = new paydock.MastercardSRCClickToPay(
 );
 src.load();
 ```
-```javascript--es2015
+
+```javascript
 // ES2015 | TypeScript
-import { MastercardSRCClickToPay } from '@paydock/client-sdk';
-var src = new MastercardSRCClickToPay(
+import { ClickToPay } from '@paydock/client-sdk';
+var src = new ClickToPay(
     "#checkoutIframe",
     "service_id",
     "paydock_public_key_or_access_token",
@@ -6414,9 +6422,13 @@ var src = new MastercardSRCClickToPay(
 );
 src.load();
 ```
+
 *NOTE:* Paydock recommends that you use a Paydock Access Token instead of a public key for security reasons in production environments. When creating your access token, you must enable the `Secure Remote Commerce` and add a whitelist for the domain of your checkout screen.
+
 ### Full example
+
 A full example of the container and the initialized widget is as follows:
+
 ```html
 <!DOCTYPE html>
 <html lang="en">
@@ -6429,7 +6441,7 @@ A full example of the container and the initialized widget is as follows:
     <div id="checkoutIframe"></div>
     <script src="https://widget.paydock.com/sdk/latest/widget.umd.min.js" ></script>
     <script>
-        var src = new paydock.MastercardSRCClickToPay(
+        var src = new paydock.ClickToPay(
             "#checkoutIframe",
             "service_id",
             "paydock_public_key_or_access_token",
@@ -6440,9 +6452,13 @@ A full example of the container and the initialized widget is as follows:
 </body>
 </html>
 ```
-## Customize your SRC Checkout
+
+## Customize your Click To Pay Checkout
+
 The following is an advanced example that includes customization. You can use these methods to enhance your checkout experience.
+
 ### Settings
+
 ```javascript
 src.setEnv('sandbox'); // set environment
 src.hideCheckout(); // hide checkout iframe
@@ -6460,7 +6476,9 @@ src.on('checkoutError', (error) => {
     console.log(error);
 });
 ```
+
 ### Full example
+
 ```html
 <!DOCTYPE html>
 <html lang="en">
@@ -6473,7 +6491,7 @@ src.on('checkoutError', (error) => {
     <div id="checkoutIframe"></div>
     <script src="https://widget.paydock.com/sdk/latest/widget.umd.min.js" ></script>
     <script>
-        var src = new paydock.MastercardSRCClickToPay(
+        var src = new paydock.ClickToPay(
             "#checkoutIframe",
             "service_id",
             "paydock_public_key_or_access_token",
@@ -6496,11 +6514,14 @@ src.on('checkoutError', (error) => {
 </body>
 </html>
 ```
+
 ## Customize your billing address fields
+
 To customize your billing address experience, Paydock uses a flag that manages whether a customer's billing address is mandatory.
 The options for this customization are NONE (default option), and POSTAL_COUNTRY or FULL.
+
 ```
-var src = new paydock.MastercardSRCClickToPay(
+var src = new paydock.ClickToPay(
     "#checkoutIframe",
     "service_id",
     "paydock_public_key_or_access_token",
@@ -6511,11 +6532,13 @@ var src = new paydock.MastercardSRCClickToPay(
     },
 );
 ```
-The SRC checkout in the example requires the billing address from the customer, which is then returned as a part of the checkout data. The data is then stored and leveraged in the Paydock charge.
-You can also provide the billing address at the time of creating the charge. For example, if you have a different method for collecting the billing address, such as outside of the SRC checkout, you can provide it alongside other information at the charge creation step:
-1. Disable the billing address in Paydock's SRC widget.
-2. Get your One Time Token from the SRC widget alongside other details that may have been collected outside the SRC checkout as the shipping address.
+
+The Click To Pay checkout in the example requires the billing address from the customer, which is then returned as a part of the checkout data. The data is then stored and leveraged in the Paydock charge.
+You can also provide the billing address at the time of creating the charge. For example, if you have a different method for collecting the billing address, such as outside of the Click To Pay checkout, you can provide it alongside other information at the charge creation step:
+1. Disable the billing address in Paydock's Click To Pay widget.
+2. Get your One Time Token from the Click To Pay widget alongside other details that may have been collected outside the Click To Pay checkout as the shipping address.
 3. Send the billing address when creating the charge.
+
 ```
 POST v1/charges
 {
@@ -6544,12 +6567,17 @@ POST v1/charges
     }
 }
 ```
+
 ## How to customize accepted cards
+
 You can send a flag `unaccepted_card_type` to block the usage of a specific card type. The available options are 'DEBIT' and 'CREDIT'.
+
 ### Example code
+
 The following example demonstrates how to block the card:
+
 ```
-var src = new paydock.MastercardSRCClickToPay(
+var src = new paydock.ClickToPay(
     "#checkoutIframe",
     "service_id",
     "paydock_public_key",
@@ -6558,11 +6586,15 @@ var src = new paydock.MastercardSRCClickToPay(
     },
 );
 ```
+
 ## Personalize the Style
+
 Customize the look and feel of your UI. The following example demonstrates changes in the styling of the buttons.
+
 ### Example code
+
 ```
-var src = new paydock.MastercardSRCClickToPay(
+var src = new paydock.ClickToPay(
     "#checkoutIframe",
     "service_id",
     "paydock_public_key",
@@ -6581,8 +6613,8 @@ src.setStyles({
 ## Classes
 
 <dl>
-<dt><a href="#MastercardSRCClickToPay">MastercardSRCClickToPay</a> ⇐ <code>SRC</code></dt>
-<dd><p>Class MastercardSRCClickToPay include methods for interacting with the MastercardSRC checkout and Manual Card option</p>
+<dt><a href="#ClickToPay">ClickToPay</a> ⇐ <code>SRC</code></dt>
+<dd><p>Class ClickToPay include methods for interacting with the ClickToPay checkout and Manual Card option</p>
 </dd>
 </dl>
 
@@ -6600,7 +6632,7 @@ src.setStyles({
 When the flow type is src, masked checkoutData available is also returned</p>
 </dd>
 <dt><a href="#IStyles">IStyles</a> : <code>object</code></dt>
-<dd><p>Interface for style configs inyected to the SRC checkout</p>
+<dd><p>Interface for style configs inyected to the Click to Pay checkout</p>
 </dd>
 </dl>
 
@@ -6629,7 +6661,7 @@ Interface of data used for the Mastercard Checkout. For further information refe
 | [dpa_data.dpa_supported_phone_number.phone_number] | <code>string</code> | The phone number part of the phone number. |
 | [dpa_data.dpa_support_uri] | <code>string</code> | URI for DPA support. |
 | [dpa_data.application_type] | <code>string</code> | Application type, either 'WEB_BROWSER' or 'MOBILE_APP'. |
-| [co_brand_names] | <code>Array.&lt;string&gt;</code> | List of co-brand names associated with the SRC experience. |
+| [co_brand_names] | <code>Array.&lt;string&gt;</code> | List of co-brand names associated with the Click to Pay experience. |
 | [checkout_experience] | <code>string</code> | Checkout experience type, either 'WITHIN_CHECKOUT' or 'PAYMENT_SETTINGS'. |
 | [services] | <code>string</code> | Services offered, such as 'INLINE_CHECKOUT' or 'INLINE_INSTALLMENTS'. |
 | [dpa_transaction_options] | <code>object</code> | Object that stores options for creating a transaction with DPA. |
@@ -6707,7 +6739,7 @@ When the flow type is src, masked checkoutData available is also returned
 <a name="IStyles" id="IStyles" href="#IStyles">&nbsp;</a>
 
 ## IStyles : <code>object</code>
-Interface for style configs inyected to the SRC checkout
+Interface for style configs inyected to the Click to Pay checkout
 
 **Kind**: global interface  
 
@@ -6718,19 +6750,19 @@ Interface for style configs inyected to the SRC checkout
 | [secondary_button_color] | <code>string</code> | Color Code for secondary button. |
 | [secondary_button_text_color] | <code>string</code> | Color Code for secondary button text. |
 | [font_family] | <code>string</code> | Font family to be used. |
-| [enable_src_popup] | <code>boolean</code> | Boolean flag to make the SRC checkout show in a popup window instead of embedded in iframe. |
+| [enable_src_popup] | <code>boolean</code> | Boolean flag to make the Click to Pay checkout show in a popup window instead of embedded in iframe. |
 
-<a name="MastercardSRCClickToPay" id="MastercardSRCClickToPay" href="#MastercardSRCClickToPay">&nbsp;</a>
+<a name="ClickToPay" id="ClickToPay" href="#ClickToPay">&nbsp;</a>
 
-## MastercardSRCClickToPay ⇐ <code>SRC</code>
-Class MastercardSRCClickToPay include methods for interacting with the MastercardSRC checkout and Manual Card option
+## ClickToPay ⇐ <code>SRC</code>
+Class ClickToPay include methods for interacting with the ClickToPay checkout and Manual Card option
 
 **Kind**: global class  
 **Extends**: <code>SRC</code>  
 
-* [MastercardSRCClickToPay](#MastercardSRCClickToPay) ⇐ <code>SRC</code>
-    * [new MastercardSRCClickToPay(iframe_selector, service_id, public_key_or_access_token, meta)](#new_MastercardSRCClickToPay_new)
-    * [.load()](#MastercardSRCClickToPay+load)
+* [ClickToPay](#ClickToPay) ⇐ <code>SRC</code>
+    * [new ClickToPay(iframe_selector, service_id, public_key_or_access_token, meta)](#new_ClickToPay_new)
+    * [.load()](#ClickToPay+load)
     * [.setStyles(fields)](#SRC+setStyles)
     * [.setEnv(env, [alias])](#SRC+setEnv)
     * [.getEnv()](#SRC+getEnv)
@@ -6740,33 +6772,33 @@ Class MastercardSRCClickToPay include methods for interacting with the Mastercar
     * [.reload()](#SRC+reload)
     * [.useAutoResize()](#SRC+useAutoResize)
 
-<a name="new_MastercardSRCClickToPay_new" id="new_MastercardSRCClickToPay_new" href="#new_MastercardSRCClickToPay_new">&nbsp;</a>
+<a name="new_ClickToPay_new" id="new_ClickToPay_new" href="#new_ClickToPay_new">&nbsp;</a>
 
-### new MastercardSRCClickToPay(iframe_selector, service_id, public_key_or_access_token, meta)
+### new ClickToPay(iframe_selector, service_id, public_key_or_access_token, meta)
 
 | Param | Type | Description |
 | --- | --- | --- |
-| iframe_selector | <code>string</code> | Selector of html element. Container for SRC checkout iFrame. |
+| iframe_selector | <code>string</code> | Selector of html element. Container for Click To Pay checkout iFrame. |
 | service_id | <code>string</code> | Card Scheme Service ID |
 | public_key_or_access_token | <code>string</code> | Paydock public key or Access Token |
-| meta | [<code>IMastercardSRCMeta</code>](#IMastercardSRCMeta) | Data that configures the SRC checkout |
+| meta | <code>IClickToPayMeta</code> | Data that configures the Click To Pay checkout |
 
 **Example**  
 ```js
-var mastercardSRC = new MastercardSRCClickToPay('#checkoutIframe', 'service_id', 'public_key', {});
+var mastercardSRC = new ClickToPay('#checkoutIframe', 'service_id', 'public_key', {});
 ```
-<a name="MastercardSRCClickToPay+load" id="MastercardSRCClickToPay+load" href="#MastercardSRCClickToPay+load">&nbsp;</a>
+<a name="ClickToPay+load" id="ClickToPay+load" href="#ClickToPay+load">&nbsp;</a>
 
-### mastercardSRCClickToPay.load()
-The final method after configuring the SRC to start the load process of SRC checkout
+### clickToPay.load()
+The final method after configuring the SRC to start the load process of Click To Pay checkout
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 <a name="SRC+setStyles" id="SRC+setStyles" href="#SRC+setStyles">&nbsp;</a>
 
-### mastercardSRCClickToPay.setStyles(fields)
+### clickToPay.setStyles(fields)
 Object contain styles for widget - call before `.load()`.
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>setStyles</code>](#SRC+setStyles)  
 
 | Param | Type | Description |
@@ -6786,11 +6818,11 @@ widget.setStyles({
 ```
 <a name="SRC+setEnv" id="SRC+setEnv" href="#SRC+setEnv">&nbsp;</a>
 
-### mastercardSRCClickToPay.setEnv(env, [alias])
+### clickToPay.setEnv(env, [alias])
 Current method can change environment. By default environment = sandbox.
 Also we can change domain alias for this environment. By default domain_alias = paydock.com
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>setEnv</code>](#SRC+setEnv)  
 
 | Param | Type | Description |
@@ -6804,10 +6836,10 @@ SRC.setEnv('production');
 ```
 <a name="SRC+getEnv" id="SRC+getEnv" href="#SRC+getEnv">&nbsp;</a>
 
-### mastercardSRCClickToPay.getEnv()
+### clickToPay.getEnv()
 Method to read the current environment
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>getEnv</code>](#SRC+getEnv)  
 **Example**  
 ```js
@@ -6815,10 +6847,10 @@ SRC.getEnv();
 ```
 <a name="SRC+on" id="SRC+on" href="#SRC+on">&nbsp;</a>
 
-### mastercardSRCClickToPay.on(eventName, [cb]) ⇒ <code>Promise.&lt;any&gt;</code> \| <code>void</code>
+### clickToPay.on(eventName, [cb]) ⇒ <code>Promise.&lt;any&gt;</code> \| <code>void</code>
 Listen to events of SRC
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>on</code>](#SRC+on)  
 
 | Param | Type | Description |
@@ -6838,10 +6870,10 @@ SRC.on('checkoutCompleted').then(function (token) {
 ```
 <a name="SRC+hideCheckout" id="SRC+hideCheckout" href="#SRC+hideCheckout">&nbsp;</a>
 
-### mastercardSRCClickToPay.hideCheckout([saveSize])
+### clickToPay.hideCheckout([saveSize])
 Using this method you can hide checkout after load and button click
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>hideCheckout</code>](#SRC+hideCheckout)  
 
 | Param | Type | Default | Description |
@@ -6854,10 +6886,10 @@ SRC.hideCheckout();
 ```
 <a name="SRC+showCheckout" id="SRC+showCheckout" href="#SRC+showCheckout">&nbsp;</a>
 
-### mastercardSRCClickToPay.showCheckout()
+### clickToPay.showCheckout()
 Using this method you can show checkout after using hideCheckout method
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>showCheckout</code>](#SRC+showCheckout)  
 **Example**  
 ```js
@@ -6865,10 +6897,10 @@ SRC.showCheckout()
 ```
 <a name="SRC+reload" id="SRC+reload" href="#SRC+reload">&nbsp;</a>
 
-### mastercardSRCClickToPay.reload()
+### clickToPay.reload()
 Using this method you can reload the whole checkout
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>reload</code>](#SRC+reload)  
 **Example**  
 ```js
@@ -6876,10 +6908,10 @@ SRC.reload()
 ```
 <a name="SRC+useAutoResize" id="SRC+useAutoResize" href="#SRC+useAutoResize">&nbsp;</a>
 
-### mastercardSRCClickToPay.useAutoResize()
+### clickToPay.useAutoResize()
 Use this method for resize checkout iFrame according to content height, if applicable
 
-**Kind**: instance method of [<code>MastercardSRCClickToPay</code>](#MastercardSRCClickToPay)  
+**Kind**: instance method of [<code>ClickToPay</code>](#ClickToPay)  
 **Overrides**: [<code>useAutoResize</code>](#SRC+useAutoResize)  
 **Example**  
 ```js
@@ -6888,7 +6920,7 @@ SRC.useAutoResize();
 <a name="EVENT" id="EVENT" href="#EVENT">&nbsp;</a>
 
 ## EVENT : <code>enum</code>
-List of available event's name in the SRC checkout lifecycle
+List of available event's name in the Click To Pay checkout lifecycle
 
 **Kind**: global enum  
 
@@ -6896,8 +6928,8 @@ List of available event's name in the SRC checkout lifecycle
 | --- | --- | --- | --- |
 | IFRAME_LOADED | <code>string</code> | <code>&quot;iframeLoaded&quot;</code> | Initial event sent when IFrame is initially loaded. |
 | CHECKOUT_READY | <code>string</code> | <code>&quot;checkoutReady&quot;</code> | Event sent when checkout is loaded and ready to be used by customer. Leverage alongside [showCheckout](#SRC+showCheckout) and [hideCheckout](#SRC+hideCheckout). |
-| CHECKOUT_POPUP_OPEN | <code>string</code> | <code>&quot;checkoutPopupOpen&quot;</code> | Event sent when SRC Checkout flow is started, regardless of embedded or windowed mode. |
-| CHECKOUT_POPUP_CLOSE | <code>string</code> | <code>&quot;checkoutPopupClose&quot;</code> | Event sent when SRC Checkout flow is closed, regardless of embedded or windowed mode. |
+| CHECKOUT_POPUP_OPEN | <code>string</code> | <code>&quot;checkoutPopupOpen&quot;</code> | Event sent when Click To Pay checkout flow is started, regardless of embedded or windowed mode. |
+| CHECKOUT_POPUP_CLOSE | <code>string</code> | <code>&quot;checkoutPopupClose&quot;</code> | Event sent when Click To Pay checkout flow is closed, regardless of embedded or windowed mode. |
 | CHECKOUT_COMPLETED | <code>string</code> | <code>&quot;checkoutCompleted&quot;</code> | Event sent on successful checkout by customer. Check [data](#EventDataCheckoutCompletedData) for more information. |
 | CHECKOUT_ERROR | <code>string</code> | <code>&quot;checkoutError&quot;</code> | Event sent on error checkout by customer. Check [data](#EventData) for more information. |