@paydock/client-sdk 1.111.1 → 1.113.2-beta

package/docs/click-to-pay-examples.md

@@ -229,3 +229,39 @@ src.setStyles({
     font_family: 'Arial',
 });
 ```
+
+## Recognition token
+
+In order to store user information for further payments, click to pay provides a recognition token that is used to load user information.
+If you already have a recognitionToken stored, you can use it in meta to load the user information.
+
+### Storage suggestions
+Merchant can store the tokens by dropping the token as a 1st party cookie in the browser, and must ensure to manage all the security aspects around dropping/storing the cookie by following the security standards:
+
+- `Expiration Date=` cookie should be set to expire at a max 180 days
+- `Secure` flag
+- `httpOnly` flag
+- `sameSite=` strict
+- `Value=` recognition token JWT
+
+### Example code
+
+```javascript
+var src = new paydock.ClickToPay(
+    "#checkoutIframe",
+    "service_id",
+    "paydock_public_key",
+    {
+        "recognition_token": "eyJraWQiOiIy...",
+    },
+);
+src.on('recognitionTokenRequested', (data) => {
+    console.log('Recognition token was found: ' + data.data.recognitionToken);
+    // Add recognition token to your store
+});
+
+src.on('recognitionTokenDropped', () => {
+    console.log('Recognition token was droped');
+    // Delete recognition token from your store
+});
+```

package/docs/click-to-pay.md

@@ -78,6 +78,7 @@ Interface of data used for the Mastercard Checkout. For further information refe
 | [customer.phone.country_code] | <code>string</code> | Customer phone country code (example "1" for US). |
 | [customer.phone.phone] | <code>string</code> | Customer phone number. |
 | [unaccepted_card_type] | <code>string</code> | Used to block a specific card type. Options are 'CREDIT', 'DEBIT'. |
+| [recognition_token] | <code>string</code> | Used for Click to Pay to load user information and preferences. |
 
 <a name="EventData" id="EventData" href="#EventData">&nbsp;</a>
 
@@ -320,6 +321,8 @@ List of available event's name in the Click To Pay checkout lifecycle
 | 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. |
+| RECOGNITION_TOKEN_REQUESTED | <code>string</code> | <code>&quot;recognitionTokenRequested&quot;</code> | Event sent when a recognition token was found on the mastercard SDK response. |
+| RECOGNITION_TOKEN_DROPPED | <code>string</code> | <code>&quot;recognitionTokenDropped&quot;</code> | Event sent when a recognition token needs to be dropped for user be no longer remembered. |
 
 <a name="EVENT_DATA_TYPE" id="EVENT_DATA_TYPE" href="#EVENT_DATA_TYPE">&nbsp;</a>
 

package/package.json

@@ -104,7 +104,7 @@
     }
   },
   "name": "@paydock/client-sdk",
-  "version": "1.111.1",
+  "version": "1.113.2-beta",
   "scripts": {
     "build:doc": "node docs/html/marked.js",
     "build:js": "rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
@@ -137,75 +137,75 @@
   },
   "dependencies": {
     "@auspayplus/open-payments-checkout": "1.8.0",
-    "@newrelic/browser-agent": "^1.260.1",
-    "@stripe/stripe-js": "^1.11.0"
+    "@newrelic/browser-agent": "1.260.1",
+    "@stripe/stripe-js": "1.54.2"
   },
   "devDependencies": {
-    "@babel/cli": "^7.23.9",
-    "@babel/core": "^7.24.0",
-    "@babel/plugin-external-helpers": "^7.23.3",
-    "@babel/plugin-transform-modules-umd": "^7.23.3",
-    "@babel/plugin-transform-object-assign": "^7.23.3",
-    "@babel/plugin-transform-runtime": "^7.24.0",
-    "@babel/polyfill": "^7.12.1",
-    "@babel/preset-env": "^7.24.0",
-    "@babel/runtime": "^7.24.0",
-    "@babel/runtime-corejs2": "^7.24.0",
-    "@biomejs/biome": "^1.7.3",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-commonjs": "^25.0.7",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-replace": "^5.0.5",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^11.1.6",
-    "@rollup/pluginutils": "^5.1.0",
-    "@types/applepayjs": "^14.0.8",
-    "@types/es6-promise": "^3.3.0",
-    "@types/googlepay": "^0.6.3",
-    "@types/jasmine": "^5.1.4",
-    "@types/jasmine-ajax": "^3.3.5",
-    "@types/jquery": "^3.5.29",
-    "babelify": "^10.0.0",
-    "base64-js": "^1.2.0",
-    "browser-resolve": "^1.11.2",
-    "browserify": "^17.0.0",
-    "browserify-istanbul": "^2.0.0",
-    "buffer": "^5.0.5",
-    "dotenv": "^16.4.5",
+    "@babel/cli": "7.24.5",
+    "@babel/core": "7.24.5",
+    "@babel/plugin-external-helpers": "7.24.1",
+    "@babel/plugin-transform-modules-umd": "7.24.1",
+    "@babel/plugin-transform-object-assign": "7.24.1",
+    "@babel/plugin-transform-runtime": "7.24.3",
+    "@babel/polyfill": "7.12.1",
+    "@babel/preset-env": "7.24.5",
+    "@babel/runtime": "7.24.5",
+    "@babel/runtime-corejs2": "7.24.5",
+    "@biomejs/biome": "1.7.3",
+    "@rollup/plugin-babel": "6.0.4",
+    "@rollup/plugin-commonjs": "25.0.7",
+    "@rollup/plugin-json": "6.1.0",
+    "@rollup/plugin-node-resolve": "15.2.3",
+    "@rollup/plugin-replace": "5.0.5",
+    "@rollup/plugin-terser": "0.4.4",
+    "@rollup/plugin-typescript": "11.1.6",
+    "@rollup/pluginutils": "5.1.0",
+    "@types/applepayjs": "14.0.8",
+    "@types/es6-promise": "3.3.0",
+    "@types/googlepay": "0.6.4",
+    "@types/jasmine": "5.1.4",
+    "@types/jasmine-ajax": "3.3.5",
+    "@types/jquery": "3.5.30",
+    "babelify": "10.0.0",
+    "base64-js": "1.5.1",
+    "browser-resolve": "1.11.3",
+    "browserify": "17.0.0",
+    "browserify-istanbul": "2.0.0",
+    "buffer": "5.7.1",
+    "dotenv": "16.4.5",
     "fs": "0.0.2",
-    "grunt": "^1.6.1",
-    "grunt-cli": "^1.2.0",
-    "grunt-jsdoc-to-markdown": "^6.0.0",
-    "grunt-replace": "^2.0.2",
+    "grunt": "1.6.1",
+    "grunt-cli": "1.4.3",
+    "grunt-jsdoc-to-markdown": "6.0.0",
+    "grunt-replace": "2.0.2",
     "grunt-template-render": "0.0.1",
-    "highlight.js": "^11.5.1",
-    "ieee754": "^1.1.8",
-    "include-all": "^4.0.3",
-    "jasmine-ajax": "^3.3.1",
-    "jasmine-core": "^2.5.2",
-    "jquery": "^3.2.1",
-    "jsdoc-to-markdown": "^8.0.0",
-    "karma": "^6.4.2",
-    "karma-browserify": "^8.1.0",
-    "karma-chrome-launcher": "^2.2.0",
-    "karma-cli": "^2.0.0",
-    "karma-firefox-launcher": "^1.0.1",
-    "karma-jasmine": "^1.1.0",
-    "karma-jasmine-ajax": "^0.1.13",
-    "karma-mocha-reporter": "^2.2.2",
-    "marked": "^4.0.14",
-    "npm-run-all2": "^6.2.0",
-    "process": "^0.11.9",
-    "rimraf": "^5.0.5",
-    "rollup": "^4.17.2",
-    "rollup-plugin-dts": "^6.1.0",
-    "rxjs": "^7.8.1",
-    "tsify": "^3.0.1",
-    "tslib": "^2.6.2",
-    "tslint": "^5.8.0",
-    "typescript": "^5.4.5",
-    "zod": "^3.22.4"
+    "highlight.js": "11.9.0",
+    "ieee754": "1.2.1",
+    "include-all": "4.0.3",
+    "jasmine-ajax": "3.4.0",
+    "jasmine-core": "2.99.1",
+    "jquery": "3.7.1",
+    "jsdoc-to-markdown": "8.0.1",
+    "karma": "6.4.3",
+    "karma-browserify": "8.1.0",
+    "karma-chrome-launcher": "2.2.0",
+    "karma-cli": "2.0.0",
+    "karma-firefox-launcher": "1.3.0",
+    "karma-jasmine": "1.1.2",
+    "karma-jasmine-ajax": "0.1.13",
+    "karma-mocha-reporter": "2.2.5",
+    "marked": "4.3.0",
+    "npm-run-all2": "6.2.0",
+    "process": "0.11.10",
+    "rimraf": "5.0.7",
+    "rollup": "4.17.2",
+    "rollup-plugin-dts": "6.1.0",
+    "rxjs": "7.8.1",
+    "tsify": "3.0.4",
+    "tslib": "2.6.2",
+    "tslint": "5.20.1",
+    "typescript": "5.4.5",
+    "zod": "3.23.8"
   },
   "engines": {
     "node": ">=16.0.0"

package/slate.md

@@ -1922,3 +1922,39 @@ src.setStyles({
     font_family: 'Arial',
 });
 ```
+
+## Recognition token
+
+In order to store user information for further payments, click to pay provides a recognition token that is used to load user information.
+If you already have a recognitionToken stored, you can use it in meta to load the user information.
+
+### Storage suggestions
+Merchant can store the tokens by dropping the token as a 1st party cookie in the browser, and must ensure to manage all the security aspects around dropping/storing the cookie by following the security standards:
+
+- `Expiration Date=` cookie should be set to expire at a max 180 days
+- `Secure` flag
+- `httpOnly` flag
+- `sameSite=` strict
+- `Value=` recognition token JWT
+
+### Example code
+
+```javascript
+var src = new paydock.ClickToPay(
+    "#checkoutIframe",
+    "service_id",
+    "paydock_public_key",
+    {
+        "recognition_token": "eyJraWQiOiIy...",
+    },
+);
+src.on('recognitionTokenRequested', (data) => {
+    console.log('Recognition token was found: ' + data.data.recognitionToken);
+    // Add recognition token to your store
+});
+
+src.on('recognitionTokenDropped', () => {
+    console.log('Recognition token was droped');
+    // Delete recognition token from your store
+});
+```